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

> ## Agent Instructions
> Money is always a decimal string at the currency's precision (for example "29.00"), paired with an ISO 4217 currency field. Never use minor units.
> Build against the sandbox first: base URL https://sandbox-api.bachs.io with sk_sandbox_ keys. Production is https://api.bachs.io with sk_live_ keys; going live is a key swap.
> Treat webhooks (for example collection.succeeded) as the source of truth for fulfilment, never client-side events or redirects.
> Subscriptions are created by completing a checkout for a recurring product. There is no direct create-subscription endpoint.
> IDs carry resource prefixes (cust_, prod_, sub_, chk_, inv_, ref_) and timestamps are ISO 8601 UTC.

# Ask buyers to confirm card payments with 3D Secure

> Ask buyers to confirm international card payments with their bank. Choose how often in All Settings, under Checkouts.

3D Secure is a check run by the buyer's bank. The bank asks the buyer to confirm the payment. It helps reduce fraud, because it gives the buyer a way to show they are the cardholder.

In this guide you choose how often your buyers are asked to confirm international card payments.

## Choose a level

There are three levels. Each one applies to every international card payment on your account.

| Level | What the buyer sees |
| - | - |
| **Only when the bank requires it** (default) | Most buyers see nothing extra. The buyer confirms only when their bank requires it. |
| **When the bank asks** | The buyer confirms with their bank whenever the bank asks for it. |
| **Always** | Every buyer confirms with their bank. This adds one step at checkout. |

**1. Open the Checkouts tab**

In the dashboard sidebar, press **All Settings**, then open the **Checkouts** tab.

![The Settings page with the Checkouts tab selected, beside Personal Details, Account Details, Compliance, Team & Security, Customer Portal, Branding and Payout Destinations](https://mintcdn.com/bachs/uRGJtbYPVtQ92yTi/images/product/settings-checkouts-tab.webp?fit=max\&auto=format\&n=uRGJtbYPVtQ92yTi\&q=85\&s=c1975eb714c49bb23fe36f9c46a026cf)

**2. Find the 3D Secure section**

Find the **3D Secure** section on that tab. It shows when international card payments are on for your account.

**3. Pick a level and save**

Open the **Bank approval (3D Secure)** list, choose a level and press **Save changes**. A message confirms the level you saved. New card payments use it from then on.

![The 3D Secure section with the Bank approval (3D Secure) list open, showing Only when the bank requires it (default), When the bank asks, and Always selected](https://mintcdn.com/bachs/uRGJtbYPVtQ92yTi/images/product/settings-3d-secure.webp?fit=max\&auto=format\&n=uRGJtbYPVtQ92yTi\&q=85\&s=6521c2024c95988a062db655722f1a89)

## When you cannot change the level

Sometimes the list shows fewer levels, or only **Always** with no list at all. The line under the setting says why:

* **"Required for your account right now"**: your account must use the level shown. Every buyer confirms with their bank.
* **"3D Secure is always on for your account"**: Bachs has set this level for your account, and you cannot lower it.
* **"Your account needs at least ..."**: you can choose the level named or a stronger one.

If you think the level on your account is wrong, contact [support@bachs.io](mailto:support@bachs.io).

## What 3D Secure does not cover

* **Disputes.** A buyer can still dispute a payment that passed 3D Secure. Your evidence decides the outcome. See [Handle disputes](https://docs.bachs.io/guides/disputes/overview.md).
* **Payments where the buyer is not present.** Renewals and other charges made on a saved card without the buyer at checkout do not ask the bank again. A saved Apple Pay or Google Pay payment is always charged this way.
* **Some cards.** American Express cards are only checked on payments in USD.
* **Large payments.** A payment of USD 1,000 or more is checked whenever the bank asks, even on the default level. Choose **Always** to check every one.
* **The bank's own decision.** A bank can skip the check or ask for it on any payment, whatever level you choose.

## Next steps

* [Handle disputes](https://docs.bachs.io/guides/disputes/overview.md): what happens to your balance when a dispute opens, and how to respond.
* [Payment statuses](https://docs.bachs.io/guides/payments/statuses.md): a payment waiting for the buyer to confirm with their bank shows as `open` with `awaiting_approval`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.