跳转至

查询卡信息

通过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"
    }
}

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 卡详细信息

Card (响应)对象字段说明

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