> ## Documentation Index
> Fetch the complete documentation index at: https://www.zinc.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Payment Method

> Payment method object structure and attributes

## Payment Method Object

```json Example Payment Object theme={null}
{
  "name_on_card": "Ben Bitdiddle",
  "number": "5555555555554444",
  "security_code": "123",
  "expiration_month": 1,
  "expiration_year": 2015,
  "use_gift": false
}
```

The recommended way to pay for purchases on a retailer is by using gift card balance already applied to an account. Gift cards are supported on amazon, amazon\_uk, amazon\_ca, and walmart. To use the existing gift balance on the account, simply pass `{"use_gift": true}` as the payment method object.

To use a credit card, you must include the `name_on_card`, `number`, `security_code`, `expiration_month`, and `expiration_year` fields. For Amazon, you should only have a single credit card associated with an account which should be the same as the card passed in the payment method object. This allows the system to correctly answer any payment-related security questions.

## Attributes

| Attribute                      | Type    | Description                                                                                                                                                                                        |
| :----------------------------- | :------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `name_on_card`                 | String  | The full name on the credit/debit card                                                                                                                                                             |
| `number`                       | String  | The credit/debit card number                                                                                                                                                                       |
| `security_code`                | String  | The card verification value on the back of the credit/debit card                                                                                                                                   |
| `expiration_month`             | Number  | The month of the expiration of the card (e.g. January is 1, February is 2)                                                                                                                         |
| `expiration_year`              | Number  | The year of the expiration of the card (e.g. 2016)                                                                                                                                                 |
| `use_gift`                     | Boolean | Whether or not to use the gift balance on the retailer account. If true, then the gift balance will be used for payment. Only works for retailers which support gift balance (Amazon and Walmart). |
| `use_gift_first`               | Boolean | If true, uses the gift card balance first and falls back to the credit card for any remaining amount. Requires credit card details to be provided as a fallback. Only applies to Amazon orders.    |
| `use_account_payment_defaults` | Boolean | Overrides all other payment\_method options and uses the default payment configuration on the account. Only applies to Amazon orders.                                                              |
| `email`                        | String  | Email address used for payment verification. Required when the retailer sends a verification code to email during checkout (e.g., Amex card verification).                                         |
| `is_virtual_card`              | Boolean | Whether or not to check the "Virtual or one-time-use" checkbox when adding the card. Only applies to Amazon orders.                                                                                |
| `reuse`                        | Boolean | If true, will skip entering credit card if it is already present and we aren't prompted for it. Only applies to Amazon orders.                                                                     |