Skip to main content

Webhooks

Webhooks deliver a simplified status inside the event payload. The event name tells you the outcome; the status field repeats it in short form.

EventDomainPayload statusMeaning
pixChargePaidPix InpaidDeposit paid
pixChargeExpiredPix InexpiredDeposit expired
pixChargeRejectedPix InpendingDeposit rejected (see rejectedReason)
pixWithdrawSuccessPix OutsuccessWithdraw settled
pixWithdrawFailedPix Outfailed or rejectedWithdraw failed or rejected
pixRefundSuccessRefundsuccessRefund completed
pixRefundFailedRefundfailedRefund not executed

Pix In

EventPayload status
pixChargePaidpaid
pixChargeExpiredexpired
pixChargeRejectedpending

Pix Out

EventPayload status
pixWithdrawSuccesssuccess
pixWithdrawFailedfailed, rejected

Refund

EventPayload status
pixRefundSuccesssuccess
pixRefundFailedfailed

See Webhooks guide for payload fields and delivery rules.

See also Overview.