paymentTokenID查询

• Endpoint: POST /delSuffixStart1
• Tags: 收款/Tokenization支付

Description

注意请求地址不包含括号内的接口说明

Parameters

Field	In	Type	Required	Constraints	Description
sign	header	string	Yes

Parameter Examples

• 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
merchantId	string	Yes	maxLength: 30	PayerMax分配给商户的唯一标识
bizType	string	Yes	maxLength: 30	业务代码，此接口需传入“inquirePaymentToken”
version	string	Yes	maxLength: 5	接口版本。当前值为：2.6
userId	string	Yes	maxLength: 64	商户内部的用户ID，必须唯一
tokenScope	string	Yes	maxLength: 16	不填默认为tokenAcq
paymentTokenID	string	No	maxLength: 64

Example

{
  "merchantId": "SP328900011",
  "bizType": "inquirePaymentToken",
  "version": "2.6",
  "userId": "r047281273",
  "tokenScope": "tokenAcq"
}

Responses

200

Field	Type	Required	Constraints	Description	Enum
bizCode	string	Yes	maxLength: 10	返回码
message	string	No	maxLength: 256	返回描述
data	object	Yes		返回数据体，由公共参数和特定参数组成，详见下方的【data参数】
data.sign	string	Yes	maxLength: 64	采用MD5字符串签名，参见【MD5签名】
data.tokenList	array[object]	No		token列表
data.tokenList[].paymentTokenID	string	Yes	maxLength: 64
data.tokenList[].userId	string	Yes	maxLength: 64	商户内部的的用户号，必须唯一
data.tokenList[].tokenScope	string	Yes	maxLength: 16	产品范围	tokenAcq
data.tokenList[].paymentTokenExpiry	string	Yes	maxLength: 32	token有效期，符合rfc3339规范，格式：yyyy-MM-dd’T’HH:mm:ss.SSSXXX
data.tokenList[].paymentTokenStatus	string	Yes	maxLength: 16	token状态，卡token支付时，此字段为必填
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		支付方式类型，值为CARD、ONE_TOUCH等
data.tokenList[].targetOrg	string	No		目标机构，当paymentMethodType不是CARD时，值为DANA、GCASH等，paymentMethodType为CARD时，targetOrg为空字符串
data.tokenList[].accountDisplay	string	No		掩码授权账号，如63-9****72123，paymentMethodType为CARD时，accountDisplay为空字符串，paymentMethodType值不是CARD时，显示掩码授权账号

Response Example

{
  "data": {
    "tokenList": [
      {
        "tokenScope": "tokenAcq",
        "targetOrg": "KAKAOPAY",
        "ifCVV": "",
        "cardInfo": "",
        "paymentTokenID": "ed27884948d3b6cd0d17052e46064baf",
        "accountDisplay": "63-9****72180",
        "paymentTokenStatus": "Activated",
        "userId": "czy_0088",
        "brand": "",
        "paymentMethodType": "AUTO_DEBIT",
        "paymentTokenExpiry": "2123-07-13T09:24:37.000Z"
      },
      {
        "tokenScope": "tokenAcq",
        "targetOrg": "",
        "ifCVV": "N",
        "cardInfo": "455701******8902",
        "paymentTokenID": "PMTOKEN20230710080439571142400031000",
        "accountDisplay": "",
        "paymentTokenStatus": "Activated",
        "userId": "czy_0088",
        "brand": "VISA",
        "paymentMethodType": "CARD",
        "paymentTokenExpiry": "2023-07-14T00:00:00.537Z"
      }
    ]
  },
  "bizCode": "0000",
  "message": "success"
}

Enum Reference

data.tokenList[].tokenScope

• tokenAcq