发起付款
发起付款接口是在对外付款时必须接入的接口能力。
PayerMax提供了全球150余个国家的支付方式,每个支付方式要求的字段可能不同。在接入前,请参考支付方式列表来明确对接的支付方式。
1. 交互流程
2. 下单请求
您可在下方选择对接的支付方式来获取您需要送的参数:
- 如需获取全量支付方式的参数要求,具体请参考:付款申请模板及填写规范;
- 接口详细说明请参考 申请付款 API。
3.下单响应
3.1 下单成功响应
当收到响应中code = APPLY_SUCCESS、msg = Success.时,代表请求成功,并不代表交易成功。需要根据返回data体中的status字段来判断交易的状态。详情请参考 申请付款 API。
3.2 下单失败响应
3.2.1 服务端请求限制
在发起付款申请时,您可能遇到的「服务端请求限制」类的错误码如下:
| 分类 | 错误码 | 错误描述 | 备注 |
| 服务端请求限制 | REQ_TIME_OVER_TIME | requestTime effective in two minutes | 请求时间与服务端偏差超过2分钟,请检查requestTime后重新发起 |
| ILLEGAL_IP_REQUEST | illegal ip request | 请求IP需要加入白名单,请联系PayerMax | |
| TOO_MANY_REQUEST | Exceed request limitation, please retry later | 触发接口并发限流,请稍后重试 |
3.2.2 商户配置校验
在发起付款申请时,您可能遇到的「商户配置校验」类的错误码如下:
| 分类 | 子分类 | 错误码 | 错误描述 | 备注 |
| 商户配置校验 | 签名/密钥配置校验 | MERCHANT_APP_INVALID | Signature key is not configured. | 密钥未配置,请尽快配置秘钥 |
| SIGN_VERIFY_FAILED | The signature verify failed. | 验签失败,请检查秘钥或签名逻辑 | ||
| 合约可用性校验 | CONTRACT_INVALID | Merchant has not signed the contract or payment methods. | 未签约或未开通该支付方式,请检查合约开通情况 | |
| MERCHANT_INVALID | The merchant has been offline. | 商户已下线,如有疑问请联系PayerMax |
3.2.3 订单信息接收
在发起付款申请时,您可能遇到的「订单信息接收」类的错误码如下:
| 分类 | 子分类 | 错误码 | 错误描述 | 备注 |
| 订单信息接收 | 请求参数校验 | PARAMS_INVALID | The {field} is incorrect. | 【字段】校验不符合规则,请参考《付款申请模板及填写规范》查看对应支付方式下的字段规则 |
| PARAMS_INVALID | The {field} is incorrect,you should fill {?} | 【字段】校验不符合规则,请根据提示并参考《付款申请模板及填写规范》查看对应支付方式下的字段规则 | ||
| ORDER_REPEAT | The order number repeat. | 订单号重复,请修改后重新发起 | ||
| 其他异常 | SYSTEM_ERROR | System is busy, Please try again later. | 系统异常,请检查订单状态,如落单失败则重新发起 |
