请款通知（收银台）

2024-11-22 00:47

Antom 使用此接口在请款处理完成后，将请款结果通知给商家。

结构

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

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

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

入参

result Result REQUIRED

请款结果的详细信息，如请款状态、结果代码和结果消息。

Show child parameters

notifyType String REQUIRED

通知的类型。此接口的通知类型为CAPTURE_RESULT。

captureRequestId String REQUIRED

商户为识别请款请求而分配的专属 ID。

更多信息：

最大长度：64 字符

paymentId String REQUIRED

Antom 为识别支付而分配的支付 ID。

更多信息：

最大长度：64 字符

captureId String REQUIRED

Antom 为识别请款而分配的请款 ID。

更多信息：

最大长度：64 字符

captureAmount Amount REQUIRED

商家在交易币种中请求收取的请款金额。

Show child parameters

captureTime Datetime

Antom 完成请款的时间。

acquirerReferenceNo String

非 Antom 收单机构为交易分配的交易 ID。

更多信息：

最大长度：64 字符

出参

result Result REQUIRED

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

Show child parameters

API Explorer

请求

Case

Capture successful

请求体

响应

响应体

结果处理逻辑

在收到 Antom 通知后，发送以下固定值的消息给 Antom，以确认收到 Antom 的通知：

Sample Code

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

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

结果码

结果码	值	结果码信息	行动建议
SUCCESS	S	成功	请款成功，无需进一步操作。
ACCESS_DENIED	F	访问被拒绝。	请联系 Antom 技术支持获取详细原因。
AUTH_CANCELLED	F	支付授权已取消。	使用新的 paymentRequestId 来发起支付。
AUTH_EXPIRED	F	支付授权已过期。	使用新的 paymentRequestId 来发起支付。
AUTH_NOT_FOUND	F	找不到支付授权。	请联系 Antom 技术支持获取详细原因。
CAPTURE_AMOUNT_EXCEED_AUTH_LIMIT	F	请款总额超过了授权支付金额的限制。	使用不超过授权支付金额的金额创建新的请款请求，或联系 Antom 技术支持。
CAPTURE_IN_PROCESS	U	请款处理中。	等待 Antom 的通知或查询请款结果。
CURRENCY_NOT_SUPPORT	F	币种不受支持。	检查请求中使用的币种，例如请款币种。如果问题仍然存在请联系 Antom 技术支持获取详细原因。
INVALID_CONTRACT	F	合同中的参数值与当前交易不符。	检查合同中的参数值是否与当前交易匹配。如果值匹配，请联系 Antom 技术支持解决问题。
MULTI_CAPTURE_NOT_SUPPORTED	F	交易不支持多次请款。	请联系 Antom 技术支持获取详细原因。
NO_PAY_OPTIONS	F	没有可用的支付方式。	请联系 Antom 技术支持以获取详细原因。
ORDER_IS_CANCELED	F	交易已取消。	使用新的 paymentRequestId 发起支付。
ORDER_STATUS_INVALID	F	交易状态异常，无法进行支付请款。	检查交易状态。如果值匹配，请联系 Antom 技术支持解决问题。
PARAM_ILLEGAL	F	缺少必需的参数，或者存在非法参数。例如，非数字输入，无效的日期，或者参数的长度和类型错误。	检查并验证当前接口所需的请求字段（包括头部字段和正文字段）是否正确传递并有效。
PAYMENT_COUNT_EXCEED_LIMIT	F	请款次数超过了支付方式指定的限制。	请联系 Antom 技术支持了解具体限制。
PROCESS_FAIL	F	请款失败。	在获取 Antom 技术支持前请勿重试。
REPEAT_REQ_INCONSISTENT	F	提交的请求已存在，且此请求的参数值与已存在请求不一致。	确保请求中的所有字段相同，或使用新的 paymentRequestId 发起支付。
RISK_REJECT	F	因风险控制，请求被拒绝。	提示用户请求因风险控制失败而被拒绝。
USER_AMOUNT_EXCEED_LIMIT	F	请款金额超过了用户的支付限额。	使用不超过用户支付限额的金额创建新的请款，或联系用户或发卡行。
USER_BALANCE_NOT_ENOUGH	F	用户的余额不足以完成请款。	请联系 Antom 技术支持获取详细原因。
USER_NOT_EXIST	F	在支付方式端，用户的账户不存在。	请联系用户或发卡行。
USER_STATUS_ABNORMAL	F	在支付方式端，用户的账户状态异常。	请联系 Antom 技术支持了解具体原因。
UNKNOWN_EXCEPTION	U	由于未知原因，接口调用失败。	再次调用接口解决问题。如果问题持续，请联系 Antom 技术支持。