Skip to content

查询卡信息

通过cardId查询已保存的卡信息。您需要在发送信用卡支付请求时，将“saveCard”字段值设置成“true”，cardId将包含在成功的信用卡交易返回参数中。

HTTP请求

GET /v1/payments/vault/card/{{cardId}}

Request Headers
{
    "Content-Type": "application/json",
    "Authorization": "Bearer {{access_token}}",
    "x-api-key": "{{api_key}}"
}
Response
{
    "cardId": "8736453a-dad0-4f26-85f0-95e8787d0237",
    "card": {
        "cardHolderName": "card_holder_name",
        "expirationMonth": 9,
        "expirationYear": 2024,
        "brand": "VISA",
        "bin": "458124",
        "last4": "0000"
    },
    "subMerchantId":"UUID"
}

HTTP Headers 字段说明

Key Value
Authorization "Bearer" + " " + {{access_token}}
x-api-key {{api_key}}

PATH and Query 字段说明

Parameter Type Description
cardId String 在一笔成功的信用卡交易中获取到的卡ID。当你在发送信用卡支付请求时，将“saveCard”字段值设置成“true”，cardId将包含在成功的信用卡交易返回参数中

Response Body 字段说明

Parameter Type Description
cardId String 在一笔成功的信用卡交易中获取到的卡ID。
card JSON 卡详细信息
subMerchantId String 子商户ID。

Card (响应)对象字段说明

参数 类型 描述
cardHolderName String 持卡人姓名
bin String 卡号前6位数字
last4 String 卡号后4位数字
brand String 信用卡组织. 如 VISA, MASTERCARD
expirationMonth Integer 1位数或者2位数的信用卡有效期月份。
expirationYear Integer 信用卡有效期年份，4位数。
Back to top