• 简体中文
  • 独立解绑卡 Token

    市场:ZA 南非

    /api/v1/card/token/unbind

    解绑此前已绑定的 cardToken,使其永久无法用于后续支付。一旦解绑,该卡将无法再在调用 [CreateOrder] 时通过 cardPayerInfo 使用。如需再次使用同一张卡支付,持卡人必须重新完成 [Bind Card] 绑卡流程以获取新的 cardToken。

    ⚠️ 前置条件:本接口仅在目标 cardToken 当前处于 cardStatus = 1(已绑定) 状态时才能调用成功。对非该状态的 token(例如尚未完成绑定、已解绑,或处于其他任何状态)调用本接口,将返回 AC000006。如不确定当前状态,请先通过 [Token Query] 确认后再调用本接口。

    典型场景:持卡人从钱包中移除已保存的卡片、商户在客户要求下下线某个已存储的支付方式、合规驱动的 token 清理。

    请求参数

    参数类型是否必填说明
    cardTokenstring是需解绑的卡 token,来源于 [Bind Card] 接口
    nonceStrstring是随机字符串,参与签名
    requestTimeinteger是请求时间戳,单位为毫秒
    versionstring是固定值 2.0.0.0

    是 = 必填 · 否 = 选填

    响应字段

    字段类型说明
    respCodestring00000000 表示成功,其他值表示失败
    respMsgstring响应描述
    statusbooleantrue / false
    dataobject成功时为空对象 {}

    示例 — 成功

    请求 / 响应

    curl 'https://open-gw.palmpay-inc.com/api/v1/card/token/unbind' \
      -H 'CountryCode: ZA' \
      -H 'Authorization: Bearer xxx' \
      -H 'Content-Type: application/json' \
      -d '{
            "cardToken": "4674f053401447049d2078b1e509f975",
            "nonceStr": "xxx",
            "requestTime": 1699925850000,
            "version": "2.0.0.0"
          }'
    {
      "respMsg": "success",
      "data": {},
      "respCode": "00000000",
      "status": true
    }

    示例 — 失败

    若 cardToken 当前不处于 cardStatus = 1(已绑定)状态——例如已被解绑、从未完成绑定流程,或本身无效——解绑将失败。

    {
      "respCode": "AC000006",
      "respMsg": "Unlink account failed, current account status is not link status",
      "status": false
    }

    幂等性说明

    对一个已经解绑过的 cardToken 再次调用本接口,不会返回成功响应。由于该 token 此时已不处于 cardStatus = 1,请求会失败并返回 AC000006。商户应将重试场景下收到的 AC000006 理解为"该 token 已确认解绑",而不是视为意外错误。

    Card Status 要求

    cardStatus含义是否可调用 unbind
    1已绑定(Linked)可以 — 本接口仅接受此状态
    其他任意值未绑定(如初始化中、已失败、已解绑、已冻结等)不可以 — 返回 AC000006

    错误码

    错误码含义
    AC000006解绑账户失败 — 该 cardToken 当前不处于 cardStatus = 1(已绑定)状态

    平台级通用错误码(签名错误、IP 白名单限制等)另见 [Open Platform 错误码参考文档]。