---
title: "Payout updated"
method: POST
path: "payout.updated"
tags: ["Webhooks"]
---

# Payout updated

`POST payout.updated` (webhook)

Sent when a payout changes status (`IN_PROGRESS` → `COMPLETED`, `FAILED`, etc.). Set the destination URL using `callbackUrl` when creating the payout. The body is identical to the [Get Payout](ref:v2_get_payout__payout_id___get) response.

## Payload

- PayoutResponse
  - `id` string, required
  - `transactionId` string
  - `originId` string
  - `voucherId` string
  - `bank` string
  - `country` 'ARGENTINA' | 'BRAZIL' | 'MEXICO' | 'PARAGUAY' | 'PERU' | 'COLOMBIA' | 'CHILE' | 'EUROPE' | 'GLOBAL' | 'BOLIVIA' | 'UNITED_KINGDOM', required
  - `currency` 'ARS' | 'USD' | 'BRL' | 'MXN' | 'PYG' | 'CLP' | 'PEN' | 'EUR' | 'GBP' | 'USDT' | 'USDC' | 'BOB' | 'EURC' | 'COP' | 'USDC_POL' | 'USDT_POL' | 'EURC_BASE' | 'USDC_BASE' | 'USDT_BASE' | 'USDC_ETH' | 'USDT_ETH' | 'EURC_ETH' | 'USDC_TEMPO' | 'USDT_TEMPO' | 'EURC_TEMPO' | 'OUSD' | 'OUSD_TEMPO' | 'USDC_MONAD' | 'USDT_MONAD' | 'OUSD_BASE' | 'OUSD_ETH' | 'OUSD_SOL' | 'GBP' | 'BRLA' | 'BRLA_POL' | 'BRLA_BASE' | 'BRLA_ETH' | 'TGBP' | 'TGBP_POL' | 'TGBP_BASE' | 'TGBP_ETH' | 'USDC_SOL' | 'USDT_SOL' | 'USDT_TRX' | 'MXNB' | 'MXNB_BASE', required
  - `createdAt` string, required: Transfer creation date
  - `updatedAt` string: Date on which the transfer was updated
  - `amount` number, required
  - `msgStatus` string
  - `status` 'COMPLETED' | 'IN_PROGRESS' | 'FAILED' | 'REFUNDED' | 'PARTIALLY_REFUNDED' | 'ERROR', required
  - `complianceHold` boolean: True while the payout is temporarily held for a compliance review. The payout resumes automatically once the review is completed.
  - `sourceAccount` SourceAccount
    - `id` integer: ID of the source account
    - `country` string, required: Country of source account
    - `bank` string, required: Bank of source account
    - `currency` string, required: Currency of source account
    - `accountNumber` string, required: Authorized account for performing payout.
    - `label` string: Label for the source account.
  - `destination` object
  - `refunds` RefundsSchema[]
    - `transactionId` string, required
    - `status` 'COMPLETED' | 'IN_PROGRESS' | 'FAILED' | 'REFUNDED' | 'PARTIALLY_REFUNDED' | 'ERROR', required
    - `createdAt` string, date-time, required
    - `amount` number, required
    - `currency` 'ARS' | 'USD' | 'BRL' | 'MXN' | 'PYG' | 'CLP' | 'PEN' | 'EUR' | 'GBP' | 'USDT' | 'USDC' | 'BOB' | 'EURC' | 'COP' | 'USDC_POL' | 'USDT_POL' | 'EURC_BASE' | 'USDC_BASE' | 'USDT_BASE' | 'USDC_ETH' | 'USDT_ETH' | 'EURC_ETH' | 'USDC_TEMPO' | 'USDT_TEMPO' | 'EURC_TEMPO' | 'OUSD' | 'OUSD_TEMPO' | 'USDC_MONAD' | 'USDT_MONAD' | 'OUSD_BASE' | 'OUSD_ETH' | 'OUSD_SOL' | 'GBP' | 'BRLA' | 'BRLA_POL' | 'BRLA_BASE' | 'BRLA_ETH' | 'TGBP' | 'TGBP_POL' | 'TGBP_BASE' | 'TGBP_ETH' | 'USDC_SOL' | 'USDT_SOL' | 'USDT_TRX' | 'MXNB' | 'MXNB_BASE', required
    - `message` string
  - `creditorAccount` CreditorAccount
    - `number` string: Number of creditor account
    - `branch` string: Agency of creditor account
    - `type` string: Type of creditor account
    - `bankCode` string: Bank code of creditor account
    - `bankName` string: Bank name of creditor account
    - `ownerName` string: Owner name of creditor account
    - `ownerDocument` string: Owner document number of creditor account
    - `ownerDocumentType` string: Owner document type of creditor account
  - `extraInfo` object
  - `callbackUrl` string
  - `company` Company, required
    - `id` integer, required
    - `name` string, required
  - `createdAtIso` string: Transfer creation date in ISO 8601 format
  - `updatedAtIso` string: Date on which the transfer was updated in ISO 8601 format

## Acknowledgement `200`

Any 2xx response is treated as a successful acknowledgement. Infinia will retry delivery on non-2xx responses.

---

[API](https://skmtc.dev/infiniaweb/apis/payouts.md) - [All operations](https://skmtc.dev/infiniaweb/apis/payouts/llms.txt) - [OpenAPI document](https://skmtc.dev/infiniaweb/apis/payouts/revisions/a860ab0b3911?raw)