Antom, leading provider of tailored payment solutionsAntom, leading provider of tailored payment solutions

支付通知（线下商店）

在支付处理完成时，Antom 使用此接口将支付结果发送给商户。商户根据支付结果完成商户端的后续交易。 

结构

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

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

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

入参

notifyType String  REQUIRED

支付状态通知类型。有效值为：

  • PAYMENT_RESULT：表示通知为支付结果。
  • OFFLINE_PAYMENT_CODE：表示通知为线下支付代码。

result Result  

支付结果

Show child parameters

paymentRequestId String  REQUIRED

商家为识别支付请求分配的专属 ID。

更多信息：

  • 最大长度：64 字符

paymentId String  REQUIRED

Antom 为识别支付而分配的支付 ID。paymentId 与 paymentRequestId 之间存在一一对应关系。

更多信息：

  • 最大长度：64 字符

paymentAmount Amount  REQUIRED

商户请求在订单货币中接收的支付金额。

Show child parameters

actualPaymentAmount Amount  

实际支付金额，等于支付金额乘以支付汇率。

注意：当支付货币与支付服务提供商的实际支付货币匹配时，该字段的值等于支付金额。

Show child parameters

paymentQuote Quote  

交易时支付货币与实际支付货币之间的汇率。

注意：当支付货币与支付服务提供商的实际支付货币相同时，该字段为空。

Show child parameters

paymentCreateTime Datetime  

支付创建的日期和时间。

更多信息：

  • 值遵循 ISO 8601 标准格式。例如，“2019-11-27T12:01:01+08:00”。

paymentTime Datetime  

支付达到最终成功或失败状态的日期和时间。

更多信息：

  • 值遵循 ISO 8601 标准格式。例如，“2019-11-27T12:01:01+08:00”。

pspCustomerInfo PspCustomerInfo  

Alipay+支付方式的客户信息。

注意: Alipay+ 移动支付提供商，是参与Alipay+ 核心服务的移动支付合作伙伴，也是与蚂蚁集团成员合作、面向用户或发卡机构提供支付服务的其他支付服务提供商。

Show child parameters

grossSettlementAmount Amount  

结算总额，等于交易金额乘以 settlementQuote 的值。

注意：当结算货币与交易货币相同时，此字段为空。

Show child parameters

settlementQuote Quote  

交易时结算货币与交易货币之间的汇率，仅在锁定汇率的情况下提供。

注意：当结算货币与交易货币相同时，此字段为空。

Show child parameters

出参

result Result  REQUIRED

请求结果包含状态和错误代码等信息。

Show child parameters
API Explorer

请求

请求体

响应

响应体

更多信息 

本节提供了关于关键参数的额外信息。请参阅以下参数以了解详情：

  • result（在由 Antom 发送的通知请求中）：  
    支付结果。 如果 result.resultStatus 的值为S，则支付成功。
  • paymentTime:
    只有当 result.resultStatus 的值为S时，此字段才会返回。 
  • paymentActionForm:
    在线下支付场景中，通过此字段传递 paymentCode，商家可以将二维码展示给顾客。 

结果处理逻辑

如果 result.resultStatus 的值为S，支付结果通知成功。 Antom 不会采取进一步行动。

结果码

结果码值结果码信息行动建议
SUCCESSS成功

支付成功，无需进一步操作。