Create a spending card
To use this endpoint from the browser, you’ll need to specify the
/accounts/{accountID}/issued-cards.write scope when generating a token.
POST
/issuing/{accountID}/issued-cards
|
|
Card created.
{
"authorizedUser": {
"firstName": "Jane",
"lastName": "Doe"
},
"brand": "Discover",
"controls": {
"singleUse": false,
"velocityLimits": [
{
"amount": 10000,
"interval": "per-transaction"
}
]
},
"createdOn": "2019-08-24T14:15:22Z",
"expiration": {
"month": "01",
"year": "21"
},
"formFactor": "virtual",
"fundingWalletID": "string",
"issuedCardID": "ec7e1848-dc80-4ab0-8827-dd7fc0737b43",
"lastFourCardNumber": "1234",
"memo": "string",
"state": "active"
}The request was invalid.
No account with the specified accountID was found.
Request was refused due to rate limiting.
Response headers
Retry-After
number
Path parameters
accountID
string
<uuid>
required
ID of the account.
Body
application/json
authorizedUser
object
required
Fields for identifying an authorized individual.
Show child attributes
firstName
string
required
lastName
string
required
birthDate
object
An individual’s birthdate.
Show child attributes
day
integer
required
month
integer
required
year
integer
required
formFactor
string<enum>
required
Specifies the type of spend card to be issued. Presently supports virtual only, providing a digital number without a physical card.
Possible values:
virtual
fundingWalletID
string
required
controls
object
Show child attributes
singleUse
boolean
Indicates if the card is single-use. If true, the card closes after the first authorization.
velocityLimits
array
Sets the spending limit per time interval. Only one limit per interval is supported.
Show child attributes
amount
integer
The maximum amount in cents that can be spent in a given interval.
interval
string<enum>
Specifies the time frame for the velocity limit. Currently supports only per-transaction limits.
Possible values:
per-transaction
expiration
object
The expiration date of the card or token.
Show child attributes
month
string
2 characters
year
string
2 characters
memo
string
Optional descriptive name.
Response
application/json
authorizedUser
object
Fields for identifying an authorized individual.
Show child attributes
firstName
string
lastName
string
brand
string<enum>
The card brand.
Possible values:
American Express,
Discover,
Mastercard,
Visa
controls
object
Show child attributes
singleUse
boolean
Indicates if the card is single-use. If true, the card closes after the first authorization.
velocityLimits
array
Sets the spending limit per time interval. Only one limit per interval is supported.
Show child attributes
amount
integer
The maximum amount in cents that can be spent in a given interval.
interval
string<enum>
Specifies the time frame for the velocity limit. Currently supports only per-transaction limits.
Possible values:
per-transaction
createdOn
string<date-time>
<=24 characters
expiration
object
The expiration date of the card or token.
Show child attributes
month
string
2 characters
year
string
2 characters
formFactor
string<enum>
Specifies the type of spend card to be issued. Presently supports virtual only, providing a digital number without a physical card.
Possible values:
virtual
fundingWalletID
string
Unique identifier for the wallet funding the card.
issuedCardID
string<uuid>
<=36 characters
UUID
lastFourCardNumber
string
memo
string
Optional descriptor for the card.
state
string<enum>
The state represents the operational status of an issued card. A card can only approve incoming authorizations if it is in an active state.
active: The card is operational and approves authorizations. Generally becomes active shortly after card creation.inactive: The card cannot approve authorizations. This is currently a temporary state assigned post-creation during the activation process.closed: The card is permanently deactivated and cannot approve authorizations. A card can be closed by request or when it expires.pending-verification: Awaiting additional authorized user verification before the card can be activated.
Possible values:
active,
inactive,
pending-verification,
closed