Prepaid Card

The curl examples assume you have set up baseurl and apikey environment variables. See Base URL and Authentication. Identifiers produced by earlier steps are written like {ACCOUNT_ID}.

Step 1 — Decide Reloadable or Non-Reloadable

This choice drives the account type and most of what follows.

	Reloadable	Non-reloadable
Account type	`CHECKING`	`PREPAID`
Funding	Ongoing	Loaded once with a fixed value
Typical use	Allowances, stipends, payroll, serving the underbanked	Gift cards, incentives, rebates
Cardholder KYC	Required	Often not required

Reloadable prepaid programs behave much like debit — see Build a Debit Card Program, which follows the same shape.

Step 2 — Create the Customer

For most prepaid programs, create and verify a customer as normal. See Create a Personal Customer and KYC/KYB Verification. Gift card programs are the exception. A card product with issue_without_kyc enabled issues non-personalized cards without a verified customer. See Personalized and Non-Personalized Cards.

Step 3 — Create the Account

Build an account template with the account type from Step 1 and is_card_enabled set to true, then create the account from it. See Create Accounts. We refer to the resulting account’s UUID as {ACCOUNT_ID}.

Step 4 — Issue the Card

Issue against your prepaid card product with "type": "PREPAID".

curl -X POST "$baseurl/v2/cards" \
  -H "Authorization: Bearer $apikey" \
  -H 'Content-Type: application/json' \
  --data-binary '{
    "type": "PREPAID",
    "card_details": {
      "form": "VIRTUAL",
      "account_id": "{ACCOUNT_ID}",
      "customer_id": "{CUSTOMER_ID}",
      "card_product_id": "{CARD_PRODUCT_ID}"
    }
  }'

See Card Issuance and Management for the full request shape and the physical card variant.

Step 5 — Ship in Bulk, If Applicable

Gift and incentive programs frequently ship cards in bulk to a business for on-site assignment. Cards can be issued against a business without naming a cardholder, then assigned to individuals later with Update Card. See Bulk Card Orders.

Overview

Onboard a Personal Customer

Onboard a Business Customer

Create Accounts

Link External Accounts

Link External Cards

Issue Cards

Move Money

Get Transactions

Dispute Transactions

Platform Tools

Use Cases

Step 1 — Decide Reloadable or Non-Reloadable

Step 2 — Create the Customer

Step 3 — Create the Account

Step 4 — Issue the Card

Step 5 — Ship in Bulk, If Applicable

​Step 1 — Decide Reloadable or Non-Reloadable

​Step 2 — Create the Customer

​Step 3 — Create the Account

​Step 4 — Issue the Card

​Step 5 — Ship in Bulk, If Applicable

Step 1 — Decide Reloadable or Non-Reloadable

Step 2 — Create the Customer

Step 3 — Create the Account

Step 4 — Issue the Card

Step 5 — Ship in Bulk, If Applicable