Skip to content

Query Payment by E2E ID

Query payment status by PIX E2E ID.

Endpoint

GET /cashin/pix/check-qrcode

Authentication

Merchant Credential. See Authentication.

Important Notes

WARNING

If the request times out or orderStatus is unavailable, do not infer any order status

Description

  • Make sure to validate payAmount

Request headers

NameInTypeRequiredDescriptionExample
X-NonceheaderstringYesa9f3c1d47e8b9a2c4d1f9e8a7b6c5d4e
X-Merchant-IdheaderstringYes2492265300
X-TimestampheaderstringYes1638123456
DigestheaderstringYesSHA-256=Jr9cX0nM6yT7uF9GQ5G8ZC5M8vRZrQZP9+VbQ8Z8z0Q=
AuthorizationheaderstringYesSignature keyId="m123456",alg="ES256",headers="(request-target) x-timestamp x-nonce digest",signature="MEUCIQD8VxkzR7q5hF3k9dY0v6mKk7K0Nq9nYw+7Ck8LJr9mYAIgC5VQ7J0Z9YqL5F8Wc6E2Yw5qf1z8bYyYcR9kX8pY="

Query parameters

NameInTypeRequiredDescriptionExample
e2eIdquerystringYesBank transaction IDE00416968202309101937aZOHAzv6vkT

Response

HTTP 200 — Success

FieldTypeRequiredDescription
statusintegerYesStatus
msgstringYesMessage
dataobjectYesData

data fields

FieldTypeRequiredDescription
orderStatusstringYesOrder status (enum=PENDING, SUCCESS, FAILED, REFUND)
amountnumberYesOrder amount
feenumberYesFee amount
mchOrderNostringYesMerchant order number
platOrderNostringYesPlatform order number
payerNamestringNoPayer information — Payer name
payerDocumentstringNoPayer CPF or CNPJ
payAmountnumberYesActual paid amount — Actual paid amount
e2eIdstringYesBank ledger ID — Bank transaction ID
applyTimeintegerYesApplication timestamp in seconds
payTimeintegerNoCompletion time — Payment timestamp in seconds
expireTimeintegerYesExpiration timestamp in seconds

Response example

json
{
  "status": 200,
  "msg": null,
  "data": {
    "mchOrderNo": "order_1662112944",
    "platOrderNo": "P5nosqyWAQsQZNtYa5OW",
    "e2eId": "E00416968202309101937aZOHAzv6vkT",
    "orderStatus": "PENDING",
    "amount": 1200,
    "payAmount": 1200,
    "fee": 14,
    "payerName": "Name",
    "payerDocument": "3777882312",
    "payTime": 1670178905,
    "applyTime": 1670178805,
    "expireTime": 1670188805
  }
}