Skip to main content
An external card (eac_*) is a card from another bank that a user adds on the dashboard. It isn’t a payer card saved at checkout with a Natural merchant. An agent pays with one through browser tokens or agent tokens. To compare it with Natural-issued cards, see External and Natural-issued cards.

Example

GET /external-cards
The object is each element of data; this shows the first one. The field names below are relative to it: attributes.brand is data[].attributes.brand in the response.

Fields

string
required
Resource type. Always externalCard.
string
required
External card ID (eac_*).
object
required
The external card’s details.
object
required
Related resources, each by type and ID.

Statuses

Permissions

Listing external cards needs externalAccounts.read or savedCards.use. An API key gets externalAccounts.read with the wallets.read scope. Removing one needs savedCards.use. Listing them doesn’t let an agent pay with them.

Removing a card

When you remove a customer’s card, Natural emails the customer, if they have an email address, and names your business. A card session already open on the card can’t be approved after that.

Events

This resource sends no webhook events.

Errors

See the error codes these endpoints return.

Sandbox simulations

None.