PayAlpha
  1. Webhooks (Reference)
PayAlpha
  • Intro
  • Pix In
    • Create Pix In Transaction
      POST
    • Get Pix In Transaction
      GET
  • Pix Out
    • Create Pix Out Transaction
      POST
    • Get Pix Out Transaction
      GET
  • Webhooks (Reference)
    • Pix In - Payment Confirmed (transaction.paid)
      POST
    • Pix In - Refunded (transaction.refunded)
      POST
    • Pix Out - Transfer Confirmed (transfer.paid)
      POST
    • Pix Out - Transfer Failed (transfer.failed)
      POST
  • Wallets
    • Get Wallet Balances
      GET
  1. Webhooks (Reference)

Pix Out - Transfer Confirmed (transfer.paid)

POST
https://your-webhook-url.com/postback
Webhook sent when a Pix Out transfer is successfully completed.
Event: transfer.paid
Type: transfer
This webhook is sent to your configured postbackUrl when a Pix Out transfer is successfully completed. The beneficiary object contains the real recipient data obtained from the bank.

Requisição

Authorization
Envie suas requisições HTTP com um cabeçalho
Authorization
que contenha a palavra Basic seguida por um espaço e uma string codificada em base64 username:password
Exemplo:
Authorization: Basic *****************
Parâmetros Header

Parâmetros Bodyapplication/json

Examples

Respostas

🟢200
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://your-webhook-url.com/postback' \
--header 'X-Webhook-Signature: a1b2c3d4e5f6...' \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "id": "evt_1765500101975_o8qujipis",
  "type": "transfer",
  "event": "transfer.paid",
  "objectId": "f4b25725-5c90-485f-962d-aad7210b4f6a",
  "data": {
    "id": "f4b25725-5c90-485f-962d-aad7210b4f6a",
    "status": "paid",
    "amount": 10000,
    "fee": 60,
    "netAmount": 10000,
    "paymentMethod": "PIX",
    "externalRef": "withdraw_123",
    "pixKey": "maria.santos@example.com",
    "pixKeyType": "EMAIL",
    "destinationName": "Maria Santos",
    "destinationDocument": "98765432100",
    "pixEnd2EndId": "E04838403202512120041TS55EAFN3YS",
    "createdAt": "2025-12-12T00:41:31.170Z",
    "updatedAt": "2025-12-12T00:41:41.976Z",
    "paidAt": "2025-12-12T00:41:41.955Z",
    "requiresManualReview": false,
    "beneficiary": {
      "name": "MARIA SANTOS OLIVEIRA",
      "document": "98765432100",
      "documentType": "cpf",
      "bankAccount": {
        "ispb": "00000000",
        "branch": "0001",
        "account": "123456"
      }
    },
    "metadata": {
      "feeModel": "DEDUCT_FROM_WALLET",
      "directPixKey": true,
      "bankAccountNickname": null
    }
  }
}'
Response Response Example
{}
Modificado em 2025-12-29 21:29:45
Página anterior
Pix In - Refunded (transaction.refunded)
Próxima página
Pix Out - Transfer Failed (transfer.failed)
Built with