Skip to main content
POST
Register an inbound Pix Automático schedule cancellation

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).

Body

application/json
cpfCnpjSolCancelamento
string
required

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

dtHrCancelamento
string
required

Cancellation timestamp (UTC).

endToEndId
string
required

Unique payment-instruction id (32-char).

idCancelamento
string
required

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

idConciliacaoRecebedor
string
required

Receiver conciliation id (35-char).

idRecorrencia
string
required

Unique recurrence id (29-char, RR...).

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).

stCancelamento
integer<int64>
required

Cancellation status (0=Aceito, 1=Rejeitado).

tpPessoaSol
integer<int64>
required

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

codigoErro
string

Upstream error code (100-char; on a rejection).

descCodigoErro
string

Upstream error description (100-char).

Response

OK

dtHrSgct
string
required

settlement-gateway registration timestamp (UTC).

idSgct
string
required

Local settlement-gateway cancellation id (36-char GUID).