Antom, leading provider of tailored payment solutions

notifyVaulting

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

结构

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

入参

result Result  REQUIRED

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

vaultingRequestId String  REQUIRED

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

更多信息:

  • 最大长度:64 字符

paymentMethodDetail PaymentMethodDetail  REQUIRED

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

更多信息:

  • 最大长度:64 字符

metadata String  

您在绑定支付方式过程中提供的 metadata 信息。
当您在 vaultPaymentMethod 接口请求中指定了该参数时,系统会返回此参数。

更多信息:

  • 最大长度:2048 字符

出参

result Result  REQUIRED

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

请求

json
{
  "acquirerInfo": {
    "acquirerName": "ADYEN",
    "acquirerTransactionId": "******",
    "referenceRequestId": "********"
  },
  "paymentMethodDetail": {
    "card": {
      "avsResultRaw": "4",
      "billingAddress": {
        "address1": "address1",
        "address2": "address2",
        "city": "Madrid",
        "region": "ES",
        "state": "Madrid",
        "zipCode": "280**"
      },
      "bin": "409280",
      "brand": "VISA",
      "cardToken": "******",
      "cvvResultRaw": "1",
      "expiredMonth": "02",
      "expiredYear": "27",
      "funding": "DEBIT",
      "issuerName": "BANCO ITAUCARD, S.A.",
      "issuingCountry": "BR",
      "lastFour": "0000",
      "maskedCardNo": "************8764",
      "networkTransactionId": "xxxxx"
    },
    "paymentMethodType": "CARD"
  },
  "result": {
    "resultCode": "SUCCESS",
    "resultMsg": "success",
    "resultStatus": "S"
  },
  "vaultingCreateTime": "2023-10-16T01:07:22-07:00",
  "vaultingRequestId": "requestId1697443641665"
}

响应

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

结果处理逻辑

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