请款(收银台)
入参
captureRequestId String REQUIRED
商户为识别请款请求而分配的 ID。
更多信息:
- 此为幂等字段。对于使用相同的 captureRequestId 并达到最终状态(
S
或F
)发起的请款请求,应返回相同的请求结果。 - 最大长度:64 字符
paymentId String REQUIRED
Antom 为识别支付而分配的支付 ID。
更多信息:
- 最大长度:64 字符
captureAmount Amount REQUIRED
商户要求以交易币种接收的扣款金额。
出参
result Result REQUIRED
接口调用的结果。
captureRequestId String
商户为识别请款请求分配的专属 ID。
注意:当请款状态成功时,此参数返回。
更多信息:
- 最大长度:64 字符
captureId String
Antom 为识别请款分配的专属 ID。
注意:当请款状态成功时,此参数返回。
更多信息:
- 最大长度:64 字符
paymentId String
Antom 为识别支付而分配的专属 ID。
注意:当请款状态成功时,此参数返回。
更多信息:
- 最大长度:64 字符
captureAmount Amount
商户要求以交易币种接收的扣款金额。
注意:当请款状态成功时,此参数返回。
captureTime Datetime
Antom完成请款的时间。
注意:当请款状态成功时,此参数返回。
更多信息:
- 值遵循 ISO 8601 标准格式。例如,“2019-11-27T12:01:01+08:00”。
acquirerReferenceNo String
非 Antom 收单机构为交易分配的 ID。
更多信息:
- 最大长度:64 字符
请求
响应
结果码
结果码 | 值 | 结果码信息 | 行动建议 |
---|---|---|---|
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 技术支持获取详细原因。 |
MULTI_CAPTURE_NOT_SUPPORTED | F | 交易不支持多次请款。 | 请联系 Antom 技术支持获取详细原因。 |
INVALID_CONTRACT | 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 技术支持。 |