> For the complete documentation index, see [llms.txt](https://docs.aquanow.io/cams/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.aquanow.io/cams/webhooks/payouts.md).

# Payouts

### **Payout Created**

<mark style="color:green;">`POST`</mark>&#x20;

Notifies the status of an outgoing payout.

{% hint style="info" %}
Allowed Values: `PAYOUT_FAILED`, `PAYOUT_CREATED`, `PAYOUT_PROCESSING` ,`PAYOUT_COMPLETED`
{% endhint %}

**Body**

```json
{
  "messageId": "123e4567-e89b-12d3-a456-426614174000",
  "messageType": "PAYOUT_CREATED",
  "messageTime": "2023-12-14T01:24:03.102Z",
  "message": {
      "transactionType": "PAYOUT",
      "payoutId":"8657976e-c7ee-4db0-92c0-adb43e2cfde4",
      "status":"PENDING_AUTHORIZATION",
      "beneficiaryAddressId": "39b83120-a80f-4bd9-8469-7d5bcaa055af",
      "beneficiaryId": "bf22f3c9-c5f6-4815-a6a6-9b999612b713",
      "sourceAccountId": "635b8c14-c6a9-4838-b9a1-bc7ddc29a086",
      "sourceQuantity": "3.6725",
      "beneficiaryQuantity": "3.6725",
      "payoutFeeQuantity": "3.6725",
      "netBeneficiaryQuantity": "3.6725",
      "sourceCurrency": "USD",
      "feeCurrency": "USD",
      "beneficiaryCurrency": "USDT",
      "memo": "text",
      "feePaidBy": "MERCHANT",
      "payoutFeeRate": "1",
      "clientReference": "REF-123-E",
      "conversionRate": "1",
      "paymentReason": "Affiliate payout",
      "requestedAt": "2026-02-19T18:44:05Z",
      "expiresAt": "2026-02-19T18:44:05Z",
      "updatedAt": "2026-02-19T18:44:05Z",
      "authorizedAt": "2026-02-19T18:44:05Z",
}
```

### Payout Processing

<mark style="color:green;">`POST`</mark>&#x20;

Notifies that an authorized payout is now being processed for disbursement to the beneficiary.

{% hint style="info" %}
Allowed Values: `PROCESSING`
{% endhint %}

**Body**

<div data-with-frame="true"><figure><img src="/files/IhZZLK4Ust7qdxCv7qow" alt=""><figcaption></figcaption></figure></div>

### Payout Completed

<mark style="color:green;">`POST`</mark>&#x20;

Notifies that an outgoing payout has successfully settled and been delivered to the beneficiary..

{% hint style="info" %}
Allowed Values: `COMPLETED`
{% endhint %}

**Body**

<div data-with-frame="true"><figure><img src="/files/MkZ3FtCdlorDdTGW8Ohf" alt=""><figcaption></figcaption></figure></div>

### Payout Failed

<mark style="color:green;">`POST`</mark>&#x20;

Notifies that an outgoing payout attempt has failed and could not be completed.

{% hint style="info" %}
Allowed Values: `FAILED`
{% endhint %}

**Body**

<div data-with-frame="true"><figure><img src="/files/Lao2ehKha3x3fqAPl6CK" alt=""><figcaption></figcaption></figure></div>