> For the complete documentation index, see [llms.txt](https://docs.0xprocessing.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.0xprocessing.com/0xprocessing-api-v1/webhooks/webhooks-for-static-wallet.md).

# Webhooks for Static Wallets

Receive static-wallet payment updates through secure webhooks.

0xProcessing sends a webhook when a payment to a static wallet is completed.

Set the webhook URL under **Settings → API → Webhook URL**. HTTPS (TLS/SSL) is required.

For request authentication, header descriptions, signature verification, response requirements, retries, and implementation examples, see [Webhooks](/0xprocessing-api-v1/webhooks.md).

**Request method:** `POST`

**Content type:** `application/json`

## Payload parameters

| Name             | Type      | Description                                                                                                                                                    |
| ---------------- | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `PaymentId`      | Integer   | Payment identifier in 0xProcessing.                                                                                                                            |
| `MerchantId`     | String    | Merchant identifier in 0xProcessing.                                                                                                                           |
| `ShopId`         | String    | Merchant identifier in 0xProcessing.                                                                                                                           |
| `Amount`         | Double    | Payment amount in the payment currency.                                                                                                                        |
| `AmountUSD`      | Double    | Payment amount in USD.                                                                                                                                         |
| `TotalAmount`    | Double    | Amount actually received in the payment currency, before fees.                                                                                                 |
| `TotalAmountUSD` | Double    | Amount actually received in USD, before fees.                                                                                                                  |
| `Currency`       | String    | Payment currency.                                                                                                                                              |
| `Email`          | String    | Not used for static-wallet payments.                                                                                                                           |
| `Status`         | String    | Payment status. The supported value is `Success`.                                                                                                              |
| `BillingID`      | String    | Not used for static-wallet payments.                                                                                                                           |
| `Insufficient`   | Boolean   | Not used for static-wallet payments.                                                                                                                           |
| `Test`           | Boolean   | Indicates whether this is a test payment. Do not credit funds when `Test` is `true`.                                                                           |
| `ClientId`       | String    | Client identifier in the Merchant's system.                                                                                                                    |
| `TxHashes`       | String\[] | Hashes of successful incoming transactions.                                                                                                                    |
| `Senders`        | String\[] | Sender wallet addresses. Currently available for Tron, BNB Chain, Ethereum, Arbitrum, Avalanche, Polygon, Base, opBNB, Optimism, HypeEVM, and Robinhood Chain. |

## Example payload

```json
{
  "PaymentId": 10453,
  "MerchantId": "Asv0232SSd",
  "ShopId": "Asv0232SSd",
  "Amount": 0.00264765,
  "TotalAmount": 0.00264765,
  "Currency": "BTC",
  "Email": null,
  "Status": "Success",
  "BillingID": null,
  "AmountUSD": 115.0,
  "TotalAmountUSD": 115.0,
  "Insufficient": false,
  "Test": false,
  "ClientId": "1000",
  "TxHashes": [
    "0e61e33a0c02204c41ac210c2fcffda4bea4399792acc49479aa8374465ef63a"
  ],
  "Senders": [
    "bc1qexampleaddress"
  ]
}
```

{% hint style="warning" %}
Use `PaymentId` from the 0xProcessing webhook as an additional validation factor. Process the event only after verifying the `X-Webhook-Signature` header.
{% endhint %}