Get warned before a refund happens — and stop delivering
Aug 3- New webhook event
payment.refund_pending: the PIX provider now warns us in advance when it is going to refund a payment it already received (risk or compliance reasons). It fires ahead ofpayment.refunded— about 2 hours earlier on average, and up to 3 days when the provider holds the amount first (the expected date comes inexpectedRefundAt). - The payload carries
rejectionReasons, the provider's own reason code — for examplePAYER_MISMATCHwhen the paying account's document differs from the one the QR was locked to, orBLOCKED_USER. This is the provider's declared reason, not our inferredrefundReasonDetail. - Buyer access is now revoked automatically. On sales with a DePix delay window, buyer access is granted at PIX confirmation, before settlement. If the provider then announces a refund, we cancel the purchase and revoke the access — the event reports
accessRevoked: trueso you can reverse fulfillment on your side too. - Sales that receive the warning before access is granted are no longer released at all: the deposit stays pending until the refund lands, instead of delivering the product against money that goes back to the payer.
- See the
payment.refund_pendingevent in the API docs for the full payload.
