Skip to content

Check transaction status

GET
/order/v1/order/{id}

You can check the transaction status at any time.

NOTE: Please, to authenticate use the scope: “api://app-order-prd”

id
required
string

The resource was returned successfully

object
id
required

The id of the order of which to retrieve the details.

string
Example
de05f0db-e6a3-462e-8f1c-8dc8dd07c278
idempotencyKey
required

The idempotency key of the order.

string
Example
de05f0db-e6a3-462e-8f1c-8dc8dd07c278
code
required

Order id in your system.

string
Example
order_id_in_your_system
status

Order status.

string
Allowed values: INITIAL PENDING PAID EXPIRED ANALYSIS REFUNDED PARTIAL_REFUNDED PARTIALLY_PAID CANCELED ERROR
Example
PAID
customer
required

The customer info.

object
fullName
required

The name of the customer, e.g.: [John Doe] or [Acme Corporation].

string
Example
John Doe
email
required

The e-mail address of the Customer.

string
Example
John.doe@acme.com
type
required

The type of the Customer.

string
Allowed values: INDIVIDUAL ORGANIZATION
Example
INDIVIDUAL
document
required

The document of the Customer.

object
type
required

Type of document, used when providing an ID number.

----------------------------
Brasil
----------------------------
CPF
CNPJ
OTHERS

----------------------------
Mexico
----------------------------
CURP,
RFC
string
Allowed values: CPF CNPJ OTHERS CURP RFC
Example
CPF
number
required

The number in the document.

string
Example
81985010020
amount
required

Amount of the order

object
currency
required

Currency

string
Allowed values: BRL USD USDT BUSD
Example
BRL
value
required

The amount of the transaction, in minor units. Minor Units Format ------------------ All amount values must be formatted in that currency’s smallest unit. Two-decimal currency (for example Real): R$ 10,95 BRL, amount will be “10.95”. Two-decimal currency (for example US Dollars): $10.95 USD, amount will be “10.95”. Zero-decimal currency (for example Japanese Yen): ¥1095 JPY, amount will be “1095”. Click here to download the latest official ISO 4217 Currency Table, with Minor Units (number of decimal places) per currency

string
Example
10.95
baseAmount
required

Amount of the order

object
currency
required

Currency

string
Allowed values: BRL USD USDT BUSD
Example
BRL
value
required

The amount of the transaction, in minor units. Minor Units Format ------------------ All amount values must be formatted in that currency’s smallest unit. Two-decimal currency (for example Real): R$ 10,95 BRL, amount will be “10.95”. Two-decimal currency (for example US Dollars): $10.95 USD, amount will be “10.95”. Zero-decimal currency (for example Japanese Yen): ¥1095 JPY, amount will be “1095”. Click here to download the latest official ISO 4217 Currency Table, with Minor Units (number of decimal places) per currency

string
Example
10.95
createdAt
required

The date the order was created.

string
Example
2022-12-17T11:35:01.045Z
paidAt

The date the order was paid.

string
Example
2022-12-17T11:35:51.923Z
refundedAt

The date the order was refunded.

string
Example
2022-12-18T112:33:00.287Z
expiredAt

The date the order was expired.

string
Example
2022-12-18T112:33:00.287Z
compensatedAt

The date the order was compensated.

string
Example
2022-12-18T112:33:00.287Z
settledAt

The date the order was settled.

string
Example
2022-12-18T112:33:00.287Z
paymentMethod
required

Payment method.

string
Allowed values: PIX DEPOSIT BOLETO BINANCE_PAY CREDIT_CARD SPEI OXXO PAYNET
Example
BINANCE_PAY
payment
required

The payment info.

object
id

The id of the order of which to retrieve the details.

string
Example
f103c839-6a95-42cb-a889-371bbe540d3f
qrcodeLink

Link image qrCode.

string
Example
https://public.bnbstatic.com/static/payment/20221217/cf16107e-cb98-4dca-9dcb-1ce2aa814057.jpg
qrcodeData

Data of qrcode.

string
Example
https://dependable-viability.info
qrcodeBase64

Base64 of image qrCode.

string
Example
/9j/4AAQ8DaxNqel3eoyzy27W7LdSIy7SytkbUU5yg7+td9QAUUUUAFFFFABRRRQAooooAKKKKACiiigD/2Q==
deeplink

Deeplink to open binance app to payment.

string
Example
bnc://app.binance.com/payment/secpay?tempToken=R1iUiVRLcMXPboLsiU8KkLytFgUI40MA&returnLink=https://pay.binance.com/en/checkout/bcba8fa221cf4aea9f2822a8865ed1ce
universalUrl

Universal url to finish the payment.

string
Example
https://app.binance.com/payment/secpay?linkToken=a0f04c0786464e818d13c3c16efec196&_dp=Ym5jOi8vYXBwLmJpbmFuY2UuY29tL3BheW1lbnQvc2VjcGF5P3RlbXBUb2tlbj1GR3FNRE10bDJaNGFkMzlsN0J1VjU5Zm9qYTNHalMxNyZyZXR1cm5MaW5rPWh0dHBzOi8vcGF5LmJpbmFuY2UuY29tL2VuL2NoZWNrb3V0L2EwZjA0YzA3ODY0NjRlODE4ZDEzYzNjMTZlZmVjMTk2
returnUrl

The URL for order return after payment Done

string
Example
http://www.yourwebsite.com/payment_done
barcode

The barcode of Boleto

string
expireDateTime

QrCode expiration DateTime

string
digitableLine

The digitable line of Boleto

string
token

Payment token used by the payment provider.

string
feeAdd
required

Aditional fee

string
Example
2022-12-17T11:35:01.045Z
feeFix
required

Fixed fee

string
Example
2022-12-17T11:35:01.045Z
feeVar
required

Variable fee

string
Example
2022-12-17T11:35:01.045Z
amountClient
required

Amount with tax

string
financialPartner
required

The financial Partner of the order.

string
canceledAt
required

The date the order was canceled

string
Example
2022-12-18T112:33:00.287Z
errorMessage
required

The error message of the order.

string
ownerBank
The owner information.
PS: This field is optional, not all payment methods have this information.
object
name

The name of the owner.

string
Example
John Doe
document

The document of the owner.

string
Example
12345678901
bank

The bank information of owner.

object
name

The bank name.

string
Example
Financial Bank
ispb

The bank ISPB code.

string
Example
00123876
code

The bank code, like COMPE.

string
Example
123
account

The account number.

string
Example
12345-2
branch

The branch account number.

string
Example
0001
pix

The pix.

object
type
required

The type of pix

string
Allowed values: CPF CNPJ EMAIL PHONE RANDOM
Example
CPF
key
required

The key of pix

string
Example
1234567890
payer
The payer information.
PS: This field is optional, not all payment methods have this information.
object
name

Payer name

string
Example
John Doe
document

Payer document

object
type
required

The type of document

string
Allowed values: CPF CNPJ RUC DNI PASSPORT
Example
CPF
number
required

The number of document

string
Example
12345678901
bank

Payer bank data

object
ispb

Bank ISPB number

string
Example
12345678
name

Bank name

string
Example
Bank name
branch

Bank branch account number

string
Example
1234
account

Bank account number

string
Example
123456
accountType

Bank account type

string
Allowed values: CHECKING_ACCOUNT WAGE_ACCOUNT SAVINGS_ACCOUNT PAYMENT_ACCOUNT
Example
CHECKING_ACCOUNT
code

Bank code (COMPE)

string
Example
341
pix

Bank pix data

object
type
required

The type of pix

string
Allowed values: CPF CNPJ EMAIL PHONE RANDOM
Example
CPF
key
required

The key of pix

string
Example
1234567890
batch

Batch information when this order was split into a batch

object
id
required

Id of the batch

string
Example
5160c73e-8b9b-4f1f-8c64-0edcbb97c335
transactionsCount
required

Total number of child transactions in the batch

number
Example
3
paidCount
required

Number of child transactions already paid

number
Example
2
failedCount
required

Number of child transactions that failed

number
Example
1
pendingCount
required

Number of child transactions still pending

number
0
paidAmount
required

Amount already paid across all child transactions

string
Example
30000.00
pendingAmount
required

Amount still pending across all child transactions

string
Example
15000.00
transactions
required

Child transactions the batch was split into

Array<object>
object
id
required

Id of this child transaction

string
Example
a4cf980e-f66d-4321-b0f2-95c7eecca7ce
idempotencyKey
required

Idempotency key of this child transaction - the first child reuses the batch idempotencyKey verbatim, later ones suffix it

string
Example
bf8b0b1f-f444-40c5-b657-d236ee03e6ba-01
sequence
required

Ordering position of this child transaction within the batch

number
Example
1
amount
required

Amount of this child transaction

string
Example
15000.00
status
required

Status of this child transaction

string
Allowed values: INITIAL PENDING PAID EXPIRED ANALYSIS REFUNDED PARTIAL_REFUNDED PARTIALLY_PAID CANCELED ERROR
Example
PAID
endToEndId

End-to-end id of this child transaction

string
Example
E69467793202607101200Je8IkFT5JQS
paidAt

Date this child transaction was paid

string
Example
2026-07-10T12:01:03.000Z
errorMessage

Error message when this child transaction failed

string
Example
An unexpected error occurred

The request is not valid

Array<string>

Unauthorized Request

Array<string>

Resource not found

Array<string>

An unexpected error occurred inside the server

Array<string>