TRANSFER status

This page lists and describes the status values associated with the Transfer object. These statuses reflect the progression of a fund transfer operation created via the /transfer endpoint in CentralPay’s API.

Status values

Status	Description
CREATED	The transfer has been successfully created and registered. It has not yet been executed.
SCHEDULED	The transfer is scheduled for automatic execution at a defined date/time.
PENDING	The transfer is being processed. Execution is in progress but not yet finalized.
CANCELLED	The transfer was cancelled before execution. No movement of funds occurred.
PROCESSED	The transfer was processed by CentralPay. Funds have been deducted from the source wallet.
DONE	The transfer was successfully completed and the funds have been credited to the target account or wallet.
FAILED	The transfer could not be executed due to an error. No debit occurred or the operation was reversed.
REVERSED	The transfer was previously executed but has since been reversed. Funds were returned to the source wallet.

Status lifecycle

✅ Standard flow

CREATED → SCHEDULED → PENDING → PROCESSED → DONE

This is the typical status flow when the transfer is executed successfully.

⚠️ Alternative flow (error or cancellation)

CREATED → CANCELLED

If the transfer is cancelled before execution.

CREATED → SCHEDULED → PENDING → FAILED

If the transfer encounters an error during processing (e.g., insufficient funds, invalid wallet, technical issue).

DONE → REVERSED

If the transfer was previously executed but later reversed (e.g., manual operation or compliance reversal).

Notes

• Only CREATED or SCHEDULED transfers may be cancelled manually.
• A FAILED status usually indicates validation errors (e.g. insufficient funds, inactive wallet, invalid beneficiary).
• The REVERSED status applies when a reversal is triggered using the /transferReversal endpoint.
• Status fields are returned in the status property of the Transfer JSON object and may be monitored using the API or relevant webhooks.