# Status flow

### Understanding the refund lifecycle

<figure><img src="https://2745084985-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNmmYRmGEpduaZ8YTyKQQ%2Fuploads%2F9yByXVQ2mEzZVth4FSK1%2FRefund%20status%20flow.png?alt=media&#x26;token=8fe58b58-331b-4452-862e-b1b4f3b66365" alt=""><figcaption></figcaption></figure>

#### Status diagram explanation

<table><thead><tr><th width="197.921875" align="center">Status</th><th>Description</th></tr></thead><tbody><tr><td align="center"><strong>DECLINED</strong></td><td><strong>DECLINED</strong> is not a status by itself. It means the refund failed to be created.</td></tr><tr><td align="center"><strong>PENDING</strong></td><td>As soon as the refund request is created, its status will be PENDING.</td></tr><tr><td align="center"><strong>INCORRECT_DETAILS</strong></td><td>In case we need more information to complete the request or any of the details were incorrect, we will change the status to <strong>INCORRECT_DETAILS</strong> and you will need to provide the correct details. Once the details have been provided, its status will be <strong>PENDING</strong> again.</td></tr><tr><td align="center"><strong>CANCELLED</strong></td><td>The status <strong>CANCELLED</strong> means the refund was manually cancelled by you. Only refunds in PENDING or INCORRECT_DETAILS can be cancelled.<br><strong>Final status.</strong></td></tr><tr><td align="center"><strong>DELIVERED</strong></td><td>If everything is fine we will send the refund for processing and the status will be marked as <strong>DELIVERED</strong>. It can't be cancelled at this point.</td></tr><tr><td align="center"><strong>REJECTED</strong></td><td>As soon as the processor/bank confirms the refund, it will be marked as COMPLETED or <strong>REJECTED</strong> (by the bank)<mark style="color:red;"><strong>*</strong></mark></td></tr><tr><td align="center"><strong>COMPLETED</strong></td><td>As soon as the processor/bank confirms the refund, it will be marked as <strong>COMPLETED</strong> or REJECTED (by the bank) <mark style="color:red;"><strong>*</strong></mark></td></tr></tbody></table>

&#x20; <mark style="color:red;">**\***</mark> 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

<table><thead><tr><th width="193.08203125" align="center">Status</th><th>Description</th></tr></thead><tbody><tr><td align="center"><img src="https://content.gitbook.com/content/NmmYRmGEpduaZ8YTyKQQ/blobs/PNwDqyd2SllcEQyk7Ok6/Untitled%20Diagram.svg" alt="" data-size="original"> </td><td>The refund is created and is pending to be processed. It can still be cancelled.</td></tr><tr><td align="center"><img src="https://content.gitbook.com/content/NmmYRmGEpduaZ8YTyKQQ/blobs/zkFyScgpNvDeZTTaUQeq/INCORRECT_DETAILS.svg" alt="" data-size="original"> </td><td>The refund is pending for you to provide more information. It can still be cancelled.</td></tr><tr><td align="center"><img src="https://content.gitbook.com/content/NmmYRmGEpduaZ8YTyKQQ/blobs/Dx9lmztlLgffiuoZscoE/DELIVERED.svg" alt="" data-size="original"> </td><td>The refund has been sent to the bank for processing. It can't be cancelled anymore.</td></tr><tr><td align="center"><img src="https://content.gitbook.com/content/NmmYRmGEpduaZ8YTyKQQ/blobs/Hc8EZYlBjdO3gZV90T5b/CANCELLED.svg" alt="" data-size="original"> </td><td>The refund has been manually cancelled. Final status.</td></tr><tr><td align="center"><img src="https://content.gitbook.com/content/NmmYRmGEpduaZ8YTyKQQ/blobs/JwYOFVV47rZ7BwC2c8gY/REJECTED.svg" alt="" data-size="original"> </td><td>The refund has been rejected by the bank. Final status.</td></tr><tr><td align="center"><img src="https://content.gitbook.com/content/NmmYRmGEpduaZ8YTyKQQ/blobs/T3DjqFAGrli9nfNKuWZv/COMPLETED.svg" alt="" data-size="original"> </td><td>The refund has been completed. Final status.</td></tr></tbody></table>

> For technical details regarding refunds status retrieval, please visit the **API Reference** <a href="https://app.gitbook.com/s/0lbPmhFPUb55BAkK3G6F/deposits-api/manage-refunds/get-refund-status" class="button primary" data-icon="magnifying-glass">Get refund status</a>
