Sign in

Payments

Transaction statuses

View as Markdown

In a nutshell

What each Paystack transaction status means and how to handle it in your integration.

A transaction status tells you where a payment attempt ended up, but not every status should trigger the same business action. In practice, your integration should treat status handling as a decision layer: some statuses mean you should wait, some mean you should prompt the customer to try again, and only one means you should fulfill the transaction.

StatusMeaningAction to take
successThe payment was completed successfully.Deliver value, mark the payment as paid, and store the confirmed record.
failedThe payment attempt did not succeed. Check data.gateway_response for the reason.Do not fulfill. Show the customer an error or offer another payment attempt.
abandonedThe customer left the flow or never completed the required action.Do not fulfill. Let the customer restart the payment if needed.
ongoingThe customer is in the middle of completing an action, such as entering an OTP or making a transfer.Wait for a webhook or verify again later.
pendingThe transaction is still being processed, common with channels like bank transfer or USSD.Keep monitoring; do not deliver value yet.
processingSame as pending, for Direct Debit transactions.Keep monitoring; do not deliver value yet.
queuedThe transaction is queued for batch processing. This applies to bulk charges only.Wait for a later status update before taking any fulfillment action.
timeoutReturned by the Charge API when a charge attempt fails.Do not fulfill. Show data.message to the customer and start a new charge if they want to retry.
reversedA completed payment was returned, refunded, or charged back.Reconcile your records and reverse the value you delivered if your business flow requires it.

Only success means you should deliver value. A customer reaching a callback URL, seeing a pending screen, or starting a transfer is not enough on its own. abandoned usually means the customer exited the flow without paying, while pending means the customer may still complete the payment through an asynchronous channel.

When you verify a transaction, check both status and amount. A successful status confirms that money moved, but the amount confirms that the customer paid the exact value your system expects to receive.

Was this page helpful?