异步通知

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

Parameters

Field	In	Type	Required	Constraints	Description
Content-Type	header	string	Yes
sign	header	string	Yes		签名信息请参考技术文档

Parameter Examples

• Content-Type: "application/json"
• sign: "FPFVT3o227JrFRbqu19boZCpVVTF9KznxyRawUmxpfXilHV/0yK46haPhAjNu1hPUMy7Vw/ILXhfzffNm4Fj0apWknlTY9OJxnSoQxS9BTFtc61tn5yV1q69x/kkBl82/qwg+XTJ4fOzy7Mar3VaC1E2PlDA6RkkKBUyNE6RYgsdB+Su7an4+4HVTNAnoe74WyvBgxTLMNg28igBTdqxaO3w/UBY6ObVp7vkqkQGdL1Y+HgmMYaAVwrM3+ALWGId0sJ+YqTY4WJ+0xCRGhaSnybiIjZsQEYyID68WNUfuavDLDsEhaMm/HfQvf5p0R1Ltovp3wwJnEbQcjY458iX5A=="

Request Body

Content-Type: application/json

Field	Type	Required	Constraints	Description	Enum
code	string	Yes	maxLength: 32	返回码，’APPLY_SUCCESS’代表成功
msg	string	Yes	maxLength: 256	响应描述，’Success.’
appId	string	No	maxLength: 64	商户app id
merchantNo	string	Yes	maxLength: 15	商户Id
keyVersion	string	Yes	maxLength: 8	密钥版本。当前值为：1
notifyTime	string	Yes	maxLength: 32	通知时间，符合rfc3339规范，格式：yyyy-MM-dd’T’HH:mm:ss.SSSXXX
notifyType	string	Yes	maxLength: 16	通知类型 TOKENIZATION
data	object	Yes		请求数据体
data.userId	string	Yes	maxLength: 64	商户内部的的用户号，必须唯一
data.paymentTokenID	string	Yes	maxLength: 64	PMMax token
data.tokenScope	string	Yes	maxLength: 16	适用范围	tokenAcq, tokenRec, tokenLink
data.paymentTokenExpiry	string	Yes	maxLength: 32	token有效期，符合rfc3339规范，格式：yyyy-MM-dd’T’HH:mm:ss.SSSXXX
data.paymentTokenStatus	string	Yes	maxLength: 16	token状态，卡token支付时，此字段为必填	Deleted, Activated, Expired
data.cardInfo	string	No	maxLength: 19	掩码卡号，按照前6后4脱敏，如533333**2222
data.ifCVV	string	No	maxLength: 1	是否需要CVV。 Y: 使用Token支付时需要再次输入CVV; N:使用Token支付时不需要再次输入CVV。 注：根据发卡行规则存在再次验证CVV的情况
data.brand	string	No	maxLength: 32	卡组，如Visa，Mastercard，双标卡则都返回
data.outTradeNo	string	No	maxLength: 64	原支付交易对应的商户订单号。只有当第一次授权绑卡支付成功后的通知接口中返回改字段。paymentTokenStatus 状态发生变更再次通知商户时，该字段为空。
data.paymentMethodType	string	Yes	maxLength: 32	支付方式类型，值为CARD、ONE_TOUCH等
data.targetOrg	string	No	maxLength: 32	目标机构，当paymentMethodType不是CARD时，值为DANA、GCASH等，paymentMethodType为CARD时，targetOrg为空字符串
data.accountDisplay	string	No		掩码授权账号，如63-9****72123，paymentMethodType为CARD时，accountDisplay为空字符串，paymentMethodType值不是CARD时，显示掩码授权账号
data.country	string	Yes		国家编码
data.requestId	string	Yes		token申请单号，最新回调版本返回字段，
data.supportMIT	boolean	Yes		token是否支持MIT的标识
data.status	string	Yes		token申请状态	SUCCESS, FAILED
data.referralCode	string	No		token绑定唯一标识

Example

{
  "code": "APPLY_SUCCESS",
  "data": {
    "accountDisplay": "63-9****72123",
    "brand": "",
    "cardInfo": "",
    "ifCVV": "",
    "outTradeNo": "20230725203208988107020",
    "paymentMethodType": "ONE_TOUCH",
    "paymentTokenExpiry": "2025-01-11T20:01:55.200Z",
    "paymentTokenID": "5265908adbaa9bd202ba1eb29bd53d68",
    "paymentTokenStatus": "Activated",
    "targetOrg": "DANA",
    "tokenScope": "tokenAcq",
    "userId": "victor002",
    "country": "ID",
    "referralCode": "xxx"
  },
  "keyVersion": "1",
  "merchantAppId": "0d22b150ff58454d888d51657da98470",
  "merchantNo": "SP103301558",
  "msg": "Success.",
  "notifyTime": "2023-07-25T12:40:07.072Z",
  "notifyType": "TOKENIZATION"
}

Responses

200

Field	Type	Required	Constraints	Description	Enum
code	string	Yes	maxLength: 32	响应 ‘SUCCESS’
msg	string	No		响应 ‘Success’

Response Example

{
  "code": "SUCCESS",
  "msg": "Success"
}

Enum Reference

data.tokenScope

• tokenAcq
• tokenRec
• tokenLink

data.paymentTokenStatus

• Deleted
• Activated
• Expired

data.status

• SUCCESS
• FAILED