Issue Virtual Cards

post

https://api.dev.givecard.dev/api/v1/cards/issueVirtual

Creates and delivers virtual cards to the given email addresses. This endpoint returns the count and external IDs of cards ordered, and the card order.
Optionally pass in an amount to load funds onto the card upon order.
Optionally pass in spend rule ID(s) to apply spend rule(s) to the cards upon order. To create a spend rule and limit where and how cardholders can use funds, refer to Create Spend Rule.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

amount

string

applyActivationDefault

boolean

ApplyActivationDefault controls whether the business's default activation profile (if one is configured) is applied to the cards in this batch. Defaults to true. Set to false to skip the default profile and issue cards without custom activation, even when the business has a default configured.

async

boolean

Set async to true to issue the card asynchronously

cardMetadata

array of objects

cardMetadata

emailAddresses

array of strings

required

The email address(es) that cards will be sent to. An email address can only have one card sent to it. Maximum of 300 cards per order.

emailAddresses*

merchantRuleId

string

Deprecated: please use spend rule ids param instead.

programId

string

Program ID is only required for superbusinesses.

spendRuleIds

array of objects

Passing in a spend rule id(s) applies spend rule(s) to a card upon order. To create a spend rule and limit where cardholders can use funds, refer to Create Spend Rule.

spendRuleIds

verificationData

array of arrays of objects

VerificationData is the actual verification data (for example DOB, email, ZIP code) that the cardholder will need to submit during the activation flow. This is required when the business has a default activation profile and ApplyActivationDefault is true. Provide one set of values per card, or provide a single set to apply the same values to every email address in the batch.

verificationData

Headers

Idempotency-Key

string

Responses

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

*/*

200

400

404

409

500