Our API Docs just got a new look!

Status flow

Understanding the refund lifecycle

Status diagram explanation

Status
Description

DECLINED

DECLINED is not a status by itself. It means the refund failed to be created.

PENDING

As soon as the refund request is created, its status will be PENDING.

INCORRECT_DETAILS

In case we need more information to complete the request or any of the details were incorrect, we will change the status to INCORRECT_DETAILS and you will need to provide the correct details. Once the details have been provided, its status will be PENDING again.

CANCELLED

The status CANCELLED means the refund was manually cancelled by you. Only refunds in PENDING or INCORRECT_DETAILS can be cancelled. Final status.

DELIVERED

If everything is fine we will send the refund for processing and the status will be marked as DELIVERED. It can't be cancelled at this point.

REJECTED

As soon as the processor/bank confirms the refund, it will be marked as COMPLETED or REJECTED (by the bank)*

COMPLETED

As soon as the processor/bank confirms the refund, it will be marked as COMPLETED or REJECTED (by the bank) *

* There are some corner cases in which the receiver's bank tell us that the refund was completed but days after it gets rejected. In those cases the status changes from COMPLETED to REJECTED.

Refunds Status Codes

Status
Description

The refund is created and is pending to be processed. It can still be cancelled.

The refund is pending for you to provide more information. It can still be cancelled.

The refund has been sent to the bank for processing. It can't be cancelled anymore.

The refund has been manually cancelled. Final status.

The refund has been rejected by the bank. Final status.

The refund has been completed. Final status.

For technical details regarding refunds status retrieval, please visit the API Reference Get refund status

Last updated

Was this helpful?