Skip to content

接口说明

1. 通讯协议

商户接入PayerMax 服务,调用API须遵循以下规则:

类型说明
传输方式为保证交易安全性,采用HTTPS传输,且TLS版本不低于1.2,详情参考 TLS升级说明
提交方式采用POST方法提交
数据格式提交和返回数据都为application/json格式
字符编码统一采用UTF-8字符编码
签名算法SHA256WithRSA
签名要求请求和接收数据均需要校验签名,详细方法请参考 配置与签名
判断逻辑先判断协议字段返回,再判断业务返回,最后判断交易状态

2. 报文结构


2.1 HTTP请求

json
# HTTP URL
POST https://pay-gate.payermax.com/aggregate-pay/api/gateway/{接口PATH}

# HTTP Header
Accept: application/json
Content-Type: application/json
Content-Length: 580
sign: 使用商户私钥对HTTP Body加签后的签名字符串

# HTTP Body
{
    "version": "1.4", # PayerMax版本
    "keyVersion": "1", # 密钥版本
    "requestTime": "2022-01-17T08:04:13.879+00:00", # 请求时间戳,须在当前时间两分钟内。格式遵循rfc3339规范,格式:yyyy-MM-dd'T'HH:mm:ss.SSSXXX
    "appId": "3b242b56a8b64274bcc37dac281120e3", 
    "merchantNo": "020213827212251",
    "data": <业务数据对象JSON>
}

2.1 HTTP响应

json
{
  "code": "APPLY_SUCCESS", # 响应结果码,标识请求的处理结果,在失败时,通过结果码可以判定失败原因
  "msg": " Success", # 响应结果信息,请求失败时,描述失败原因
  "data": <业务数据JSON>
}

注意:

code仅表示请求处理结果,不表示业务单据状态(如:支付结果、退款结果等)。如果要看业务单据状态,一般可以通过data.statusdata.<其他字段>获取。

3. 请求地址:

联调环境请求地址
Testhttps://pay-gate-uat.payermax.com/aggregate-pay/api/gateway
Prodhttps://pay-gate.payermax.com/aggregate-pay/api/gateway

4. 接口列表

产品集成模式接口名称Endpoint描述
收款收银台支付下单/orderAndPay使用payermax收银台进行支付
交易查询/orderQuery
下单异步通知通知
退款申请/refund
退款查询/refundQuery
退款结果通知通知
纯API支付下单/orderAndPay使用商户自己收银台进行支付
交易查询/orderQuery
下单异步通知通知
退款申请/refund
退款查询/refundQuery
退款结果通知通知
Tokenization支付paymentTokenID查询/inquirePaymentToken 当用户使用卡支付方式,支付成功后会把卡token给商户,后续商户发起支付带上卡token进行支付,方便用户快速完成支付
paymentTokenID解绑/removePaymentToken
异步通知通知
PayByLink支付创建支付链接/createPaybylink直接帮商家创建一个支付链接,发送给消费者后进行支付
查询链接详情/queryPaybylink
失效支付链接/expirePaybylink
更新异步回调通知
争议争议异步通知通知交易完成后用户进行拒付、争议、欺诈、投诉等产生的订单通知给商户
案件回复/caseReplay
案件查询/caseSearch
付款API付款付款请求/paymentOrderPay商户向用户进行付款
付款交易查询/paymentOrderQry
异步通知通知
账户余额余额查询实时余额查询/currentBalanceQuery商户进行余额查询
日终余额查询/dayEndBalanceQuery

5. 接口传参规则

是否必填描述
M必填(Mandatory)
O选填(Optional)
C特定条件下必填(Condition)

此页面的内容有帮助吗?

感谢您帮助改进 PayerMax 产品文档!

Last updated:

Released under the MIT License.