Overview
Key Concepts
Stored value and the prepaid account
Stored value and the prepaid account
A prepaid card spends from a balance loaded in advance, not from an ongoing deposit relationship. The linked account uses the
PREPAID account type, and the card uses the PREPAID card type — the same card type covers both reloadable and non-reloadable cards.Because the balance is the product, prepaid accounts restrict which payment rails are available and how funds can arrive. Cardholders are not given the account number, which is what keeps unsupported inbound transfers out.Account programs
Account programs
Prepaid accounts carry funding, spend, and rail restrictions that must hold for the life of the account. Those are enforced by an account program — a set of characteristics that stay immutable across the account’s lifecycle, applied at the account template level.Synctera sets up the account program and the matching account template during onboarding, based on whether your product is reloadable or non-reloadable. Account programs use spend controls, rail restrictions, and where applicable bank-enforced KYC requirements.This means almost no setup work on your side: pass the
account_template_id you were given at onboarding, and every account created from it inherits the right behavior. See Account Programs.Funding channels and load limits
Funding channels and load limits
Funding is restricted to methods that do not require the cardholder to know an account number — direct deposit, cash and check deposits, internal transfers, and AFT/OCT.The card networks impose load limits, which differ by type:
For a non-reloadable product, a one-time funding spend control is applied by the account program and cannot be changed at the account level.
Reloadable and Non-Reloadable
This is the decision that shapes everything else about the program.A non-reloadable card cannot be converted to a reloadable one. If a customer qualifies for a reloadable product later, issue a new account and a new card.
How It Differs from a Debit Card
See Debit Card.
What Synctera Configures for You
Prepaid programs need more platform-side setup than debit, and almost all of it happens before you write code.
Prepaid programs must be registered and approved with the card network, and the card art has network-specific requirements. Your Implementation & Onboarding manager handles both.
Prepaid cards require additional configuration for your tenant on Synctera. Work with your Synctera Implementation & Onboarding manager to get set up.
API Flow
Once your account program and template exist, issuing a prepaid card is a short sequence. Thecurl examples assume you have set up baseurl and apikey environment variables. See Base URL and Authentication.
Step 1 — Create the Customer
Collect the customer’s personal information and create the person. See Create a Personal Customer. We refer to the resulting UUID as{CUSTOMER_ID}.
Step 2 — Record Disclosures
Record the customer’s acknowledgement of each required disclosure, one call per disclosure. See Record Disclosure Acceptance.Step 3 — Verify the Customer
Reloadable products require KYC. The customer must reach averification_status of ACCEPTED before the account can be opened. See KYC/KYB Verification.
Non-reloadable products generally do not require KYC, though your sponsor bank may still require document verification. Where KYC is not required, the account program carries the exemption — you do not handle it in your own code.
Where your sponsor bank requires enhanced due diligence, upload it against the customer record. See Enhanced Due Diligence.
Step 4 — Open the Prepaid Account
Create the account from the template you were given at onboarding. That template carries the account program, so the account inherits the correct funding limits, rail restrictions, and spend controls.{ACCOUNT_ID}.
Step 5 — Issue the Card
Issue against the prepaid account with"type": "PREPAID". Virtual and physical cards are both supported.

