paymentTokenID查询

• Endpoint: POST /aggregate-pay/api/gateway/inquirePaymentToken
• 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
data	object	Yes		请求数据体
data.userId	string	Yes	maxLength: 64	商户内部的的用户号，必须唯一
data.tokenScope	string	Yes	maxLength: 16	不填默认为tokenAcq	tokenAcq, tokenMit
data.paymentTokenID	string	No	maxLength: 64	PMMax token
data.paymentMethodType	string	No		支付方式类型，可传CARD、WALLET等
data.targetOrg	string	No		目标机构，当paymentMethodType=CARD时，该字段不传或传空字符串
data.cardOrg	string	No		卡组，当paymentMethodType=CARD时，可传VISA、MASTERCARD等卡组
data.referralCode	string	No		token绑定的唯一标识
version	string	Yes		接口版本 当前值为：1.2
keyVersion	string	Yes	maxLength: 8	密钥版本 当前值为：1
requestTime	string	Yes	maxLength: 32	请求时间，符合rfc3339规范，格式：yyyy-MM-dd'T'HH:mm:ss.SSSXXX 时间需要在当前时间两分钟内
appId	string	Yes	maxLength: 64	商户应用Id，PayerMax分配给商户应用的唯一标识
merchantNo	string	No	maxLength: 32	商户号，商户与PayerMax业务签约时生成的唯一标识

Example

{
  "version": "1.2",
  "keyVersion": "1",
  "requestTime": "2022-01-22T10:00:00.500+08:00",
  "appId": "46153e2b787241ae8b01857bb087d1bd",
  "merchantNo": "010229810189301",
  "data": {
    "userId": "TEST",
    "tokenScope": "tokenAcq",
    "paymentTokenID": "PMTOKEN20230424072005899168200035002",
    "paymentMethodType": "CARD",
    "cardOrg": "VISA",
    "referralCode": "xxx"
  }
}

Responses

200

Field	Type	Required	Constraints	Description	Enum
data	object	Yes
data.tokenList	array[object]	Yes		token列表
data.tokenList[].paymentTokenID	string	Yes	maxLength: 64	PMMax token
data.tokenList[].userId	string	Yes	maxLength: 64	商户内部的的用户号，必须唯一
data.tokenList[].tokenScope	string	Yes	maxLength: 16	适用范围	tokenAcq
data.tokenList[].paymentTokenExpiry	string	Yes	maxLength: 64	token有效期，符合rfc3339规范，格式：yyyy-MM-dd’T’HH:mm:ss.SSSXXX
data.tokenList[].paymentTokenStatus	string	Yes	maxLength: 16	token状态，卡token支付时，此字段为必填	Deleted, Activated, Expired
data.tokenList[].cardInfo	string	No	maxLength: 19	掩码卡号，按照前6后4脱敏，如533333**2222
data.tokenList[].ifCVV	string	No	maxLength: 1	是否需要CVV。 Y: 使用Token支付时需要再次输入CVV; N:使用Token支付时不需要再次输入CVV。 注：根据发卡行规则存在再次验证CVV的情况
data.tokenList[].brand	string	No	maxLength: 32	卡组，如Visa，Mastercard，双标卡则都返回
data.tokenList[].paymentMethodType	string	Yes	maxLength: 32	支付方式类型，值为CARD、ONE_TOUCH等
data.tokenList[].targetOrg	string	No	maxLength: 32	目标机构，只有当paymentMethodType不是CARD时，值为DANA、GCASH等，paymentMethodType为CARD时，targetOrg为空字符串
data.tokenList[].accountDisplay	string	No		掩码授权账号，如63-9****72123；paymentMethodType为CARD时，accountDisplay为空字符串，paymentMethodType值不是CARD时，显示掩码授权账号
data.tokenList[].referralCode	string	No		token绑定唯一标识
code	string	Yes		返回码，’APPLY_SUCCESS’代表成功
msg	string	Yes		返回描述，’Success.’

Response Example

{
  "msg": "",
  "code": "APPLY_SUCCESS",
  "data": {
    "tokenList": [
      {
        "tokenScope": "tokenAcq",
        "targetOrg": "",
        "ifCVV": "N",
        "cardInfo": "455701******1010",
        "paymentTokenID": "PMTOKEN20230710080439571142400031000",
        "accountDisplay": "",
        "paymentTokenStatus": "Activated",
        "userId": "czy_0088",
        "brand": "VISA",
        "paymentMethodType": "CARD",
        "paymentTokenExpiry": "2023-07-14T00:00:00.537Z",
        "referralCode": "xxxx"
      }
    ]
  }
}

Enum Reference

data.tokenScope

• tokenAcq
• tokenMit

data.tokenList[].tokenScope

• tokenAcq

data.tokenList[].paymentTokenStatus

• Deleted
• Activated
• Expired