1. Webhooks
Pix2DePix API
  • 📜 API Overview
  • Docs
    • 🔑 Authentication
    • 💻 Examples
    • 🪝 Webhook
    • ✅ Possible Statuses
      • 📥💰 Deposit Statuses
      • 📤💸 Withdraw Statuses
    • 🛡️ Security & Limits
      • ✅ Best Practices
      • 🪲 Bug Bounty
      • 🧱 Firewall
      • 🚦 API Limits
    • 🧩 Advanced (optional)
      • 🎲 Nonce
      • 🔀 Synchronous requests & safe retries
    • 🚀 Features
      • ⏱️ QR Delay
  • API Endpoints
    • Ping
      GET
    • Deposit (PIX ➔ DePix)
      POST
    • Deposit Status
      GET
    • Deposits
      GET
    • User Info
      GET
    • Withdraw
      POST
    • Withdraw Status
      GET
  • Webhooks
    • Deposit Webhook
    • Withdraw Webhook
    • MED Webhook
  • Schemas
    • AllPossibleObjResponses
    • StandardResponse
    • PingObjOrError
    • JWTClaims
    • ObjResponse
    • ErrorObj
    • PingObj
    • ErrorResponse
    • DepositRequest
    • DepositObjOrError
    • DepositObj
    • PingResponse
    • DepositResponse
    • DepositStatusObj
    • DepositStatusResponse
    • DepositWebhookBody
    • DepositsResponse
    • DepositStatus
    • UserInfoResponse
    • WithdrawStatusResponse
    • WithdrawStatusObj
    • WithdrawResponse
    • WithdrawObj
    • WithdrawStatus
    • WithdrawWebhookBody
    • MEDWebhookBody
    • RejectionReasons
  1. Webhooks

MED Webhook

Webhook
POST
med
A MED (Pix refund claim) was opened against a deposit. 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 /deposits instead of waiting for a second attempt, and still deduplicate on qrId / id.

Request

Authorization
API Key
Add parameter in header
Authorization
Example:
Authorization: ********************
or
Body Params application/jsonRequired

Example
{
    "webhookType": "med",
    "qrId": "string",
    "bankTxId": "string",
    "blockchainTxID": "string",
    "creationDateReport": "string",
    "euid": "string",
    "name": "string",
    "partnerId": "string",
    "principalValueInCents": 0,
    "taxNumber": "string"
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://your-api-server.com' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "webhookType": "med",
    "qrId": "string",
    "bankTxId": "string",
    "blockchainTxID": "string",
    "creationDateReport": "string",
    "euid": "string",
    "name": "string",
    "partnerId": "string",
    "principalValueInCents": 0,
    "taxNumber": "string"
}'

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-11 05:50:59
Previous
Withdraw Webhook
Next
AllPossibleObjResponses
Built with