Skip to main content
POST
Receive a Pix Automático schedule cancellation status event

Authorizations

Authorization
string
header
required

JWT Bearer token authentication. Obtain token from /v1/login/oauth/access_token endpoint using client credentials (clientId and clientSecret).

Include token in Authorization header: Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

Token expires after 3600 seconds (1 hour).

Headers

Authorization
string

Bearer access token (the financial-ingress gate; the handler fails closed with Pix-0082 when absent).

X-DataHoraEvento
string
required

Event registration instant (UTC: aaaa-mm-ddTHH:mm:ss.sssZ). Mandatory per

X-NomeEvento
string
required

Event name. Mandatory per; informational passthrough.

Body

application/json
cpfCnpjSolCancelamento
string
required

Requester CPF/CNPJ (a v5.5.0 string).

dtHrCancelamento
string
required

Cancellation timestamp (UTC).

dtHrSituacao
string
required

Situation-query timestamp (UTC).

endToEndId
string
required

Unique payment-instruction id (32-char).

idCancelamento
string
required

Unique cancellation id (29-char, CA...).

ispbDestinatario
string
required

Destination PSP ISPB (8 digits, a v5.5.0 string).

ispbSolicitante
string
required

Requesting PSP ISPB (8 digits, a v5.5.0 string).

motivoCancelamento
integer<int64>
required

Cancellation reason (0..6).

solCancelamento
integer<int64>
required

Requesting PSP (0=pagador, 1=recebedor).

stJdPi
integer<int64>
required

Overall cancellation situation (-1/0/9).

stJdPiProc
integer<int64>
required

Intermediate cancellation-processing situation (0/1/2/5/7/8/9).

tpPessoaSol
integer<int64>
required

Requester person type (0=PF, 1=PJ).

codigoErro
string

Upstream error code (on a rejection or internal error).

descCodigoErro
string

Upstream error description.

dtHrReqJdPi
string

Upstream request registration timestamp (UTC).

idConciliacaoRecebedor
string

Receiver conciliation id (35-char).

stCancelamento
integer<int64>

Cancellation status (0=Aceito, 1=Rejeitado); OPTIONAL, absent => no-op.

Response

No Content