Buvei
API ReferenceWebhook Events

PAYOUT_FAILED

A payout reached terminal FAILED — funds have been refunded to the wallet.

Delivered once a payout transitions to terminal FAILED. The full debit has been refunded to your project wallet — no further action is required from you.

Headers

Standard webhook headers — see Webhook security.

Payload

Same fields as PAYOUT_SUCCEEDED, with status = "FAILED".

Response
{
  "eventId": "e_pu1XXkMycJijSikkzBqF",
  "eventType": "PAYOUT_FAILED",
  "timestamp": 1779955216591,
  "data": {
    "merOrderNo": "PO20260528155955tdi9fpi4",
    "status": "FAILED",
    "paymentType": "PayPal",
    "arriveCurrency": "EUR",
    "arriveAmount": 10000,
    "quoteRate": 0.8624,
    "settleAmount": 11696,
    "payeeFirstName": "John",
    "payeeLastName": "Smith",
    "payeeAccountNo": "[email protected]",
    "remark": "Order 88231",
    "createdAt": 1779955195000,
    "completedAt": 1779955216572
  }
}

Failure reasons (e.g. invalid PayPal account, upstream rejection) are recorded internally but not currently surfaced in the webhook payload. Contact support if you need a specific failure investigated by merOrderNo.

On this page

Headers
Payload