Bulk Operations

Our Bulk Virtual Card API provides a powerful and efficient way to create and manage a large number of virtual cards programmatically. This feature is designed for scalability, allowing you to automate card issuance for various business needs.

The process is designed to be asynchronous, meaning you first submit a creation request and then check its status to retrieve the card details once they are ready.

The Bulk Order Workflow ⚙️

The entire process involves two main steps: submitting the order and then checking its status.

Step 1: Create a Bulk Order

You begin by sending a createVirtualCardBulkOrder mutation. This request contains all the specifications for the cards you need, including quantity, spend limits, and funding sources for different batches. The API will immediately acknowledge your request and provide a unique orderId. This orderId is the key to tracking your order.

Step 2: Check the Order Status

Because processing a large number of cards can take time, you will periodically use the getVirtualCardBulkOrderStatus query with the orderId you received in Step 1. You can poll this endpoint until the orderStatus field changes to COMPLETED or FAILED.

Step 3: Retrieve Card Details

Once the order status is COMPLETED, the response from the getVirtualCardBulkOrderStatus query will contain the full details for all successfully created cards, including the card number, CVV, and expiration date. You can then securely store and distribute these card details as needed.

Authentication 🔐

All requests to the Bulk Virtual Card API must be authenticated. You need to include an Authorization header with your valid bearer token in every request.

Header Example: Authorization: Bearer YOUR_USER_ACCESS_TOKEN

API Guides 📖

For detailed information on how to use each endpoint, please refer to the subpages below.

• Create Virtual Cards in Bulk
  • Use this mutation to submit a new bulk order for creating multiple virtual cards with different configurations in a single API call.
• Get Virtual Card Bulk Order Status
  • Use this query to check the status of a previously submitted order and retrieve the full card details upon successful completion.