Create card

post

https://api.privacy.com/v1/cards

Create a new virtual card.

Body Params

exp_month

string

length between 2 and 2

Two digit (MM) expiry month. If neither exp_month nor exp_year is provided, an expiration date will be generated.

exp_year

string

length between 4 and 4

Four digit (yyyy) expiry year. If neither exp_month nor exp_year is provided, an expiration date will be generated.

funding_token

uuid

The token for the desired FundingAccount to use when making transactions with this card.

memo

string

Friendly name to identify the card.

spend_limit

integer

≥ 0

Amount (in cents) to limit approved authorizations. Transaction requests above the spend limit will be declined.

spend_limit_duration

string

enum

Spend limit duration values:

ANNUALLY - Card will authorize transactions up to spend limit in a calendar year.
FOREVER - Card will authorize only up to spend limit for the entire lifetime of the card.
MONTHLY - Card will authorize transactions up to spend limit for the trailing month. Month is calculated as this calendar date one month prior.
TRANSACTION - Card will authorizate multiple transactions if each individual transaction is under the spend limit.

Allowed:

state

string

enum

Card state values:

OPEN - Card will approve authorizations (if they match card and account parameters).
PAUSED - Card will decline authorizations, but can be resumed at a later time.

Allowed:

type

string

enum

required

Defaults to SINGLE_USE

Card types:

DIGITAL_WALLET - Cards that can be provisioned to a digital wallet like Google Pay or Apple Wallet. A subscription is required to create these cards.
MERCHANT_LOCKED - Card is locked to first merchant that successfully authorizes the card.
SINGLE_USE - Card will close shortly after the first transaction.
UNLOCKED - Card will authorize at any merchant. Creating these cards requires additional privileges.

Allowed:

Responses


User has not been authenticated	Invalid or missing API key
API key is not active	The API key used is no longer active
Could not find API key	The API key provided is not associated with any user
Please provide API key in Authorization header	The Authorization header is not in the request
Please provide API key in the form Authorization: api-key [api-key]	The Authorization header is not formatted properly
Insufficient privileges. Issuing API key required	Write access requires an Issuing API key. Please contact [email protected]
Insufficient privileges to create unlocked cards.	Creating unlocked cards requires an additional privilege


Rate limited, too many requests per second	User has exceeded their per second rate limit
Rate limited, reached daily limit	User has exceeded their daily rate limit
Rate limited, too many keys tried	One IP has queried too many different API keys

200OK