Antom, leading provider of tailored payment solutions

notifyVaulting

当绑定成功或失败时,APO 使用此接口向商户发送资产绑定结果。商户根据资产绑定结果继续完成商户端的交易。
​

结构

报文由报文头和报文体组成。本文主要介绍报文体结构信息,有关报文头的结构信息,请参阅:
注意:将每个字段(除数组外)的数据类型设置为字符串。这意味字段值必须使用双引号(" ")括起来。例如:
  • 如果字段的数据类型为整数属性,且其值为 20,设置为 "20"。
  • 如果字段的数据类型为布尔属性,且其值为 true,设置为 "true"。

入参

result Result  REQUIRED

资产绑定结果的详细信息,如资产绑定状态、结果代码和结果消息。 

vaultingRequestId String  REQUIRED

商户为识别绑卡请求分配的专属 ID。 

更多信息:

  • 最大长度:64 字符

vaultingStatus String  

表示支付方式的绑定状态。有效值为:
  • SUCCESS: 表示绑定成功。 
  • FAIL: 表示绑定失败。
  • PROCESSING: 表示绑定处理中。
注意:当 result.resultStatus 的值为 ​S​ 时返回此参数。  

更多信息:

  • 最大长度:10 字符

paymentMethodDetail PaymentMethodDetail  REQUIRED

关于银行卡支付方式的详细信息。

更多信息:

  • 最大长度:64 字符

acquirerInfo AcquirerInfo  

处理该支付的收单机构信息。

出参

result Result  REQUIRED

发送给 APO 以确认已收到通知的固定值。 
API Explorer

请求

json
{
  "acquirerInfo": {
    "acquirerName": "ADYEN"
  },
  "paymentMethodDetail": {
    "card": {
      "brand": "VISA",
      "supportedBrands": [
        "VISA",
        "MASTERCARD"
      ],
      "cardToken": "ALIPAY9CGwsAeMBug+G2dSKDV6AIsNKTxAFNkOMoj8Gxvt8h0eDUbd6nO5CwMFIjEFERWxCAo/b1OjVTvtl1zspyMGcg==",
      "maskedCardNo": "************8764",
      "networkTransactionId": "xxxxx"
    },
    "paymentMethodType": "CARD"
  },
  "vaultingRequestId": "123487889889",
  "vaultingStatus": "SUCCESS",
  "result": {
    "resultCode": "SUCCESS",
    "resultMessage": "success.",
    "resultStatus": "S"
  }
}

响应

json
{
  "result": {
    "resultCode": "SUCCESS",
    "resultMessage": "success",
    "resultStatus": "S"
  }
}

结果处理逻辑

在收到 APO 通知后,发送以下固定值的消息给 APO,以确认收到 APO 的通知:
Sample Codetext
{
 "result": {
    "resultCode":"SUCCESS",
    "resultStatus":"S",
    "resultMessage":"success"
 }
}
如果由于操作问题或网络问题没有将此类消息返回给 APO,APO 会反复发送通知,直到商家返回所需消息。首次通知发送后的 24 小时内会进行重试。通知将重试最多八次,间隔为 0 秒, 2 分钟, 10 分钟, 10 分钟, 1 小时, 2 小时, 6 小时, 和 15 小时。
注意:沙箱环境中,如果您没有按照固定格式返回信息,APO 将不会重新发送异步通知给您。