# Our Status and Flow

When you make a request to our API using the **POST** method, it generates a transaction that is categorized as either a **payment** or a **payout**.

Below, we explain in detail each status that a transaction can have.<br>

{% hint style="info" %}
**Transaction**
{% endhint %}

<figure><img src="/files/BFiPlTZ507qQ9xbpEsG3" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="130">Status</th><th>Description</th></tr></thead><tbody><tr><td>open</td><td>When using the API <strong>/transaction/checkout</strong>, the initial status of the transaction is open. It means that a transaction has been initiated but the requester has not yet assigned a payment method on our page.</td></tr><tr><td>pending</td><td>When using the API <strong>/payment</strong> or <strong>/payout</strong>, the initial status of the transaction is pending. It means that a transaction has been initiated and automatically assigned (as sent in the payload) a payment or payout method.</td></tr><tr><td>paid</td><td>When a transaction is successfully completed and processed, the transaction status is paid.</td></tr><tr><td>canceled</td><td>When a transaction fails for any reason, the transaction status becomes canceled</td></tr></tbody></table>

The types of transactions, also known as **sub-transactions**, work almost like a log of the transaction's evolution. Below is a brief description of each status and a flowchart of the evolution of the statuses.<br>

{% hint style="info" %}
**Payment**
{% endhint %}

<figure><img src="/files/XxxNKZ9H8ITEKJz8HfrN" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="141">Status</th><th>Description</th></tr></thead><tbody><tr><td>pending</td><td>All payment-type transactions have the pending status as the <strong>initial status</strong>.</td></tr><tr><td>paid</td><td>When a payment is successfully completed and processed, the transaction status is paid.</td></tr><tr><td>denied</td><td>When a payment does not meet our <strong>payment policies</strong>, it is denied, and therefore our status becomes denied.</td></tr><tr><td>expired</td><td>Whenever a payment order is opened, it has a <strong>period for payment</strong>. When the period is reached, the order expires, making it no longer possible to pay.</td></tr><tr><td>chargeback</td><td>Whenever a payment order is <strong>paid</strong>, then the customer <strong>requests a chargeback</strong> in their bank, this status symbolizes that the value of this transactions is no longer available</td></tr><tr><td>blocked</td><td><p>This status symbolizes that the value of this transaction is blocked for various reasons.<br>Examples:<br></p><ul><li>Compliance</li><li>Legal</li><li>Fraud control</li><li>...</li></ul><p>For more information, contact the administration.</p></td></tr></tbody></table>

{% hint style="info" %}
**Payout**
{% endhint %}

<figure><img src="/files/kBJ5uUTAnOOe6jzIzbe3" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="126">Status</th><th>Description</th></tr></thead><tbody><tr><td>pending</td><td>All payout-type transactions have the pending status as the <strong>initial status</strong></td></tr><tr><td>onhold</td><td>When the payout request is sent for processing, it receives the onhold status, meaning it is <strong>waiting for the bank</strong> to make the payment to proceed with success or failure</td></tr><tr><td>success</td><td>When a payout is successfully completed and processed, the transaction status is success.</td></tr><tr><td>failed</td><td>When a payout does not meet our <strong>payment policies</strong> or we cannot process it due to various problems, it fails, and therefore our status becomes failed.</td></tr><tr><td>blocked</td><td><p>This status symbolizes that the value of this transaction is blocked for various reasons.<br>Examples:</p><ul><li>Compliance</li><li>Legal</li><li>Fraud control</li><li>...</li></ul><p>For more information, contact the administration.</p></td></tr><tr><td>returned</td><td>In some cases, the <strong>banking institution</strong> returns the received amount, in which case the status becomes returned.</td></tr><tr><td>refunded</td><td>In some cases, the <strong>customer</strong> returns the received amount, in which case the status becomes refunded.</td></tr></tbody></table>


---

# 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://docs.smartfastpay.com/v1/guides/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.