请款通知(收银台)
入参
result Result REQUIRED
请款结果的详细信息,如请款状态、结果代码和结果消息。
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
商家在交易货币中请求收取的请款金额。
captureTime Datetime
Antom 完成请款的时间。
acquirerReferenceNo String
非 Antom 收单机构为交易分配的交易 ID。
更多信息:
- 最大长度:64 字符
出参
result Result REQUIRED
发送给 Antom 以确认已收到通知的固定值。
请求
响应
结果处理逻辑
在收到 Antom 通知后,发送以下固定值的消息给 Antom,以确认收到 Antom 的通知:
如果由于操作问题或网络问题没有将此类消息返回给 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 技术支持。 |