Skip to main content
Use this endpoint to retrieve every order registered under your CertoPay account. The response is an array of order objects, each showing the linked customer, the charge amount in centavos, the current payment status, and the creation timestamp. This is useful for building reporting dashboards, monitoring pending charges, or reconciling payments against your own order management system.

​
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.
This endpoint accepts no request body or query parameters.

​
Response

A successful request returns HTTP 200 OK with an array of order objects. Each object in the array has the following shape:
​
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 \
  -H "X-Api-Key: sk_live_sua_chave_aqui"
200 OK
[
  {
    "id": "uuid-do-pedido",
    "customerId": "uuid-do-customer",
    "amount": 29700,
    "status": "PAID",
    "createdAt": "2026-06-26T10:00:00Z"
  },
  {
    "id": "uuid-do-pedido-2",
    "customerId": "uuid-do-customer-2",
    "amount": 15000,
    "status": "PENDING",
    "createdAt": "2026-06-25T14:45:00Z"
  }
]