---
title: "Decode PIX EMV string"
method: POST
path: "/open-keys/itp/api/v2/payments/v4/payment-initiation/pix/emv"
tags: ["Payment Initiation"]
---

# Decode PIX EMV string

`POST /open-keys/itp/api/v2/payments/v4/payment-initiation/pix/emv`

Decodes a PIX EMV string to extract payment information such as receiver data, amount, city and additional information. Supports Central Bank of Brazil's EMV-QR Code standard for PIX instant payments.

## Request body

- V2OpenKeysItpPaymentsV4PaymentInitiationEmvRequest
  - `emv` string, required — PIX EMV string containing encoded payment data according to Central Bank of Brazil's EMV-QR specification. This string encodes merchant information, payment amount, and other transaction details for PIX instant payments.

## Response `200`

PIX EMV string decoded data successfully returned.

- EmvResponse
  - `version` string, required — Version of the EMV response.
  - `status` number, double, required — Status code of the EMV processing response.
  - `body` EmvResponseBody, required
    - `type` 'STATIC' | 'DYNAMIC', required — PIX QR code type (STATIC or DYNAMIC).
    - `merchantAccountInformation` EmvResponseBodyMerchantAccountInformation, required
      - `url` string — Merchant URL.
      - `gui` string — Merchant GUI.
      - `merchantCategoryCode` string, required — Merchant category code.
      - `additionaldata` object — Additional merchant data.
      - `withdrawalServiceProvider` object — Withdrawal service provider.
      - `merchantName` string, required — Merchant name.
      - `merchantCity` string, required — Merchant city.
      - `postalCode` string — Merchant postal code.
    - `key` string, required — PIX key of the receiver.
    - `amount` EmvResponseBodyAmount, required
      - `original` string, required — Original transaction amount.
      - `abatement` string — Abatement amount.
      - `discount` string — Discount amount.
      - `interest` string — Interest amount.
      - `final` string, required — Final transaction amount.
      - `fine` string — Fine amount.
      - `canModifyFinalAmount` boolean, required — Indicates if the final amount can be modified.
      - `withdrawal` boolean — Indicates if the amount is for withdrawal.
      - `change` boolean — Indicates if the amount is for change.
    - `transactionIdentification` string, required — Transaction identification.
    - `payload` string — Additional transaction payload.

## Other responses

- `401` — Authentication is required to access this resource. The client must provide valid credentials.
- `403` — The server understood the request but refuses to authorize it. Access is permanently forbidden and tied to the application logic.
- `409` — The request conflicts with the current state of the resource on the server.
- `422` — The request contains invalid or malformed data that cannot be processed.
- `500` — An unexpected error occurred on the server while processing the request.
- `default` — Unexpected error.

---

[API](https://skmtc.net/celcoin/apis/api-para-transa-es.md) · [All operations](https://skmtc.net/celcoin/apis/api-para-transa-es/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/celcoin/api-para-transa-es/revisions/85dd6188a37b/schema)