Skip to content

What is needed to start and to withdraw?

No NINEA or RCCM to create an account and collect with 221 Pay. An identity document is required only before the first payout. Requirements and errors.

To start and collect, an account is enough: 221 Pay asks for neither a NINEA nor an RCCM. Identity verification, on a single document (national ID card or passport), is required only before a payout and before registering a payout number. Individuals, freelancers and companies are accepted.

What is required, step by step

StepRequirement
Create an account and a projectNo document.
Create API keysNo document.
Test modeNo document, no real money (Testing).
Enable live mode and collectNo document. A project administrator explicitly confirms the activation (Authentication).
Create a payment linkNo document.
Refund a customerNo identity verification (Refunds).
Register a payout numberIdentity verified, then a code received by email before the first payout.
Withdraw the balanceIdentity verified.

Verify identity

Verification covers one identity document (national ID card or passport), photographed in the dashboard, Identity verification section. 221 reviews the file within five business days of submission (review_eta in GET /v1/kyc/status); the result appears in the same section.

The state is read through the API:

Terminal
curl "$API_URL/v1/kyc/status" -H "Authorization: Bearer $API_KEY"
statusMeaning
not_startedNo verification started.
pendingFile under review.
verifiedIdentity verified: payouts allowed.
rejectedFile rejected; reason_code gives the reason.
StatuscodeCause
403KYC_REQUIREDPayout or payout number before identity verification. The kyc_status field gives the state.
409KYC_ALREADY_SUBMITTEDVerification already submitted for review: follow GET /v1/kyc/status.
409DESTINATION_NOT_VERIFIEDPayout number not verified by the code received by email.

Full table: Errors. Payout steps: Payouts.

Going further

Last updated on