Z Zise Developers

个人汇款开户协议正文(六语言 · 提交前必须让用户读到)

GET /v1/remit/vp/agreement scope: remittances:read
商户自身

提交 POST /v1/remit/vp/applications 那一刻,我方会把协议快照写进申请行并把 agreed_at 填成当前时刻 —— 也就是我方记下了「该会员于此刻同意了协议」。所以提交之前,你必须把这份正文呈现给终端用户,并让他明确同意。

在这一条之前,这份正文商户手上一个字都没有(协议由我方维护)——那是一个合规缺口,不是体验问题。

── 为什么不是托管屏 ──阅读协议是一次纯资料流程,做成跳出会把开户体验断成两截;而协议本来就该在你的品牌内呈现。我方要的只是「正文由我方提供、版本由我方控制」。

── 语言回落:lang 可能与你请求的不同 ──没填的语言按 enzh-Hans 回落,绝不做机器翻译 ——一份没人校对过的译文比显示英文更坏,用户据它做的决定我方要认。

⚠ 请如实标注「本条以英文提供」,别假装它就是中文。

intro(开户说明,非协议)可能为 null —— 运营没配就没有,不影响能不能开户。

查询参数

字段类型必填说明
lang string 可选 想要哪种语言(zh-Hans / zh-Hant / en / fr / ja / ko)。 不传则按 Accept-Language 取。

响应

200OK
{
  "agreement": {
    "lang": "zh-Hans",
    "title": "个人汇款账户服务协议",
    "body": "第一条 …"
  },
  "intro": {
    "lang": "zh-Hans",
    "title": "关于个人汇款账户",
    "body": "开通后,你的汇款将以你本人的名义汇出…"
  }
}
503service_unavailable —— 协议正文尚未配置。 这时不要放行开户:拿一份空白协议让用户点同意, 与没有协议是一回事。POST /v1/remit/vp/applications 在同一情形下也会拒。
请求
curl -X GET 'https://api.zise.com/v1/remit/vp/agreement' \
  -H 'x-auth-token: Bearer $TOKEN'
const res = await fetch("https://api.zise.com/v1/remit/vp/agreement", {
  method: "GET",
  headers: {
    "x-auth-token": "Bearer $TOKEN",
  },
});
// 金额按字符串读,别让它变成 number
const data = await res.json();
import requests

res = requests.get(
    "https://api.zise.com/v1/remit/vp/agreement",
    headers={
        "x-auth-token": "Bearer $TOKEN",
    },
)
# 金额用 Decimal(str(...)),不要 float
data = res.json()
req, _ := http.NewRequest("GET", "https://api.zise.com/v1/remit/vp/agreement",
    nil)
req.Header.Set("x-auth-token", "Bearer $TOKEN")
res, err := http.DefaultClient.Do(req)
// 金额字段用 string 接,不要 float64
HttpRequest req = HttpRequest.newBuilder()
    .uri(URI.create("https://api.zise.com/v1/remit/vp/agreement"))
    .header("x-auth-token", "Bearer $TOKEN")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();
// 金额字段用 String / BigDecimal,不要 double
$ch = curl_init('https://api.zise.com/v1/remit/vp/agreement');
curl_setopt_array($ch, [
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    'x-auth-token: Bearer $TOKEN',
  ],
]);
$res = curl_exec($ch);
// 金额用 bcmath / 字符串,不要 floatval
200
{
  "agreement": {
    "lang": "zh-Hans",
    "title": "个人汇款账户服务协议",
    "body": "第一条 …"
  },
  "intro": {
    "lang": "zh-Hans",
    "title": "关于个人汇款账户",
    "body": "开通后,你的汇款将以你本人的名义汇出…"
  }
}