> 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="https://2600433319-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4LnbO9QFRq3XZT6kRr2v%2Fuploads%2F7WJUaO3pUPVpEZ7lFmEp%2FScreenshot%202026-08-10%20at%201.17.08%E2%80%AFPM.png?alt=media&amp;token=48edd5bc-69f3-4969-bb7b-c7cd339fca31" 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="https://2600433319-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4LnbO9QFRq3XZT6kRr2v%2Fuploads%2FiH6FhmXXD25dAIqRkDRw%2FScreenshot%202026-08-11%20at%2012.56.41%E2%80%AFPM.png?alt=media&amp;token=2c31d339-8c5c-4938-835a-0d71f9f06220" 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="https://2600433319-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4LnbO9QFRq3XZT6kRr2v%2Fuploads%2FxqOfsovNPxb99cqJ6F8k%2FScreenshot%202026-08-10%20at%201.11.02%E2%80%AFPM.png?alt=media&amp;token=4632b232-bb7f-4063-bda4-1f02d5b5c3fc" alt=""><figcaption></figcaption></figure></div>