---
updatedAt: 2025-11-13T14:40:54.000Z
agentTools:
  siteIndex: https://docs.affirm.com/llms.txt
  projectIndex: https://docs.affirm.com/developers/v1.0-Global-Integration/llms.txt
---

# The card object

## Attributes

| Attribute            | Data type   | Description                                                                                                                                                                                                               |
| :------------------- | :---------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **billing\_address** | *object*    | See [details](https://docs.affirm.com/developers/v1.0-Global-Integration/reference/the-billing-object). This object can be ignored, as you will always be using the customer's billing (if provided) or shipping address. |
| **checkout\_token**  | *string*    | The virtual card token.                                                                                                                                                                                                   |
| **created**          | *timestamp* | Timestamp of when the virtual card was generated.                                                                                                                                                                         |
| **cvv**              | *string*    | The virtual card security code.                                                                                                                                                                                           |
| **number**           | *string*    | The virtual card number. In sandbox, we can set up this number to your payment gateway for testing.                                                                                                                       |
| **callback\_id**     | *string*    | Can be ignored, for Affirm internal use.                                                                                                                                                                                  |
| **cardholder\_name** | *string*    | Can be ignored, since you will always be using the customer's name. Note that this is not necessarily the billing name associated with the card number on the card networks.                                              |
| **expiration**       | *string*    | A four-digit expiration date in MMYY format.                                                                                                                                                                              |
| **charge\_ari**      | *string*    | An 8-digit Affirm identifier.                                                                                                                                                                                             |

<div class="rdmd-pinned">

```json The Card Object
{
    "billing_address": {
        "street1": "4519 Rue Levy",
      	 "street2": "Apt 1",
      	 "city": "Saint-Laurent",
      	 "region1_code": "QC",
      	 "postal_code": "H4R2P9",
     		 "country": "CAN"
    },
    "checkout_token": "FA0UUFRGOND84S7C",
    "created": "2020-01-24T20:00:50.712662",
    "cvv": "123",
    "number": "4111111111111111",
    "callback_id": "5473686c-1dc4-4153-b9a7-abfccc00ef3a",
    "cardholder_name": "AffirmInc John doe",
    "expiration": "0121",
  	"charge_ari": "35PW-YI16"
}
```

</div>

# Sibling pages

* [The billing object](https://docs.affirm.com/developers/v1.0-Global-Integration/reference/the-billing-object.md)
* [Name object](https://docs.affirm.com/developers/v1.0-Global-Integration/reference/name-object.md)
* [Address object](https://docs.affirm.com/developers/v1.0-Global-Integration/reference/address-object.md)
* [The response object](https://docs.affirm.com/developers/v1.0-Global-Integration/reference/the-response-object.md)
* [Read Card](https://docs.affirm.com/developers/v1.0-Global-Integration/reference/read_card.md)
* [Cancel Card](https://docs.affirm.com/developers/v1.0-Global-Integration/reference/cancel_card.md)
* [Finalize a card](https://docs.affirm.com/developers/v1.0-Global-Integration/reference/finalize_card.md)