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 In - Refunded (transaction.refunded)

POST
https://your-webhook-url.com/postback
Webhook sent when a Pix In payment is refunded.
Event: transaction.refunded
Type: transaction
This webhook is sent to your configured postbackUrl when a Pix In payment is refunded.

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_1765502253006_utw9w05vo",
  "type": "transaction",
  "event": "transaction.refunded",
  "objectId": "0b922550-ebf7-433b-a5d9-ee56a3c38285",
  "data": {
    "id": "0b922550-ebf7-433b-a5d9-ee56a3c38285",
    "status": "refunded",
    "amount": 500,
    "refundedAmount": 500,
    "installments": 1,
    "paymentMethod": "PIX",
    "companyId": "4d1a3c25-2cfc-4f72-b814-23d9fd168c8e",
    "externalRef": "ORD-123",
    "customer": {
      "id": "e00d270d-84de-4b94-8d1b-3bb26921e04f",
      "name": "John Smith",
      "email": "john@email.com",
      "phone": "11999999999",
      "document": "12345678910",
      "createdAt": "2025-12-02T19:12:51.628Z"
    },
    "pix": {
      "qrcode": "00020101021226880014br.gov.bcb.pix2566qrcode.example.com/pix/a1b2c3d4-5e6f-7890-abcd-ef1234567890520400005303986580BR5925COMPANY EXAMPLE LTDA6008SaoPaulo62070503***6304ABCD",
      "end2EndId": "E18236120202512020455s14af098224"
    },
    "paidAt": "2025-12-02T04:55:26.942Z",
    "createdAt": "2025-12-11T23:16:24.094Z",
    "updatedAt": "2025-12-12T01:17:32.971Z",
    "postbackUrl": "https://webhook.example.com/postback"
  }
}'
Response Response Example
{}
Modificado em 2025-12-29 21:29:45
Página anterior
Pix In - Payment Confirmed (transaction.paid)
Próxima página
Pix Out - Transfer Confirmed (transfer.paid)
Built with