The three levels
The level of a customer is returned as
verification_level on every customer object.
Level 1 is based on the information you declare for your customer. It is not a document verification: that is what level 2 adds.
Moving up
- Level 1 → Level 2: request a verification link for your customer and let them complete it. See KYC flow.
- Level 2 → Level 3: send the proof of address document. See POA flow.
kyc.* and poa.* events).
Moving down
A level describes verified information. When that information changes, the verification no longer covers it, and the customer is moved down automatically:
Sending the same value again does not change the level.
What each level allows
Cards
A customer can receive a card from level 1 (basic), before their KYC is approved, within limits. Approving the KYC (level 2) lifts these limits. A product can require a higher level. Each card product states the level it requires, and its limits for each level. Read them on the product, from GET /cards/products:
For cards, level 3 has the same limits as level 2.
Creating a card is refused when the customer is below the product’s required level, or when they already hold the maximum number of cards allowed at their level.
Level 1 customers
A level 1 (basic) customer can receive cards within these limits:
Beyond a limit, creating or topping up a card returns
422 VALIDATION_ERROR with details.kyc_required: true and details.limit (load_per_customer_per_month or load_per_card_30_days), plus max, remaining and, for the monthly limit, used and resets_at. As soon as the customer reaches level 2 (verified), these limits no longer apply.
A card for a level 1 customer is issued under your verified identity: the name on your identity document and your account email (cardholder: partner on the card). Your own identity and proof of address verification must be approved. As soon as the customer reaches level 2, their new cards are issued in their own name (cardholder: customer); cards already issued keep their holder.
You are responsible for the cards you issue to level 1 customers: the data you submit must be accurate and belong to the actual user of the card.
Example
Minimum level by product
Level and status are two different things
The KYC level says how well a customer is known. Thestatus says whether the customer can be used at all:
A customer must be
active to receive a card, whatever their level.