Withdraw Webhook

Webhook

POST

withdraw

Withdrawal changed state. Deliveries are not ordered. Sent as POST to the URL registered for this partner, with Authorization: Basic <secret> carrying the registered secret verbatim. Registration is done through the Telegram bot, not through this API. Respond within 15 seconds. A failed delivery is NOT retried: reconcile with GET /withdraw-status instead of waiting for a second attempt, and still deduplicate on id.

Request

Authorization

API Key

Add parameter in header

Authorization

Example:

Authorization: ********************

Body Params application/jsonRequired

Example

{
    "webhookType": "withdraw",
    "id": "019b76daa800700000000000000000a1",
    "pixKey": "example@example.com",
    "status": "sent",
    "expiration": "2026-01-01T00:20:00-03:00",
    "depositAddress": "lq1qqtkuz7nwp3cymteg0px5pcltrm26uvsak32t04fawfsacafutjg22fhvc8xhj0ue96cevuatnmt757rf4z2r5cwntsemgngcr",
    "depositAmountInCents": 124647,
    "payoutAmountInCents": 123400,
    "blockchainTxID": "79ad78f779839d2cbbe59612c7f9eff0919892ae601888b40ab877607ea54217",
    "receiptUrl": "https://resources.eulen.app/receipt/pix/ddb95453-25f8-57f7-8a89-2225cfb18540",
    "receiverName": "Maria Silva Souza",
    "receiverTaxNumber": "***.456.789-**",
    "transferDate": "2026-01-01T00:01:12-03:00",
    "centralBankId": "E12345678202601010000a1b2c3d4e5f"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://your-api-server.com' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "webhookType": "withdraw",
    "id": "019b76daa800700000000000000000a1",
    "pixKey": "example@example.com",
    "status": "sent",
    "expiration": "2026-01-01T00:20:00-03:00",
    "depositAddress": "lq1qqtkuz7nwp3cymteg0px5pcltrm26uvsak32t04fawfsacafutjg22fhvc8xhj0ue96cevuatnmt757rf4z2r5cwntsemgngcr",
    "depositAmountInCents": 124647,
    "payoutAmountInCents": 123400,
    "blockchainTxID": "79ad78f779839d2cbbe59612c7f9eff0919892ae601888b40ab877607ea54217",
    "receiptUrl": "https://resources.eulen.app/receipt/pix/ddb95453-25f8-57f7-8a89-2225cfb18540",
    "receiverName": "Maria Silva Souza",
    "receiverTaxNumber": "***.456.789-**",
    "transferDate": "2026-01-01T00:01:12-03:00",
    "centralBankId": "E12345678202601010000a1b2c3d4e5f"
}'

Responses

🟢200

Acknowledged. The API accepts 200 or 201; any other status is recorded as a delivery failure.

This response does not have a body.

🟢201

Modified at 2026-08-26 21:34:42

Deposit Webhook

MED Webhook