# Status flow

### Understanding the refund lifecycle

<figure><img src="/files/u53iVZFeN7bFidE0dUiq" 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="/files/-M9Uq6hh3MZ301JtlBh4" 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="/files/-ME_izqMi9S4uIPsWPjR" 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="/files/-MDQyQCx2cX3EhoAitEv" 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="/files/-M9UsJ4Co_cg-RzJZT6c" alt="" data-size="original"> </td><td>The refund has been manually cancelled. Final status.</td></tr><tr><td align="center"><img src="/files/-MDNZ67x7s7LgmAyG4YI" alt="" data-size="original"> </td><td>The refund has been rejected by the bank. Final status.</td></tr><tr><td align="center"><img src="/files/-M9UsDlL5PDQXBDL5CUD" 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="/spaces/0lbPmhFPUb55BAkK3G6F/pages/wa4sd1C6ifl9kpeokfPO" class="button primary" data-icon="magnifying-glass">Get refund status</a>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://apidocs.onekeypayments.com/guides/deposits/refund-a-deposit/status-flow.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
