Skip to main content
Use this endpoint to fetch the complete details of a single order by its UUID. This is the primary way to check whether a specific charge has been paid, is still pending, or has been cancelled or expired. It is also useful when you need to confirm an order’s amount or linked customer before initiating a payment flow. Pass the order UUID in the URL path where {id} appears.

​
Request

​
X-Api-Key
string
required
Your CertoPay secret API key. Include it in every request as X-Api-Key: sk_live_sua_chave_aqui.
​
id
string
required
The UUID of the order to retrieve. This is the id returned when the order was created via POST /api/orders.
This endpoint accepts no request body.

​
Response

A successful request returns HTTP 200 OK with the full order object.
​
id
string
Unique UUID identifying the order.
​
customerId
string
UUID of the customer linked to this order.
​
amount
integer
Charge amount in centavos (e.g. 29700 = R$ 297,00).
​
status
string
Current payment status of the order. Possible values: "PENDING", "PAID", "CANCELLED", "EXPIRED".
​
createdAt
string
ISO 8601 timestamp of when the order was created.

​
Example

curl https://v2.certopaybrasil.com/api/orders/uuid-do-pedido \
  -H "X-Api-Key: sk_live_sua_chave_aqui"
200 OK
{
  "id": "uuid-do-pedido",
  "customerId": "uuid-do-customer",
  "amount": 29700,
  "status": "PENDING",
  "createdAt": "2026-06-26T10:00:00Z"
}