Skip to main content
POST
cURL com dados fictícios

Autorizações

Authorization
string
header
obrigatório

JWT bearer token issued by the identity provider.

Corpo

application/json
emvPayload
string
obrigatório

EMV BR Code payload to decode

Exemplo:

"00020101021126580014br.gov.bcb.pix0136123e4567-e12b-12d1-a456-4266554400005204000053039865802BR5913Fulano de Tal6008BRASILIA62070503***630448CD"

Resposta

OK

isReusable
boolean
obrigatório

Whether the BR Code may be paid more than once. True for every STATIC payload, including one whose Point of Initiation method is absent.

Exemplo:

true

merchantCity
string
obrigatório
Exemplo:

"Goiania"

merchantName
string
obrigatório
Exemplo:

"Loja Teste"

type
enum<string>
obrigatório

Type embedded in the payload. A payload that names NO Point of Initiation method (EMV tag 01 absent) is reported as STATIC: EMVCo makes the element optional and defines its absence as static, and BCB's own composed QR Code examples omit it. Such a payload was previously rejected as malformed.

Opções disponíveis:
STATIC,
DYNAMIC_IMMEDIATE,
DYNAMIC_DUEDATE
Exemplo:

"STATIC"

amount
string
Exemplo:

"100.50"

currency
enum<string>
Opções disponíveis:
BRL
Exemplo:

"BRL"

description
string
Exemplo:

"Pagamento do pedido 12345"

expiresAt
string<date-time>
Exemplo:

"2026-05-06T11:30:00Z"

keyType
enum<string>

Pix key type inferred from keyValue, ABSENT when no type both matches and validates. A CPF/CNPJ must satisfy its Modulo 11 check digits — a document that does not is unregistrable at DICT, so no type is reported. A masked document ("529.982.247-25") IS recognised. A phone is any E.164 number, not only "+55".

Opções disponíveis:
CPF,
CNPJ,
PHONE,
EMAIL,
EVP
Exemplo:

"EVP"

keyValue
string

Pix key exactly as the payload carries it, punctuation included. It is never normalized: this endpoint reports what was scanned.

Exemplo:

"123e4567-e12b-12d1-a456-426655440000"

txId
string
Exemplo:

"TX12345"