Skip to main content
Onboarding statuses track the lifecycle of recipient (submerchant) registration with providers for split payments. Each recipient must complete onboarding before they can receive funds through marketplace splits.
Onboarding statuses are distinct from payment statuses. They track the credential verification and provider registration process for marketplace recipients.

Status Values

CREATED
string
Initial record created; validation hasn’t started. Ensure data and documents are provided or await review.
PENDING
string
Under review by Yuno and/or the provider. No action needed. Wait for the review to complete.
PENDING_ADDITIONAL_DOCUMENTATION
string
More documentation or clarifications are required. Upload the requested documents and resubmit.
PENDING_RECIPIENT_ACTION
string
The recipient must complete additional steps such as accepting terms, completing KYC, or identity verification. Use Continue Onboarding after the recipient completes the required actions.
SUCCEEDED
string
Onboarding completed successfully. The recipient is ready to receive split payouts.
FAILED
string
Processing failed; the onboarding was not approved. Review the failure reason and retry or create a new onboarding.
DECLINED
string
The provider reviewed and declined the onboarding. Update the recipient’s information or documentation, then create a new onboarding.
BLOCKED
string
Temporarily blocked due to risk, compliance policy, or manual review. Use Unblock Onboarding to restore, or contact support.
REJECTED
string
Pre-submission validation failed before reaching the provider. Fix the identified issues and retry.
ERROR
string
Transient processing error (e.g., timeout or connectivity issue). Retry the operation; contact support if the issue persists.
CANCELLED
string
Onboarding was cancelled by the merchant, recipient, or automatically. Create a new onboarding when ready to proceed.
EXPIRED
string
The onboarding was not completed within the allowed time window. Restart by creating a new onboarding.

Lifecycle Phases

PhaseStatusesDescription
InitialCREATEDRecord created, validation pending
In ReviewPENDING, PENDING_ADDITIONAL_DOCUMENTATION, PENDING_RECIPIENT_ACTIONUnder review or awaiting action
SuccessSUCCEEDEDRecipient is ready for split payouts
FailureFAILED, DECLINED, REJECTEDOnboarding not approved
BlockedBLOCKEDTemporarily suspended
TerminalCANCELLED, EXPIRED, ERRORProcess ended without completion