Skip to content

API

1.接口结构

如下是调用payermax接口的http结构,接口名称放到请求地址后面,data里边的内容为不同业务结构拼接而成的报文

json
POST https://pay-gate.payermax.com/aggregate-pay/api/gateway/{接口名称}
Content-Type: application/json
Content-Length: 580
sign: 根据请求body使用merchant privateKey签名

{
    "version": "1.1",
    "keyVersion": "1",
    "requestTime": "2022-01-17T08:04:13.879+00:00",
    "appId": "3b242b56a8b64274bcc37dac281120e3",
    "merchantNo": "020213827212251",
    "data": {
    }
}

请求地址:

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

2.接口列表

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

3.接口传参规则

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

Released under the MIT License.