Key concepts
- External account lifecycle — when a card is added, its status starts as
processingand transitions tookonce validated, orfailedif 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
confirmationUrlon 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 or Transaction - Select Withdrawal Destination flow.
Testing in sandbox
Use 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
Deposit via API
Set up card deposits and handle 3DS authentication programmatically.
Withdrawal via API
Create quotes and submit payouts to your users’ cards.
Deposit via Widget (End-to-end)
Recommended. Support card deposits in a single widget session — account selection through transaction confirmation status.
Withdrawal via Widget (End-to-end)
Recommended. Send card withdrawals in a single widget session — account selection through transaction confirmation status.
Deposit via Widget (Transaction - Select Deposit Origin)
Let users add or pick a card, then build the amount and review screens, create the quote and authorize the transaction yourself.
Withdrawal via Widget (Transaction - Select Withdrawal Destination)
Let users pick a card, then build the amount and review screens, create the quote and transaction yourself via the REST API.