Z Zise Developers
/
English
卡发行 › API 参考 › 开卡申请

直接提交修正后的 KYC，独立于旧申请和退款

POST /v1/cards/applications/{id}/recovery scope: cards:write
代会员调用 · 必带 x-on-behalf-of

先调用 PATCH /v1/kyc 修改资料（仅传变更字段，证件号码和国家字段不可修改），再调用本接口，body 为 {}，无需打开托管页面。修改照片时，先调用 POST /v1/kyc/files 上传文件原始字节，再把返回的file_url 放入 PATCH 的 profile.identity_photos 对应项；不要传外部 URL 或 base64。我方本地审核通过后向原申请对应渠道递交；渠道不支持的修改转人工处理。同一资料版本重复提交不会生成重复审核任务。请查询 GET 本路径获取结果。此接口不会扣款、退款、复活申请或重新开卡。审核通过后，需终端用户再次确认费用，使用新的幂等键创建新开卡申请。

路径参数

字段类型必填说明
id string 必填
字段类型必填说明
x-on-behalf-of string 必填
idempotency-key string 必填

请求体

这个 operation 还没有在 spec 里声明请求体字段。

响应

202已受理独立审核任务，使用 GET 查询实际状态
400当前申请或资料状态不允许提交
404申请不存在或不属于当前会员及商户
请求 
curl -X POST 'https://api.zinfra.vip/v1/cards/applications/{id}/recovery' \
  -H 'x-auth-token: Bearer $TOKEN' \
  -H 'x-on-behalf-of: $MEMBER_ID'
const res = await fetch("https://api.zinfra.vip/v1/cards/applications/{id}/recovery", {
  method: "POST",
  headers: {
    "x-auth-token": "Bearer $TOKEN",
    "x-on-behalf-of": "$MEMBER_ID",
  },
});
// 金额按字符串读，别让它变成 number
const data = await res.json();
import requests

res = requests.post(
    "https://api.zinfra.vip/v1/cards/applications/{id}/recovery",
    headers={
        "x-auth-token": "Bearer $TOKEN",
        "x-on-behalf-of": "$MEMBER_ID",
    },
)
# 金额用 Decimal(str(...))，不要 float
data = res.json()
req, _ := http.NewRequest("POST", "https://api.zinfra.vip/v1/cards/applications/{id}/recovery",
    nil)
req.Header.Set("x-auth-token", "Bearer $TOKEN")
req.Header.Set("x-on-behalf-of", "$MEMBER_ID")
res, err := http.DefaultClient.Do(req)
// 金额字段用 string 接，不要 float64
HttpRequest req = HttpRequest.newBuilder()
    .uri(URI.create("https://api.zinfra.vip/v1/cards/applications/{id}/recovery"))
    .header("x-auth-token", "Bearer $TOKEN")
    .header("x-on-behalf-of", "$MEMBER_ID")
    .method("POST", HttpRequest.BodyPublishers.noBody())
    .build();
// 金额字段用 String / BigDecimal，不要 double
$ch = curl_init('https://api.zinfra.vip/v1/cards/applications/{id}/recovery');
curl_setopt_array($ch, [
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    'x-auth-token: Bearer $TOKEN',
    'x-on-behalf-of: $MEMBER_ID',
  ],
]);
$res = curl_exec($ch);
// 金额用 bcmath / 字符串，不要 floatval
202 
// spec 里还没有这个 operation 的响应示例