Onboarding your merchants from Backoffice
Once again, go to Settings → Sellers. Here, you will find a new button Add new Seller .- Fill out preliminary info about your merchant.
- Company
- Individual
When onboarding a company you will need to provide the country, organization number, currency and seller id.

- Once filled out, press Continue and you will get a link to send to your merchant.

Onboarding your merchants through the API
- Fill out preliminary info about your merchant.
type field decides which fields you send:
- Company
- Individual
Set
type to company, or leave it out. organization_number and country_code are required.payout_destination_id, payout_reference and bank_accounts are required for both types. The rest of the flow is the same.
- Receive a link to send to your merchant.
rel=contract_url. While the merchant has not yet completed the
declaration form and signed the agreement, the approval has case_status=WAITING_FOR_DECLARATION.
Handing over to your merchant
Now, take this link and send it to your merchant. This link will take your merchant to a similar KYC form to yours. If aform_submitter email was provided when creating the approval, the merchant will be notified via email.
Reminder emails
If the form is not completed (unsigned or undeclared), reminder emails are automatically sent on the following schedule:- 24 hours after the initial notification
- 2 days after
- 1 week after
- 2 weeks after
- 4 weeks after
Seller approval
To know when the Seller is approved, you can create a webhook from Settings → Webhooks → Add webhook and choose approval_payout_destination_update.See webhooks approval_payout_destination_update for
example of data that will be sent to the webhook
case_status=ACTIVE.
You can also poll the
endpoint List seller approvals
to see when the destinations are approved.
Once the seller is approved, you can start creating sessions with splits.
Testing seller approval
In test mode (account IDs prefixed withT), you can skip the declaration form and KYC review:
- Set
payout_destination_descriptiontoAUTO_APPROVE,AUTO_DECLINEorAUTO_WAITING_FOR_SIGNATURE. See Auto-approve sellers. - Use a test bank account number in
bank_accounts. See Test bank accounts.
You can technically create sessions with splits before the sellers being approved, but there is no guarantee that they will be approved.In the case that an unknown or unapproved seller is used, the plattform merchant will have to deal with the matter manually.
