# payment\_intent\_payment\_method\_options\_card

From **Stripe API**.

- Type: `object`

## Properties

### `installments`

- Required: false
- Nullable: true

Installment details for this payment (Mexico only).

For more information, see the [installments integration guide](https://stripe.com/docs/payments/installments).

### `network`

- Required: false
- Type: `string`
- Nullable: true
- Allowed values: `"amex"`, `"cartes_bancaires"`, `"diners"`, `"discover"`, `"interac"`, `"jcb"`, `"mastercard"`, `"unionpay"`, `"unknown"`, `"visa"`

Selected network to process this payment intent on. Depends on the available networks of the card attached to the payment intent. Can be only set confirm-time.

### `request_three_d_secure`

- Required: false
- Type: `string`
- Nullable: true
- Allowed values: `"any"`, `"automatic"`, `"challenge_only"`

We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and [other requirements](https://stripe.com/docs/strong-customer-authentication). However, if you wish to request 3D Secure based on logic from your own fraud engine, provide this option. Permitted values include: `automatic` or `any`. If not provided, defaults to `automatic`. Read our guide on [manually requesting 3D Secure](https://stripe.com/docs/payments/3d-secure#manual-three-ds) for more information on how this configuration interacts with Radar and our SCA Engine.

### `setup_future_usage`

- Required: false
- Type: `string`
- Allowed values: `"none"`, `"off_session"`, `"on_session"`

Indicates that you intend to make future payments with this PaymentIntent's payment method.

Providing this parameter will [attach the payment method](https://stripe.com/docs/payments/save-during-payment) to the PaymentIntent's Customer, if present, after the PaymentIntent is confirmed and any required actions from the user are complete. If no Customer was provided, the payment method can still be [attached](https://stripe.com/docs/api/payment_methods/attach) to a Customer after the transaction completes.

When processing card payments, Stripe also uses `setup_future_usage` to dynamically optimize your payment flow and comply with regional legislation and network rules, such as [SCA](https://stripe.com/docs/strong-customer-authentication).

## JSON Schema

```json
{"properties":{"installments":{"anyOf":[{"$ref":"#/components/schemas/payment_method_options_card_installments"}],"description":"Installment details for this payment (Mexico only).\n\nFor more information, see the [installments integration guide](https://stripe.com/docs/payments/installments).","nullable":true},"network":{"description":"Selected network to process this payment intent on. Depends on the available networks of the card attached to the payment intent. Can be only set confirm-time.","enum":["amex","cartes_bancaires","diners","discover","interac","jcb","mastercard","unionpay","unknown","visa"],"nullable":true,"type":"string"},"request_three_d_secure":{"description":"We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and [other requirements](https://stripe.com/docs/strong-customer-authentication). However, if you wish to request 3D Secure based on logic from your own fraud engine, provide this option. Permitted values include: `automatic` or `any`. If not provided, defaults to `automatic`. Read our guide on [manually requesting 3D Secure](https://stripe.com/docs/payments/3d-secure#manual-three-ds) for more information on how this configuration interacts with Radar and our SCA Engine.","enum":["any","automatic","challenge_only"],"nullable":true,"type":"string"},"setup_future_usage":{"description":"Indicates that you intend to make future payments with this PaymentIntent's payment method.\n\nProviding this parameter will [attach the payment method](https://stripe.com/docs/payments/save-during-payment) to the PaymentIntent's Customer, if present, after the PaymentIntent is confirmed and any required actions from the user are complete. If no Customer was provided, the payment method can still be [attached](https://stripe.com/docs/api/payment_methods/attach) to a Customer after the transaction completes.\n\nWhen processing card payments, Stripe also uses `setup_future_usage` to dynamically optimize your payment flow and comply with regional legislation and network rules, such as [SCA](https://stripe.com/docs/strong-customer-authentication).","enum":["none","off_session","on_session"],"type":"string"}},"title":"payment_intent_payment_method_options_card","type":"object","x-expandableFields":["installments"]}
```