Skip to content

异步通知

  • Endpoint: POST /tokenizationNotifyUrl
  • Tags: 收单/Tokenization支付

Parameters

FieldTypeRequiredDescription
Content-Type (header)stringYes
sign (header)stringYes签名信息请参考技术文档

Request Body

FieldTypeRequiredDescriptionEnum
codestringYes返回码,’APPLY_SUCCESS’代表成功
msgstringYes响应描述,’Success.’
appIdstringNo商户app id
merchantNostringYes商户Id
keyVersionstringYes密钥版本。当前值为:1
notifyTimestringYes通知时间,符合rfc3339规范,格式:yyyy-MM-dd’T’HH:mm:ss.SSSXXX
notifyTypestringYes通知类型 TOKENIZATION
dataobjectYes请求数据体
data.userIdstringYes商户内部的的用户号,必须唯一
data.paymentTokenIDstringYesPMMax token
data.tokenScopestringYes适用范围tokenAcq, tokenRec, tokenLink
data.paymentTokenExpirystringYestoken有效期,符合rfc3339规范,格式:yyyy-MM-dd’T’HH:mm:ss.SSSXXX
data.paymentTokenStatusstringYestoken状态,卡token支付时,此字段为必填Deleted, Activated, Expired
data.cardInfostringNo掩码卡号,按照前6后4脱敏,如533333**2222
data.ifCVVstringNo是否需要CVV。 Y: 使用Token支付时需要再次输入CVV; N:使用Token支付时不需要再次输入CVV。 注:根据发卡行规则存在再次验证CVV的情况
data.brandstringNo卡组,如Visa,Mastercard,双标卡则都返回
data.outTradeNostringNo原支付交易对应的商户订单号。只有当第一次授权绑卡支付成功后的通知接口中返回改字段。paymentTokenStatus 状态发生变更再次通知商户时,该字段为空。
data.paymentMethodTypestringYes支付方式类型,值为CARD、ONE_TOUCH等
data.targetOrgstringNo目标机构,当paymentMethodType不是CARD时,值为DANA、GCASH等,paymentMethodType为CARD时,targetOrg为空字符串
data.accountDisplaystringNo掩码授权账号,如63-9****72123,paymentMethodType为CARD时,accountDisplay为空字符串,paymentMethodType值不是CARD时,显示掩码授权账号
data.countrystringYes国家编码
data.requestIdstringYestoken申请单号,最新回调版本返回字段,
data.supportMITbooleanYestoken是否支持MIT的标识
data.statusstringYestoken申请状态SUCCESS, FAILED
data.referralCodestringNotoken绑定唯一标识

Responses

200

FieldTypeRequiredDescription
codestringYes响应 ‘SUCCESS’
msgstringNo响应 ‘Success’

Enum Reference

data.tokenScope

  • tokenAcq
  • tokenRec
  • tokenLink

data.paymentTokenStatus

  • Deleted
  • Activated
  • Expired

data.status

  • SUCCESS
  • FAILED

此页面的内容有帮助吗?

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

Last updated:

Released under the MIT License.