资产绑定通知

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

结构

报文由报文头和报文体组成。本文主要介绍报文体结构信息,有关报文头的结构信息,请参阅:

注意:将每个字段(除数组外)的数据类型设置为字符串。这意味字段值必须使用双引号(" ")括起来。例如:

  • 如果字段的数据类型为整数属性,且其值为 20,设置为 "20"。
  • 如果字段的数据类型为布尔属性,且其值为 true,设置为 "true"。


入参

result Result  REQUIRED

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

Show child parameters

vaultingRequestId String  REQUIRED

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

更多信息:

  • 最大长度:64 字符

vaultingStatus String  

表示支付方式的绑定状态。有效值为:

  • SUCCESS: 表示绑定成功。 
  • FAIL: 表示绑定失败。
  • PROCESSING: 表示绑定处理中。

注意:当 result.resultStatus 的值为 ​S​ 时返回此参数。  

更多信息:

  • 最大长度:10 字符

paymentMethodDetail PaymentMethodDetail  REQUIRED

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

更多信息:

  • 最大长度:64 字符
Show child parameters

acquirerInfo AcquirerInfo  

收单机构信息。

Show child parameters

出参

result Result  REQUIRED

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

Show child parameters
API Explorer

请求

请求体

响应

响应体

结果处理逻辑

在收到 APO 通知后,发送以下固定值的消息给 APO,以确认收到 APO 的通知:

Sample Code

如果由于操作问题或网络问题没有将此类消息返回给 APO,APO 会反复发送通知,直到商家返回所需消息。首次通知发送后的 24 小时内会进行重试。通知将重试最多八次,间隔为 0 秒, 2 分钟, 10 分钟, 10 分钟, 1 小时, 2 小时, 6 小时, 和 15 小时。

注意:沙箱环境中,如果您没有按照固定格式返回信息,APO 将不会重新发送异步通知给您。