Create an account

POST 
/v1/accounts

Opens a stored-value account for a cardholder in one currency.

If a cardholder needs two currencies, they need two separate accounts. The API never converts between currencies automatically.

This is where you set the program. program_id tells us which of your products the account belongs to. Everything connected to the account — its cards, authorizations, and transactions — inherits that program.

If program_id isn't one of your programs, the API returns invalid_parameter. It uses the same response whether the program doesn't exist or simply isn't yours, so the API won't reveal whether another program exists on the platform.

Request

Responses

201

Account created.

400

The request is malformed or contains an unrecognized parameter.

404

cardholder_not_found: no cardholder with that id, or it belongs to another organization. The two are deliberately indistinguishable.

Note which failure this is not. A program_id that is not one of yours is a 400 on the parameter, not a 404 — the program is a field of the request, while the cardholder is a resource the request acts on.

422

Well-formed but fails a business rule.