# 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.\


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

<figure><img src="https://content.gitbook.com/content/nuIDlPYNfNFiZPgmfSit/blobs/OEWYEqEZH71niuhF79rl/transaction-status.svg" 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.\


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

<figure><img src="https://content.gitbook.com/content/nuIDlPYNfNFiZPgmfSit/blobs/lAXlUSxmeGJw0aEDFXvV/payment-status.svg" 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="https://content.gitbook.com/content/nuIDlPYNfNFiZPgmfSit/blobs/hrah1gOTAaUCvpwXvvnQ/payout-status.svg" 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>
