v1

latestOpenAPI 3.0.12026-07-245303882.5 MB

Payment Initiation

Get PIX payment initiation by ID

Retrieves a specific PIX payment initiation by its unique identifier. Returns detailed payment information including status, amount, creditor data, and execution details according to Open Finance Brasil specifications.

get/open-keys/itp/api/v2/payments/v4/payment-initiation/{id}

Path parameters

idstring required

ID is the unique identifier of ITP

Response

PIX payment initiation details successfully returned.

idstring required

ID is the unique identifier of ITP

paymentInitiationApi'PAYMENTS_V4' required

Payment initiation API version identifier. Specifies which version of the Open Finance Brasil payment initiation API specification is being used for this transaction. Currently supports only PAYMENTS_V4 according to Central Bank of Brazil regulations.

createdAtstring required

Record creation date and time

updatedAtstring required

Record last update date and time

deletedAtstring required

Record deletion date and time (soft delete)

brandIdstring required

ID is the unique identifier of brand

journeySessionIdstring

ID is the unique identifier of journey

redirectUrlstring uri

The redirect URI authorized by the application.

directoryCallbackboolean

Indicates if the redirect is direct from the directory

tagsstring

Custom tags for payment initiation categorization and tracking. Allows classifying transactions by specific business criteria such as origin channel, marketing campaign, customer type, etc. Limitations applied to avoid conflicts with system reserved parameters.

applicationIdstring required

Unique identifier of the payment initiator application registered in the Open Finance Brasil directory. Corresponds to the software_statement_id registered during the DCR (Dynamic Client Registration) process.

tokenIdstring required

Unique identifier of the access token for the payment session

authorizationUrlstring uri required

Authorization URL for consent with the account holder institution

ofConsentIdstring required

Unique identifier of the Open Finance consent

idempotencyKeystring required

Idempotency key used to ensure duplicate requests are not processed multiple times. Prevents duplicate transactions in case of network failures or timeouts. Should be a unique UUID per transaction.

Example response

{
  "paymentInitiationApi": "PAYMENTS_V4",
  "createdAt": "2024-01-01T20:32:44.581Z",
  "updatedAt": "2024-01-01T20:32:44.581Z",
  "deletedAt": "2024-01-01T20:32:44.581Z",
  "journeySessionId": "f362a873-c127-4122-b711-a37b24a36914",
  "redirectUrl": "https://example.com",
  "enrollment": {
    "platform": "ANDROID"
  },
  "data": {
    "loggedUser": {
      "document": {
        "identification": "11122233344",
        "rel": "CPF"
      }
    },
    "businessEntity": {
      "document": {
        "identification": "00000000000191",
        "rel": "CNPJ"
      }
    },
    "creditor": {
      "cpfCnpj": "12345678000199",
      "personType": "PESSOA_JURIDICA",
      "name": "João da Silva Santos"
    },
    "payment": {
      "type": "PIX",
      "schedule": {
        "single": {
          "date": "2023-08-23"
        },
        "daily": {
          "startDate": "2023-08-23"
        },
        "weekly": {
          "dayOfWeek": "QUINTA_FEIRA",
          "startDate": "2023-08-23"
        },
        "monthly": {
          "startDate": "2023-08-23"
        },
        "custom": {
          "additionalInformation": "Todas quintas e domingos por 6 meses"
        }
      },
      "date": "2024-03-05",
      "currency": "BRL",
      "amount": "1.12",
      "ibgeTownCode": "5300108",
      "details": {
        "localInstrument": "DICT",
        "qrCode": "\n\t\t\t\t\t\t  00020104141234567890123426660014BR.GOV.BCB.PIX014466756C616E6F32303139406578616D706C652E636F6D27300012\n\t\t\t\t\t\t  BR.COM.OUTRO011001234567895204000053039865406123.455802BR5915NOMEDORECEBEDOR6008BRASILIA61087007490062\n\t\t\t\t\t\t  530515RP12345678-201950300017BR.GOV.BCB.BRCODE01051.0.080450014BR.GOV.BCB.PIX0123PADRAO.URL.PIX/0123AB\n\t\t\t\t\t\t  CD81390012BR.COM.OUTRO01190123.ABCD.3456.WXYZ6304EB76",
        "proxy": "11223344556",
        "creditorAccount": {
          "accountType": "CACC",
          "ispb": "00000000",
          "issuer": "0001",
          "number": "0001234567"
        }
      }
    },
    "debtorAccount": {
      "accountType": "CACC",
      "ispb": "00000000",
      "issuer": "0001",
      "number": "0001234567"
    },
    "remittanceInformation": "Pagamento da nota XPTO035-002"
  },
  "journeySession": {
    "createdAt": "2024-01-01T20:32:44.581Z",
    "updatedAt": "2024-01-01T20:32:44.581Z",
    "deletedAt": "2024-01-01T20:32:44.581Z",
    "settings": [
      {
        "key": "JOURNEY_RULES"
      }
    ]
  },
  "authorizationUrl": "https://example.com",
  "ofConsent": {
    "authorization_url": "https://example.com",
    "status": "AWAITING_AUTHORISATION",
    "organizationLogo": "https://example.com",
    "redirect_uri": "https://example.com",
    "consentTerm": 0.123,
    "creditor": {
      "cpfCnpj": "12345678000199",
      "personType": "PESSOA_JURIDICA",
      "name": "João da Silva Santos"
    },
    "loggedUser": {
      "document": {
        "identification": "11122233344",
        "rel": "CPF"
      }
    },
    "payment": {
      "type": "PIX",
      "date": "2025-08-05",
      "currency": "BRL",
      "amount": "10.00",
      "details": {
        "localInstrument": "DICT",
        "proxy": "usuario@ficticio.com",
        "creditorAccount": {
          "ispb": "00000000",
          "issuer": "0001",
          "number": "0001234567",
          "accountType": "CACC"
        }
      }
    },
    "rejectionReason": {
      "code": "TEMPO_EXPIRADO_AUTORIZACAO"
    }
  },
  "ofPayments": [
    {
      "localInstrument": "DICT",
      "payment": {
        "currency": "BRL",
        "amount": "1.00"
      },
      "creditorAccount": {
        "number": "1234567890",
        "accountType": "CACC",
        "ispb": "12345678",
        "issuer": "1774"
      },
      "cnpjInitiator": "13935893000109",
      "proxy": "cliente-a00001@pix.bcb.gov.br",
      "endToEndId": "E13935893202511021042TKe1h8bM2FO",
      "authorisationFlow": "FIDO_FLOW",
      "creationDateTime": "2025-11-13T21:41:49Z",
      "debtorAccount": {
        "ispb": "12345678",
        "issuer": "0001",
        "number": "969139",
        "accountType": "CACC"
      },
      "paymentId": "9917ab8f-e134-490b-b2b5-59ecd4e0abd0",
      "status": "ACSC",
      "statusUpdateDateTime": "2025-11-13T21:41:56Z"
    }
  ],
  "httpCalls": [
    {
      "response": {
        "status": "200",
        "statusText": "OK"
      },
      "createdAt": "2024-01-01T20:32:44.581Z",
      "updatedAt": "2024-01-01T20:32:44.581Z",
      "deletedAt": "2024-01-01T20:32:44.581Z"
    }
  ]
}