Skip to main content
POST
Reserve an inbound PIX Automatico debit hold

Autorizaciones

Authorization
string
header
requerido

JWT bearer token issued by the identity provider.

Encabezados

Authorization
string

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

Ejemplo:

"Bearer eyJ..."

Chave-Idempotencia
string
requerido

Idempotency key (= the endToEndId of the transaction). Mandatory per section 5.4.

Ejemplo:

"E11111111202409181500y6j6mt9l1pi"

Cuerpo

application/json
codMunIbge
integer<int64>
requerido

Payer IBGE municipality code (7 digits).

Ejemplo:

3550308

cpfCnpj
string
requerido

Payer CPF or CNPJ (a v5.5.0 string).

Ejemplo:

"11111111111"

endToEndId
string
requerido

Unique payment-instruction id (32-char).

Ejemplo:

"E11111111202409181500y6j6mt9l1pi"

ispb
string
requerido

Payer participant ISPB (8 digits, a v5.5.0 string).

Ejemplo:

"04358798"

nrConta
string
requerido

Payer account number (nrConta, a string).

Ejemplo:

"12345678"

tpPessoa
integer<int64>
requerido

Payer person type (0=Pessoa Fisica, 1=Pessoa Juridica).

Ejemplo:

0

valor
number<double>
requerido

Reserve amount in reais (a JSON number; the only money field in section 5.4).

Ejemplo:

1500.25

nrAgencia
string

Payer branch (nrAgencia, 4 digits, string).

Ejemplo:

"1234"

Respuesta

OK

dtHrRespostaSgct
string
requerido

SGCT response timestamp (UTC).

Ejemplo:

"2024-09-20T04:00:01.001Z"

endToEndId
string
requerido

Unique payment-instruction id (32-char).

Ejemplo:

"E11111111202409181500y6j6mt9l1pi"

resultado
integer<int64>
requerido

Block result (0=Rejeitado, 1=Aceito).

Ejemplo:

1

idOperacaoSgct
string

SGCT block-operation id (GUID; present only when resultado=1).

Ejemplo:

"58F752C5-6376-3252-8305-A2DE3A8525D3"

motivo
string

Rejection reason (SGCTPIX001=insufficient funds, SGCTPIX999=other; present only when resultado=0).

Ejemplo:

"SGCTPIX001"

motivoComplemento
string

Rejection detail (present only when resultado=0).

Ejemplo:

"Cliente nao possui saldo suficiente para o bloqueio solicitado"