Skip to main content
POST
cURL con datos ficticios

Autorizaciones

Authorization
string
header
requerido

JWT bearer token issued by the identity provider.

Cuerpo

application/json
emvPayload
string
requerido

EMV BR Code payload to decode

Ejemplo:

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

Respuesta

OK

isReusable
boolean
requerido

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

Ejemplo:

true

merchantCity
string
requerido
Ejemplo:

"Goiania"

merchantName
string
requerido
Ejemplo:

"Loja Teste"

type
enum<string>
requerido

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.

Opciones disponibles:
STATIC,
DYNAMIC_IMMEDIATE,
DYNAMIC_DUEDATE
Ejemplo:

"STATIC"

amount
string
Ejemplo:

"100.50"

currency
enum<string>
Opciones disponibles:
BRL
Ejemplo:

"BRL"

description
string
Ejemplo:

"Pagamento do pedido 12345"

expiresAt
string<date-time>
Ejemplo:

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

Opciones disponibles:
CPF,
CNPJ,
PHONE,
EMAIL,
EVP
Ejemplo:

"EVP"

keyValue
string

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

Ejemplo:

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

txId
string
Ejemplo:

"TX12345"