# Payment Statuses

During the payment process, various statuses indicate the current state of the transaction. It's essential to understand these statuses to effectively manage and monitor payments within your system. This topic explains the five possible payment statuses in the CoinbarPay system.

{% hint style="info" %}
Understanding the importance of these payment statuses allows you to effectively manage your payments requests.
{% endhint %}

### <mark style="color:blue;">Pending</mark>

The "Pending" status means the payment is waiting to be processed or confirmed by the cryptocurrency network. During this time, your backend system should monitor the payment status for any changes and be prepared to handle the subsequent status once it becomes available. This may involve updating records, sending notifications, or taking further actions depending on the final payment outcome.

### <mark style="color:green;">Success</mark>

The "Success" status means the payment has been successfully completed. \
At this point, the funds have been transferred from the customer's cryptocurrency wallet to your CoinbarPay account. \
Your backend system should process a successful transaction by updating the relevant records, sending a confirmation email, and fulfilling the related service or product.

### <mark style="color:orange;">Failed - Refund</mark>

The "Failed - Refund" status indicates that the payment initially succeeded, but the transaction was later reversed or refunded, returning the funds to the customer's wallet.&#x20;

This typically occurs in cases of chargebacks or disputes. When handling a refund, it's essential to communicate with the customer, investigate the issue, and, if necessary, revoke access to the associated service or product.<br>

The refund automatically occurs when the payments is partial and not fullfill the entire total price requested by the payment request.\
In othe cases it is possible to request the refund directly using the web assistance help chat or using the CoinbarPay Dashboard, in your Payments Page, or contacting our team

### <mark style="color:red;">Failed - Timeout</mark>

The "Failed - Timeout" status signifies that the payment did not complete within the specified time window set by CoinbarPay.&#x20;

This could occur because the customer did not send the transaction within the timeframe or due to issues with the cryptocurrency network processing the transaction.&#x20;

If a payment times out, the customer may need to retry the transaction.

### <mark style="color:purple;">Canceled by User</mark>

The "Canceled by User" status indicates that the customer decided to cancel the payment process before completing it. \
In such cases, no funds are transferred, and the transaction is considered void. <br>


---

# 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.coinbar.io/api-web-integration/payment-statuses.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.