Reverse an inbound PIX Automatico settlement debit
Reverses the prior settlement debit (or releases a still-pending hold) on a negative SPI return (section 5.4.3, the plugin is the SGCT server). The reverse is parameterizable and disabled by default. Returns the SGCT reversal-operation id (idOperacaoSgct).
Authorizations
JWT bearer token issued by the identity provider.
Headers
Bearer access token (the financial-ingress gate; the handler fails closed with PIX-0082 when absent).
"Bearer eyJ..."
Idempotency key (= the endToEndId of the transaction). Mandatory per section 5.4.
"E11111111202409181500y6j6mt9l1pi"
Path Parameters
Unique payment-instruction id (32-char), the natural key.
"E11111111202409181500y6j6mt9l1pi"
Body
Error code (the section 8.7 generic SPI domain; NOT the section 5.3 motivoRejeicao set).
"AB03"
Unique payment-instruction id (32-char; matches the path param).
"E11111111202409181500y6j6mt9l1pi"
Negative-return classification (1=processing error, 2=JDPI validation error, 3=SPI-returned error).
3
Error description (1000-char).
"Liquidacao da transacao interrompida devido a timeout no SPI."
Response
OK
SGCT operation timestamp (UTC).
"2024-09-20T04:02:00.021Z"
Unique payment-instruction id (32-char).
"E11111111202409181500y6j6mt9l1pi"
SGCT reversal-operation id (a GUID).
"58F752C5-6376-3252-8305-A2DE3A8525D4"

