notifyDirectPayment
Antom 通过此接口发送直接支付结果。商户可以在调用 createDirectPayment 时通过指定 notifyUrl 字段，或在 Antom Dashboard 上设置 URL，用于接收付款通知。
入参
notifyType String REQUIRED
支付状态通知的类型。有效值为：
PAYMENT_RESULT：表示该通知与支付结果相关。
更多信息：
- 最大长度：32 字符
paymentId String
由 Antom 分配的用于标识支付的唯一 ID。
更多信息：
- 最大长度：64 字符
paymentRequestId String
由商户分配的用于标识支付请求的唯一 ID。
更多信息：
- 最大长度：64 字符
paymentStatus String REQUIRED
支付状态。有效值为：
SUCCESS：支付成功。FAIL：支付失败。
更多信息：
- 最大长度：32 字符
paymentResultMessage String
用于说明支付结果代码的支付结果消息。
注意：只有当 paymentStatus 的值为 FAIL 时，才会返回此参数。
更多信息：
- 最大长度：256 字符
paymentResultCode String
支付结果码。可能返回的支付结果码列在本页的 支付结果码 表中。
注意：只有当 paymentStatus 的值为 FAIL 时，才会返回此参数。
更多信息：
- 最大长度：64 字符
payToMethod PayToMethod REQUIRED
支付方式详情。
paymentAmount Amount
商户请求以订单货币接收的付款金额。
payToAmount Amount REQUIRED
收款方实际收到的金额。
出参
result Result
固定值，用于发送给 Antom 以确认已收到通知。
API Explorer
请求
响应
Payment result codes
| 结果码 | 值 | 结果码信息 | 行动建议 |
|---|---|---|---|
| PROCESS_FAIL | F | 系统发生常规业务故障，请勿重试。 | 需要人工介入。建议您联系 Antom 技术支持以解决该问题。 |
| USER_NOT_EXIST | F | 用户在支付方式端不存在。 | 请使用有效的用户 ID 重试。如果问题仍然存在，请联系 Antom 技术支持。 |
| USER_ACCOUNT_ABNORMAL | F | 用户的账户状态异常。 | 请联系 Antom 技术支持。 |
| AMOUNT_EXCEED_LIMIT | F | 支付金额超过了合同或支付方式允许的最大金额。 | 检查支付金额是否超过限制，或使用较低金额再试一次。 |
| RISK_REJECT | F | 由于风险控制，交易无法进一步处理。如果用户已为交易付款，交易将被退款。 | 请联系 Antom 技术支持。 |
| ORDER_IS_CLOSED | F | 订单已关闭。 | 请使用新的 paymentRequestId 重新发起支付。 |
| BALANCE_NOT_ENOUGH | F | 由于对应支付方式的用户余额不足，支付无法完成。 | 请充值账户或选择其他支付方式。 |
| UN_SUPPORT_BUSINESS | F | 不支持的业务。 | 请联系 Antom 技术支持。 |
| PARAM_ILLEGAL | F | 缺少必需的参数，或者存在非法参数。例如，非数字输入、无效的日期，或者参数的长度和类型错误。 | 检查并验证当前接口所需的请求字段（包括头部字段和正文字段）是否正确传递并有效。 |
| CURRENCY_NOT_SUPPORT | F | 不支持该币种。 | 请使用有效的货币重试。 |
| ACCESS_DENIED | F | 访问被拒绝。 | 请联络 Antom 技术支持获取详细原因。 |