Skip to content

KYC / KYB status

TL;DR - Customers move through created → verifying → verified → active on the happy path. Magma does not collect documents; that happens on the upstream provider's hosted flow. You watch the status in the customers list and act when something needs intervention.

The lifecycle

                  ┌──────────────────────► rejected
created ► verifying ► verified ► active
                  └──► review ◄──── suspended

State-by-state

created

The customer record exists. The upstream KYC / KYB link has been emailed. Nothing has happened yet on the verification side.

What you can do: view the customer, edit fee markups, re-share the KYC link if the customer says they didn't get it. The link is visible on the customer detail page inside an amber "Customer verification pending" notice - click to open it in a new tab, or use the copy button next to it to paste it into your own message.

What you cannot do: send any payouts or top up.

verifying

The customer has clicked the link and started filling in documents on the provider's hosted flow. The provider holds the data; Magma only sees the status update.

What you can do: wait. The same "Customer verification pending" notice with the KYC link stays on the customer detail page so you can re-share it if the customer gets stuck.

What you cannot do: send any payouts or top up.

verified

The provider has approved the verification. Magma is in the process of provisioning the virtual account.

What you can do: wait - provisioning is usually under a minute.

active

The customer is fully onboarded and the virtual account is live. This is the terminal happy state.

What you can do: everything - top up, configure recipients, send fiat and crypto-to-fiat payouts.

rejected

The provider has declined verification. The customer cannot transact.

What you can do: contact your Magma success channel; reasons for rejection are not exposed in the dashboard.

review

A compliance flag has been raised - usually post-active, often after a suspicious transaction. Activity is paused while a human reviews.

What you can do: payouts and top-ups are blocked while in review. Contact your Magma success channel for status.

suspended

Magma or compliance has suspended the customer. All activity is blocked.

Where status appears

  • Customers list - status badge on every row.
  • Customer dashboard - large status pill at the top of the page.
  • KYC link notice - while the customer is in created or verifying, the customer detail page shows an amber "Customer verification pending" notice with the KYC link (clickable + copyable). It disappears once verification completes.
  • Top-up modal - only customers in verified or active appear in the picker.
  • Payout modal - only customers in active appear in the picker.

Why Magma doesn't collect documents

Verification is delegated to the upstream provider so that you (and we) never store sensitive identity documents. The link the customer receives points to the provider's hosted flow; everything stays there. Magma only records the status transitions. If you need a copy of submitted documents, ask your Magma contact.

What's next