MERCHANT-ENROLLMENT status

This page lists the possible values returned by the status field in the EnrollmentWorkflow object. These statuses indicate the current state of a merchant onboarding process initiated through CentralPay’s API or user portal.

📌 Status List

Status	Description
API_CALL	The enrollment was initiated via API. The workflow has been created but no validation has occurred yet.
VALIDATION	The onboarding request is currently under validation (e.g., verifying provided data and uploaded documents).
ON_GOING	The process is ongoing. The merchant is expected to provide more information or complete additional steps.
OVERRIDE	CentralPay has overridden a previous decision and resumed processing the enrollment.
REFUSED	The enrollment request has been refused. CentralPay may have detected a regulatory issue, risk, or missing eligibility requirement.
ACCEPTED	The merchant enrollment is complete and validated. The merchant can now use their CentralPay account.

🔁 Status Flow Overview

✅ Standard Status Flow

API_CALL → VALIDATION → ON_GOING → ACCEPTED

This is the default progression for a successful enrollment:

• API_CALL – The enrollment has been created via API. No validation has started yet.
• VALIDATION – CentralPay is verifying the submitted information and documents.
• ON_GOING – The merchant is expected to provide additional data or complete onboarding steps.
• ACCEPTED – The enrollment has been approved. The merchant can now use their CentralPay account.

❌ Alternative Flow – Rejection

API_CALL → VALIDATION → REFUSED

or

API_CALL → VALIDATION → ON_GOING → REFUSED

The enrollment is rejected during the process, either early on or after attempted completion. Common reasons include:

• Invalid or non-compliant documents
• Ineligible merchant activity
• Excessive financial or regulatory risk

🔁 Manual Override After Refusal

REFUSED → OVERRIDE → VALIDATION / ON_GOING

If new or corrected information is provided, a CentralPay operator may resume the process after an initial refusal.

The OVERRIDE status indicates that a manual decision has been made to re-open the enrollment flow.

💬 Notes

• An Agent or DME may retrieve the enrollment status via API to track progress.
• CentralPay sends webhooks to the configured endpoint when the enrollment status changes (e.g., ACCEPTED, REFUSED).
• Once the enrollment is ACCEPTED, the merchant’s profile becomes active, and their account is ready for use.