# Refund a deposit

This service enables you to issue and view refunds for completed payments.

* For **card deposits**: The original charge is reversed, returning funds to the cardholder.
* For **alternative payment methods**: The customer receives a refund via a bank transfer.

Please note, a processing fee may apply to refunds.

***

> For technical details please visit the API Reference <a href="/spaces/VNE8t2FopKfzgQzTjlBb/pages/UsntX8HSyiFzR3B4c15R" class="button primary" data-icon="pencil">Create refunds</a>&#x20;

### Card deposits

{% tabs %}
{% tab title="Example request" %}

#### Total refund

```json
curl -L \
  --request POST \
  --url 'https://api-stg.directa24.com/v3/refunds' \
  --header 'Content-Type: application/json' \
  --header 'X-Date: 2025-07-25T13:13:08.220Z' \
  --header 'X-Login: text' \
  --header 'Authorization: text' \
  --data '{
    "deposit_id": 300533647,
    "invoice_id": "newIUnit45328732",
    "comments": "Test refund",
    "notification_url": "https://merchant.com/webhooks/d24/refunds"
  }'
```

#### Partial refund

<pre class="language-json"><code class="lang-json">curl -L \
  --request POST \
  --url 'https://api-stg.directa24.com/v3/refunds' \
  --header 'Content-Type: application/json' \
  --header 'X-Date: 2025-07-25T13:13:08.220Z' \
  --header 'X-Login: text' \
  --header 'Authorization: text' \
  --data '{
    "deposit_id": 300533647,
    "invoice_id": "newIUnit45328732",
<strong>    "amount": 50,
</strong>    "comments": "Test refund",
    "notification_url": "https://merchant.com/webhooks/d24/refunds"
  }'
</code></pre>

{% endtab %}

{% tab title="Example response" %}

#### Synchronous response

```json
{
  "refund_id": "80000001",
  "deposit_id": 300533647,
  "merchant_invoice_id": "newIUnit45328732",
  "refund_info": {
    "type": "CREDIT_CARD",
    "result": "SUCCESS",
    "payment_method": "AE",
    "payment_method_name": "American Express",
    "amount": 505.95,
    "currency": "MXN",
    "created_at": "2021-02-05 22:10:45"
  }
}
```

#### Asynchronous response

In case of receiving **`IN_PROGRESS`** status for a card deposit refund, we will notify to the **`notification_url`** when the refund status change. \
Afterwards you should perform an additional Refund status check

> For more information please visit the API Reference <a href="/spaces/VNE8t2FopKfzgQzTjlBb/pages/wa4sd1C6ifl9kpeokfPO" class="button primary" data-icon="magnifying-glass">Get refund status</a>

```json
{
  "refund_id": "80000001",
  "deposit_id": 300533647,
  "merchant_invoice_id": "newIUnit45328732",
  "refund_info": {
    "type": "CREDIT_CARD",
    "result": "IN_PROGRESS",
    "reason": "Check refund status or await its notification",
    "payment_method": "AE",
    "payment_method_name": "American Express",
    "amount": 505.95,
    "currency": "MXN",
    "created_at": "2021-02-05 22:10:45"
  }
}
```

{% endtab %}
{% endtabs %}

### Alternative payment methods

{% tabs %}
{% tab title="Example request" %}

```sh
curl -L \
  --request POST \
  --url 'https://api-stg.directa24.com/v3/refunds' \
  --header 'Content-Type: application/json' \
  --header 'X-Date: 2025-07-25T13:13:08.220Z' \
  --header 'X-Login: text' \
  --header 'Authorization: text' \
  --data '{
    "deposit_id": 300533646,
    "invoice_id": "newIUnit45328731",
    "amount": 100,
    "bank_account": {
      "beneficiary": "Carlos Ramirez",
      "bank_code": "1",
      "branch": "9283",
      "account_number": "18293435",
      "account_type": "SAVING"
    },
    "comments": "Test refund over v3",
    "notification_url": "https://webhook.site/url"
  }'
```

{% endtab %}

{% tab title="Example response" %}

```json
{
  "refund_id": "80000001"
}
```

{% endtab %}
{% endtabs %}

***

### Refund status

Each time that a refund changes its status we will send a webhook notification

<pre class="language-json" data-title="Example refund webhook notification"><code class="lang-json">{
<strong>    "refund_id": 80000001
</strong>}
</code></pre>

Then, you will know that you should retrieve the status of the refund

{% tabs %}
{% tab title="Example request" %}

<pre class="language-sh"><code class="lang-sh">curl -L \
<strong>  --url 'https://api-stg.directa24.com/v3/refunds/80000001' \
</strong>  --header 'Content-Type: text' \
  --header 'X-Date: 2023-05-27T10:30:00Z' \
  --header 'X-Login: your-x-login-key' \
  --header 'Authorization: D24-HMAC-SHA256 SignedHeaders=x-date;x-login, Signature=your_signature_hash' \
  --header 'Accept: */*'
</code></pre>

{% endtab %}

{% tab title="Example response" %}

```json
{
  "deposit_id": 80000001,
  "merchant_invoice_id": "newIUnit45328732",
  "status": "COMPLETED",
  "amount": 505.95
}
```

{% endtab %}
{% endtabs %}

> For technical details regarding refunds status retrieval, please visit the **API Reference** <a href="/spaces/VNE8t2FopKfzgQzTjlBb/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://docs.pandablue.com/guides/deposits/refund-a-deposit.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.