Onboarding tracks the lifecycle of recipient (submerchant) registration with providers for split payments. Use the onboarding status to understand where a recipient is in the process and whether any action is required.
See also:
Onboarding statuses
The onboarding flow can have the following statuses.
| Status | Description | Required action |
|---|---|---|
CREATED |
Initial record created; validation hasn’t started (often transitions quickly to PENDING). |
Ensure all required data and documents are provided; otherwise wait for review to start. |
PENDING |
Under review by Yuno and/or the provider. | No action required. |
PENDING_ADDITIONAL_DOCUMENTATION |
More documentation or clarifications required. | Upload the requested documents and resubmit. |
PENDING_RECIPIENT_ACTION |
Recipient must complete steps (e.g., accept terms, KYC, verification). | Complete the pending step(s) and continue. |
SUCCEEDED |
Onboarding completed successfully; recipient is ready for split payouts. | Start using the recipient in splits/payouts. |
FAILED |
Processing failed; the onboarding was not approved. | Review the reason and retry or create a new onboarding after fixing issues. |
DECLINED |
Provider reviewed and declined the onboarding. | Update information or documentation, then create a new onboarding. |
BLOCKED |
Temporarily blocked due to risk/compliance policy or review. | Unblock via the corresponding endpoint or contact support. |
REJECTED |
Pre-submission validation failed before reaching the provider. | Fix the issues and retry/submit again. |
ERROR |
Transient processing error (e.g., timeout or connectivity). | Retry the operation; contact support if it persists. |
CANCELLED |
Onboarding was cancelled by the merchant/recipient or automatically due to workflow. | Create a new onboarding when ready. |
EXPIRED |
Not completed in time; window expired. | Restart by creating a new onboarding. |