---
updatedAt: 2026-05-17T01:06:44.000Z
agentTools:
  projectIndex: https://docs.infiniaweb.com/llms.txt
---

# Deposit refund updated

Sent when a deposit refund changes status. The body is identical to an item from the [List Deposit Refunds](ref:v1_7_list_deposit_refunds) response.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Accounts",
    "description": "Manage your virtual accounts and movements",
    "version": "0.1.0"
  },
  "servers": [
    {
      "url": "https://app2test.infiniaweb.com/infinia_api/v1/accounts",
      "description": "Sandbox"
    }
  ],
  "components": {
    "schemas": {
      "CompanyToIncludeInResponses": {
        "properties": {
          "id": {
            "type": "string",
            "title": "Id"
          },
          "name": {
            "type": "string",
            "title": "Name"
          }
        },
        "type": "object",
        "required": [
          "id",
          "name"
        ],
        "title": "CompanyToIncludeInResponses"
      },
      "DepositRefundResponse": {
        "properties": {
          "id": {
            "type": "string",
            "title": "Id",
            "description": "Refund ID"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "title": "Created At",
            "description": "Creation date of the refund"
          },
          "updated_at": {
            "title": "Updated At",
            "description": "Last update date of the refund",
            "type": "string",
            "format": "date-time"
          },
          "idempotency_key": {
            "title": "Idempotency Key",
            "description": "Idempotency key for the refund request, it can also be used as an external identifier",
            "type": "string",
            "maxLength": 128
          },
          "status": {
            "type": "string",
            "enum": [
              "PENDING",
              "SUCCESS",
              "FAILED"
            ],
            "title": "Status",
            "description": "Status of the refund"
          },
          "description": {
            "title": "Description",
            "description": "Description for the refund. If supported by the rail, this will be forwarded to the end user.",
            "type": "string"
          },
          "debit_movement_id": {
            "title": "Debit Movement Id",
            "description": "Debit movement that was originated from the refund",
            "type": "integer"
          },
          "bounce_movement_id": {
            "title": "Bounce Movement Id",
            "description": "Credit movement that was originated from the refund bounce, if applicable",
            "type": "integer"
          },
          "company": {
            "allOf": [
              {
                "$ref": "#/components/schemas/CompanyToIncludeInResponses"
              }
            ],
            "description": "Company associated with the refund"
          },
          "voucher_id": {
            "title": "Voucher Id",
            "description": "Voucher ID associated with the refund, if applicable",
            "type": "string"
          },
          "failure_reason": {
            "title": "Failure Reason",
            "description": "Reason for refund failure, if applicable",
            "type": "string"
          },
          "movement_id": {
            "type": "integer",
            "title": "Movement Id",
            "description": "Movement ID that was refunded"
          }
        },
        "type": "object",
        "required": [
          "id",
          "created_at",
          "status",
          "movement_id"
        ],
        "title": "Refund Response"
      }
    }
  },
  "webhooks": {
    "deposit_refund.updated": {
      "post": {
        "operationId": "v1_webhook_deposit_refund_updated",
        "summary": "Deposit refund updated",
        "description": "Sent when a deposit refund changes status. The body is identical to an item from the [List Deposit Refunds](ref:v1_7_list_deposit_refunds) response.",
        "tags": [
          "Webhooks"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DepositRefundResponse"
              },
              "example": {
                "id": "ref_01HXYZ",
                "created_at": "2024-05-30T11:00:00Z",
                "updated_at": "2024-05-30T11:05:00Z",
                "status": "SUCCESS",
                "movement_id": 9001,
                "company": {
                  "id": 42,
                  "name": "Acme Corp"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Any 2xx response is treated as a successful acknowledgement. Infinia will retry delivery on non-2xx responses."
          }
        }
      }
    }
  }
}
```