# API For Obtaining Card Details

### Description

Obtain card details

### Request URL

/open/api/card/info

### Request Method

POST

### Request Parameter

| Parameter | Mandatory | Type   | Description     |
| --------- | --------- | ------ | --------------- |
| cardId    | Y         | string | Virtual Card ID |

### Request Example

```
{
    "cardId": "c_xxxxxxxxxxx"
}
```

### Response Parameter

| Parameter     | Type    | Description                                                                                                                                                                                                                                                                                                                                                                                                                    |
| ------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| +cardHolder   | object  | Cardholder Information                                                                                                                                                                                                                                                                                                                                                                                                         |
| └firstName    | string  | Cardholder's surname                                                                                                                                                                                                                                                                                                                                                                                                           |
| └lastName     | string  | Cardholder Name                                                                                                                                                                                                                                                                                                                                                                                                                |
| └street       | string  | Street                                                                                                                                                                                                                                                                                                                                                                                                                         |
| └city         | string  | City                                                                                                                                                                                                                                                                                                                                                                                                                           |
| └state        | string  | State                                                                                                                                                                                                                                                                                                                                                                                                                          |
| └country      | string  | Country                                                                                                                                                                                                                                                                                                                                                                                                                        |
| └zipCode      | string  | Zipcode                                                                                                                                                                                                                                                                                                                                                                                                                        |
| +card         | object  | Card information                                                                                                                                                                                                                                                                                                                                                                                                               |
| └userId       | string  | User ID                                                                                                                                                                                                                                                                                                                                                                                                                        |
| └cardHolderId | string  | Cardholder ID                                                                                                                                                                                                                                                                                                                                                                                                                  |
| └cardId       | string  | Card ID                                                                                                                                                                                                                                                                                                                                                                                                                        |
| └customerId   | string  | Custom Customer ID                                                                                                                                                                                                                                                                                                                                                                                                             |
| └cardSeqNo    | string  | CARD series number                                                                                                                                                                                                                                                                                                                                                                                                             |
| └deposit      | integer | Deposit, 1000 represents $10.00                                                                                                                                                                                                                                                                                                                                                                                                |
| └consume      | integer | Consumption, 1000 represents $10.00                                                                                                                                                                                                                                                                                                                                                                                            |
| └balance      | integer | Balance, 1000 represents $10.00                                                                                                                                                                                                                                                                                                                                                                                                |
| └cvc          | string  | Cvc virtual card verification code, also known as cvv in VISA cards                                                                                                                                                                                                                                                                                                                                                            |
| └number       | string  | Card number                                                                                                                                                                                                                                                                                                                                                                                                                    |
| └cardBin      | string  | Card section (top 6 digits of card number)                                                                                                                                                                                                                                                                                                                                                                                     |
| └last4        | string  | Last four digits                                                                                                                                                                                                                                                                                                                                                                                                               |
| └status       | string  | <p>INIT: Card opening<br>INIT <em>CREATE</em> CARD: Create Virtual Card<br>INIT <em>CREATE</em> CARD <em>HOLDER: Create Cardholder</em><br><em>INIT</em> ACTIVE <em>CARD: Activate Card</em><br><em>CREATE</em> CARD <em>FAILED</em> REFUND: Card creation failed, full refund<br>ACTIVE: Activated<br>FREEZE: Frozen<br>CANCELLING: Deleting card<br>CANCELED: Deleted<br>DELETED: Permanently delete<br>EXPIRED: Expired</p> |
| └statusText   | string  | Card Status Text                                                                                                                                                                                                                                                                                                                                                                                                               |
| └expYear      | integer | Card expiration year                                                                                                                                                                                                                                                                                                                                                                                                           |
| └expMonth     | integer | Card Expiration Month                                                                                                                                                                                                                                                                                                                                                                                                          |
| └gmtCreate    | string  | Card opening time                                                                                                                                                                                                                                                                                                                                                                                                              |
| tags          | array   | Card Label List                                                                                                                                                                                                                                                                                                                                                                                                                |
| └             | string  | Card Label                                                                                                                                                                                                                                                                                                                                                                                                                     |

### Response Example

```
{
    "success": true,
    "error":false,
    "msg": "success",
    "code": 0,
    "model": {
        "cardHolder": {
            "firstName": "Milton",
            "lastName": "Schmitt",
            "address": {
                "street": "1010 Pine St LOT 12-E",
                "city": "Vienna",
                "state": "GA",
                "country": "US",
                "zipCode": "31092"
            }
        },
        "card": {
            "userId": "u_xxxxxxxx",
             "cutomerId": "user_id_123",
            "cardHolderId": "ch_xxxxxxxxxx",
            "holderName": "Milton Schmitt",
            "cardId": "c_xxxxxxxxxx",
            "cardSeqNo": "CXXXXXXXX",
            "deposit": 1000,
            "consume": 0,
            "balance": 1000,
            "cvc": "123",
            "number": "40000099900XXXXX",
            "cardBin": "400000",
            "last4": "9360",
            "status": "ACTIVE",
            "statusText": "已激活",
            "expYear": 2025,
            "expMonth": 2,
            "gmtCreate": 1646648710000
        },
        "tags": [
            "test"
        ]
    },
    "traceId": 1646651433202
}
```

<br>