Who calls what
Step 1 — Invite the user
Invite the customer with one call toPOST /v1/access-management/invite/customer. It creates the user
and their application, and Orenda emails the invitee a temporary password. The invite
body selects the funding model for the rest of the flow.
- Managed (prepaid)
- Default (IBAN)
Set the sub-role flag and the funding
accountId — the program account the invitee
draws against:applicationId.
Service users are exempt from the step-up; an
operator must send a
confirmation (passkey or TOTP) or the call returns
422 SCA_MISSING. Which invitee details are required depends on the role — send what you
have, and a 400 names any field that’s missing. Full field reference:
Invite a customer.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. The invitee signs in with the temporary password from the invite email (changing it and setting up 2FA/passkey on first login), then moves 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) — 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
Invite a customer
Create the user and their application with one invite call.
Card operations
Issue, status, limits, Load/Unload.
User-side walkthrough
The Customer API steps in full.
Webhooks
Get notified when the application is approved.