prepaidCardCustomer flag when you create the
identity:
Managed (prepaidCardCustomer: true) | Default (prepaidCardCustomer: false) | |
|---|---|---|
| Use case | Program funds the card on the user’s behalf | User funds their own card via IBAN |
| Funding | Program master account via Load / Unload | User’s assigned IBAN |
Who calls what
Step 1 — Create the user
Provision the identity and its application with one call toPOST /identity. prepaidCardCustomer here selects the funding model for
the rest of the flow.
applicationId. The full field reference (including which fields each
variant requires) is on the Provision an identity page.
Step 2 — The user onboards (Customer API)
Everything from here until the card is the user acting with their own token on the Customer API. Hand the user their credentials; they sign in (and set up 2FA/passkey on first login), then move through onboarding:- Accept legal agreements —
POST /v1/applications/{applicationId}/agreements/legal/accept - KYC — fetch the schema (
GET /v1/applications/{applicationId}/kyc/schema) and submit answers (POST /v1/applications/{applicationId}/kyc) - Identity verification (Sumsub) — get a token (
GET /v1/applications/{applicationId}/webtoken/sumsub) and run the SDK - Poll
GET /v1/applicationsuntil onboarding completes
You don’t need to poll yourself: your program receives a webhook when the
application is approved.
Step 3 — Order the card
Once approved, the application carries thecustomerId, and the user’s primary account is
created automatically (read its accountId). Order the card:
POST …/cards/v2 with the right card claims) — see
Card operations.
Step 4 — Fund the card
- Managed (prepaid)
- Default (IBAN)
Load funds onto the card from the program master account:Use
"action": "UNLOAD" to pull funds back to the master account.Related
Provision an identity
Create an identity and its application with
POST /identity.Card operations
Issue, status, limits, Load/Unload.
User-side walkthrough
The Customer API steps in full.
Webhooks
Get notified when the application is approved.