Skip to content

发起付款

发起付款接口是在对外付款时必须接入的接口能力。

PayerMax提供了全球150余个国家的支付方式,每个支付方式要求的字段可能不同。在接入前,请参考支付方式列表来明确对接的支付方式。

1. 交互流程

2. 下单请求

您可在下方选择对接的支付方式来获取您需要送的参数:

  1. 如需获取全量支付方式的参数要求,具体请参考:付款申请模板及填写规范
  2. 接口详细说明请参考 申请付款 API

3.下单响应

3.1 下单成功响应

当收到响应中code = APPLY_SUCCESSmsg = Success.时,代表请求成功,并不代表交易成功。需要根据返回data体中的status字段来判断交易的状态。详情请参考 申请付款 API

3.2 下单失败响应

3.2.1 服务端请求限制

在发起付款申请时,您可能遇到的「服务端请求限制」类的错误码如下:

分类错误码错误描述备注
服务端请求限制REQ_TIME_OVER_TIMErequestTime effective in two minutes请求时间与服务端偏差超过2分钟,请检查requestTime后重新发起
ILLEGAL_IP_REQUESTillegal ip request请求IP需要加入白名单,请联系PayerMax
TOO_MANY_REQUESTExceed request limitation, please retry later触发接口并发限流,请稍后重试

3.2.2 商户配置校验

在发起付款申请时,您可能遇到的「商户配置校验」类的错误码如下:

分类子分类错误码错误描述备注
商户配置校验签名/密钥配置校验MERCHANT_APP_INVALIDSignature key is not configured.密钥未配置,请尽快配置秘钥
SIGN_VERIFY_FAILEDThe signature verify failed.验签失败,请检查秘钥或签名逻辑
合约可用性校验CONTRACT_INVALIDMerchant has not signed the contract or payment methods.未签约或未开通该支付方式,请检查合约开通情况
MERCHANT_INVALIDThe merchant has been offline.商户已下线,如有疑问请联系PayerMax

3.2.3 订单信息接收

在发起付款申请时,您可能遇到的「订单信息接收」类的错误码如下:

分类子分类错误码错误描述备注
订单信息接收请求参数校验PARAMS_INVALIDThe {field} is incorrect.【字段】校验不符合规则,请参考《付款申请模板及填写规范》查看对应支付方式下的字段规则
PARAMS_INVALIDThe {field} is incorrect,you should fill {?}【字段】校验不符合规则,请根据提示并参考《付款申请模板及填写规范》查看对应支付方式下的字段规则
ORDER_REPEATThe order number repeat.订单号重复,请修改后重新发起
其他异常SYSTEM_ERRORSystem is busy, Please try again later.系统异常,请检查订单状态,如落单失败则重新发起

Released under the MIT License.