CSL Pay Developers

Response Codes

Every transaction response carries a code describing the outcome. It is separate from the HTTP status: a request can return 200 OK and still report a transaction that is pending or has failed. Branch on this code, never on the HTTP status alone.

The code is returned as responseCode in the body, with responseMessage carrying the human-readable text.

Codes that are not final also arrive by webhook when the outcome settles, so you do not have to poll. See Webhooks for the delivery format.

Transaction Resubmission Control

For any pending, system-error or reversal-pending response, do not initiate another payout using a new reference until CSL confirms the final status of the original transaction. This control prevents duplicate beneficiary credits and financial loss.

Success

Final. The operation completed.

PAID

Settled

The bank has confirmed that the beneficiary has been credited successfully.

Where the money isThe wallet debit is final.

What to doNone. The operation completed and is final.

Pending

Not final. Poll or wait for a webhook.

AWAITING RESPONSE FROM BANK

Debited or in transit

The transaction has been submitted, but the recipient bank has not returned a final response.

Where the money isFunds remain committed while the outcome is being determi

What to doCSL performs automated requery and monitors for a webhook or final bank response. The partner must not resend.

PROCESSING

What to doRequery with the transaction id for a final status, or wait for the webhook.

Action Required

Stalled until someone intervenes.

FLAGGED TRANSACTION

What to doThe fraud system has held the transaction — usually a payout limit or a blacklisted account. Approve or decline it in the portal.

Failed

Final. The operation will not complete.

FAILED

Reversal pending or reversed

The transaction reached a final unsuccessful state and will not be completed.

Where the money isAny debit is returned to the wallet.

What to doThe transaction will not complete. Check responseMessage for the reason before retrying with a new reference.

Fund Position Definitions

What each fund position means for the wallet balance.

Fund positionDefinition
No debit Neither the wallet ledger balance nor the available balance is reduced.
Held The available balance is reduced, but the ledger balance is unchanged. The funds are reserved for this transaction.
Debited or in transit The wallet has been debited, but beneficiary credit is not yet confirmed.
Settled The debit is final and the beneficiary has been credited.
Reversal pending The transaction failed and the debit is expected to return to the wallet.
Reversed The debit has been returned to the wallet.
Unresolved The outcome is unknown pending verification and reconciliation.

Status Classification

How each code is classified for reporting and reconciliation.

ClassificationResponse codes
Successful and final 00
Pending or non-final 01, 02, 10 and 60
Rejected before debit 20
Reversal or failure 40, 50, 51, 80 and 90