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

# Introduction to card transfers (debit and credit cards)

> Let users fund accounts and cash out with debit or credit cards, in currencies such as EUR, GBP and USD. Covers card linking, 3DS authorization, and card limits.

Allow users to fund or cash out with their debit/credit cards, globally, in currencies such as EUR, GBP and USD.

## Key concepts

* **External account lifecycle** — when a card is added, its status starts as `processing` and transitions to `ok` once validated, or `failed` if the card is invalid or declined. If using the Payment Widget, card-linking specific errors (duplicates, country mismatch, card limits) are handled internally.
* **3DS authorization** — when the transaction response includes a `confirmationUrl` on the card node, 3DS needs to be fulfilled. Either handle the redirect in your app or use the Payment Widget to manage the authorization flow.
* **Card limits** — users may be subject to active card limits and unique card limits. These are enforced as capability restrictions.
* **Card data and PCI DSS** — linking a card through the REST API sends the full card number and security code through your systems, which requires your organization to be PCI DSS compliant. If it isn't, link cards through the Payment Widget, which collects the card details itself, with its [Transaction - Select Deposit Origin](https://developer.uphold.com/developer-guides/card-transfers/deposit/via-payment-widget/select-deposit-origin.md) or [Transaction - Select Withdrawal Destination](https://developer.uphold.com/developer-guides/card-transfers/withdrawal/via-payment-widget/select-withdrawal-destination.md) flow.

## Testing in sandbox

Use [Test cards](https://developer.uphold.com/rest-apis/core-api/accounts/test-helpers/fund-sandbox-accounts.md#test-cards) to simulate card deposits and withdrawals in the Sandbox environment. The table lists card numbers by network, type, and country, along with reserved amounts that trigger specific error responses.

## Start building

> [card] [Deposit via API](https://developer.uphold.com/developer-guides/card-transfers/deposit/via-rest-api.md)
>
> Set up card deposits and handle 3DS authentication programmatically.

> [card] [Withdrawal via API](https://developer.uphold.com/developer-guides/card-transfers/withdrawal/via-rest-api.md)
>
> Create quotes and submit payouts to your users' cards.

> [card] [Deposit via Widget (End-to-end)](https://developer.uphold.com/developer-guides/card-transfers/deposit/via-payment-widget/end-to-end.md)
>
> Recommended. Support card deposits in a single widget session — account selection through transaction confirmation status.

> [card] [Withdrawal via Widget (End-to-end)](https://developer.uphold.com/developer-guides/card-transfers/withdrawal/via-payment-widget/end-to-end.md)
>
> Recommended. Send card withdrawals in a single widget session — account selection through transaction confirmation status.

> [card] [Deposit via Widget (Transaction - Select Deposit Origin)](https://developer.uphold.com/developer-guides/card-transfers/deposit/via-payment-widget/select-deposit-origin.md)
>
> Let users add or pick a card, then build the amount and review screens, create the quote and authorize the transaction yourself.

> [card] [Withdrawal via Widget (Transaction - Select Withdrawal Destination)](https://developer.uphold.com/developer-guides/card-transfers/withdrawal/via-payment-widget/select-withdrawal-destination.md)
>
> Let users pick a card, then build the amount and review screens, create the quote and transaction yourself via the REST API.
