Skip to main content
Every customer has a KYC level. It tells you how much has been collected and verified about that person, and it sets the limits that apply to them. A customer is never anonymous: the first level is reached as soon as the customer is created, because the identity fields are all required.

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.
Levels cannot be skipped: a proof of address is refused until the customer’s KYC is approved. You are notified of every change by webhook (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

With this product, a level 1 customer can hold 3 cards, each receiving at most 1,000 USD over 30 days, within 5,000 USD loaded per month in total. At level 2 or 3, the customer can hold an unlimited number of cards and spend up to 1,000,000 USD per month. The values above are an example: always read the limits on the product itself.

Minimum level by product

Level and status are two different things

The KYC level says how well a customer is known. The status says whether the customer can be used at all: A customer must be active to receive a card, whatever their level.