Create a Card for a User

📘

You can place the bearer access_token for a specific user into the Authentication section of this documentation 👉.

Cards can be created directly through the API using this PCI-compliant endpoint.

Cards can also be created through the OAuth Module by selecting the Connect New Debit Card button.

Astra authorizes the card with the issuer before returning it. When the issuer refuses the card, the response is a 400 carrying embedded_error.code of card_authorization_declined, and the same card will be refused again. When no decision was reached about the card, the response is a 429 with card_authorization_throttled or a 503 with card_authorization_unavailable, and the same request can be retried.

Cards on Discover, Diners Club, UnionPay, Maestro and private-label networks, whose card numbers begin with 6, require an enhanced client configuration. A card on one of these networks is rejected with a 403 for clients without it. Please contact customer support if you are interested in accepting them.

For Unit customers, please reference their technical documentation below to learn more about enabling card to card payments. Enabling Card to Card Payments with Unit & Astra

❗️

This resource requires the use of the secure endpoint.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required

The card number the User

string
required

The card security code

string
required

The card expiration date

string
required

The card owner's first name

string
required

The card owner's last name

string
required

The street line 1 of the card billing address

string

The street line 2 of the card billing address

string
required

The city of the card billing address

string
required

The US State of the card billing address

string
required

The zip code of the card billing address

boolean

Set to false for client-issued debit cards. Set to true for externally linked debit cards. Defaults to false if not provided

Responses

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json