Payment Initiation

Decode PIX EMV string

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.

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

Request

  • Base URL
    https://sandbox.openfinance.celcoin.dev
  • URL
    https://sandbox.openfinance.celcoin.dev/open-keys/itp/api/v2/payments/v4/payment-initiation/pix/emv
  • Auth
    OAuth 2
    Client credentials
    Token URL: http://localhost:8080/auth/realms/master/protocol/openid-connect/token scopes: app

Request body

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

Example request

{
  "emv": "string"
}

Response

PIX EMV string decoded data successfully returned.

versionstring required

Version of the EMV response.

statusnumber double required

Status code of the EMV processing response.

Example response

{
  "version": "1.0.0",
  "status": 200,
  "body": {
    "type": "STATIC",
    "merchantAccountInformation": {
      "merchantCategoryCode": "0000",
      "merchantName": "Joao Silva",
      "merchantCity": "BELO HORIZONTE"
    },
    "key": "usuario@ficticio.com",
    "amount": {
      "original": "100.00",
      "abatement": "0.00",
      "discount": "0.00",
      "interest": "0.00",
      "final": "100.00",
      "fine": "0.00",
      "canModifyFinalAmount": true
    },
    "transactionIdentification": "***"
  }
}

Changes