Decode BR Code

Decodes a raw BR Code string into its structured payload components.

POST /api/v1/brcode/decode

Decode BR Code

cURL

curl --request POST \
  --url https://spi.sandbox.lerian.net/api/v1/brcode/decode \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "raw": "<string>"
}
'

200

{
  "createdAt": "<string>",
  "id": "<string>",
  "kind": "<string>",
  "merchantCity": "<string>",
  "merchantName": "<string>",
  "pixKey": "<string>",
  "status": "<string>",
  "updatedAt": "<string>",
  "amount": "<string>",
  "copyPaste": "<string>",
  "payloadUrl": "<string>",
  "qrPngBase64": "<string>",
  "qrPngContentType": "<string>",
  "raw": "<string>",
  "txId": "<string>"
}

Authorizations

Authorization · string · header · required

JWT bearer token issued by the identity provider.

Body

application/json

raw · string · required

Raw EMV BR Code copy-paste string to decode into structured payload fields.

Example:

"00020126580014br.gov.bcb.pix0136550e8400-e29b-41d4-a716-44665544000052040000530398654041.005802BR5913Lerian Studio6009Sao Paulo62070503***6304ABCD"

Response

200

application/json

OK

createdAt · string · required

Creation timestamp in RFC3339 UTC.

Example:

"2025-03-07T14:30:00Z"

id · string · required

Server-assigned payload identifier (UUID).

Example:

"550e8400-e29b-41d4-a716-446655440000"

kind · string · required

BR Code kind: STATIC (reusable) or DYNAMIC (single-use).

Example:

"STATIC"

merchantCity · string · required

Merchant city from the EMV payload (EMV field 60).

Example:

"São Paulo"

merchantName · string · required

Merchant legal/trade name from the EMV payload (EMV field 59).

Example:

"Lerian Studio"

pixKey · string · required

Pix key identifying the receiver (CPF/CNPJ, phone, email, or random EVP key).

Example:

"12345678901"

status · string · required

Lifecycle status of the payload (e.g. ACTIVE).

Example:

"ACTIVE"

updatedAt · string · required

Last-update timestamp in RFC3339 UTC.

Example:

"2025-03-07T14:30:00Z"

amount · string

Transaction amount in BRL as a decimal string, scale 2 (empty when the amount is open).

Example:

"100.00"

copyPaste · string

Pix copy-and-paste string (the raw EMV payload); empty when unavailable.

Example:

"00020126580014br.gov.bcb.pix..."

payloadUrl · string

Resolvable payload location URL for dynamic codes (empty for static codes).

Example:

"https://pix.example.com/qr/v2/550e8400"

qrPngBase64 · string

QR code image rendered from the raw payload, base64-encoded PNG (only populated on generation responses).

Example:

"iVBORw0KGgoAAAANSUhEUgAA..."

qrPngContentType · string

MIME content type of qrPngBase64 (image/png) when an image is present.

Example:

"image/png"

raw · string

Raw EMV BR Code string; same value as copyPaste, retained for compatibility.

Example:

"00020126580014br.gov.bcb.pix..."

txId · string

Merchant transaction identifier (EMV field 62.05); empty when not present.

Example:

"txid-abc-123"