Skip to content

接口参数

API

##1、请求参数
参数类型是否必填最大长度描述示例值
merchantIdString30PayerMax分配给商户的唯一标识
userIdString16商户内部的用户号,**必须唯一**ZNW3e
paymentTokenIDString64
tokenScopeString16产品范围
paymentTokenExpiryString32token有效期,符合rfc3339规范,格式:yyyy-MM-dd’T’HH:mm:ss.SSSXXX
paymentTokenStatusString16token状态,卡token支付时,此字段为必填
cardInfoString19掩码卡号,按照前6后4脱敏,如533333********2222paymentMethodType的值不是CARD时,cardInfo为空字符串
brandString32卡组,如Visa,Mastercard,双标卡则都返回paymentMethodType的值不是CARD时,brand为空字符串
ifCVVString1是否需要CVV。 Y: 使用Token支付时需要再次输入CVV; N:使用Token支付时不需要再次输入CVV。 注:根据发卡行规则存在再次验证CVV的情况paymentMethodType的值不是CARD时,ifCVV为空字符串
signString64采用MD5字符串签名,DD6F959727F2724B7FFFE164DFF77DDC1
orderIdString有条件的64原支付交易对应的商户订单号。只有当第一次授权绑卡支付成功后的通知接口中返回改字段。paymentTokenStatus 状态发生变更再次通知商户时,该字段为空。
「paymentMethodTypeString16支付方式类型值为CARD、ONE_TOUCH等
「targetOrgString16目标机构只有当paymentMethodType不是CARD时,值为DANA、GCASH等,paymentMethodType为CARD时,targetOrg为空字符串
「accountDisplayString32掩码授权账号,如63-9****72123paymentMethodType为CARD时,accountDisplay为空字符串,paymentMethodType值不是CARD时,显示掩码授权账号
「countryString8国家编码ID

##2、响应参数

参数类型是否必返最大长度描述示例值
bizCodeString6结果码0000
messageString32结果描述success
# 示例 >paymentMethodType不为CARD时,通知参数如下:
json
{
    "brand":"",
    "cardInfo":"",
    "ifCVV":"",
    "outTradeNo":"20230725203208988107020",
    "paymentMethodType":"ONE_TOUCH",
    "paymentTokenExpiry":"2025-01-11T20:01:55.200Z",
    "paymentTokenID":"5265908adbaa9bd202ba1eb29bd53d68",
    "paymentTokenStatus":"Activated",
    "targetOrg":"DANA",
    "accountDisplay":"63-9****72123",
    "tokenScope":"tokenAcq",
    "userId":"victor002",
    "sign":"9162930D1ED714FAA535761691F9FEF0",
}

paymentMethodType为CARD时,通知参数如下:

json
{
    "brand":"VISA",
    "ifCVV": "N",
    "cardInfo": "455701******1010",
    "outTradeNo":"20230725203208988107020",
    "paymentMethodType":"CARD",
    "paymentTokenExpiry":"2025-01-11T20:01:55.200Z",
    "paymentTokenID":"PMTOKEN20230710080439571142400031000",
    "paymentTokenStatus":"Activated",
    "targetOrg":"",
    "accountDisplay":"",
    "tokenScope":"tokenAcq",
    "userId":"victor002",
    "sign":"9162930D1ED714FAA535761691F9FEF1",
}

此页面的内容有帮助吗?

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

Last updated:

Released under the MIT License.