接口参数

API

##1、请求参数

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

##2、响应参数

参数	类型	是否必返	最大长度	描述	示例值
bizCode	String	是	6	结果码	0000
message	String	否	32	结果描述	success

# 示例 >paymentMethodType不为CARD时，通知参数如下：

{
    "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时，通知参数如下：

{
    "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",
}