Skip to main content
Use this endpoint to retrieve the full list of payment transactions associated with your CertoPay account. Each object in the returned array contains identifying information, the payment method used, the amount in centavos, the current processing status, and timestamps for when the transaction was created and last updated. This is a read-only operation and requires no request body.

​
Endpoint

GET https://v2.certopaybrasil.com/api/transactions

​
Authentication

All requests must include your secret API key in the X-Api-Key header. Keep this key secure and never expose it in client-side code.
​
X-Api-Key
string
required
Your CertoPay secret API key (e.g. sk_live_sua_chave_aqui).

​
Example Request

curl https://v2.certopaybrasil.com/api/transactions \
  -H "X-Api-Key: sk_live_sua_chave_aqui"

​
Response

Returns an array of transaction objects. An empty array ([]) is returned when no transactions exist yet.

​
200 — Success

[
  {
    "id": "uuid-da-transacao",
    "orderId": "uuid-do-pedido",
    "method": "PIX",
    "amount": 29700,
    "status": "PAID",
    "createdAt": "2026-06-26T10:00:00Z",
    "updatedAt": "2026-06-26T10:05:00Z"
  }
]

​
Response Fields

​
id
string
Unique identifier (UUID) for this transaction.
​
orderId
string
UUID of the order associated with this transaction. Use this to correlate a transaction with the corresponding order in your system.
​
method
string
Payment method used for the transaction. Possible values: PIX, BOLETO, CARD.
​
amount
integer
Transaction amount expressed in centavos (e.g. 29700 = R$ 297,00). All monetary values are integers to avoid floating-point rounding issues.
​
status
string
Current status of the transaction (e.g. PAID, PENDING, FAILED, REFUNDED).
​
createdAt
string
ISO 8601 timestamp indicating when the transaction was created (e.g. 2026-06-26T10:00:00Z).
​
updatedAt
string
ISO 8601 timestamp indicating when the transaction record was last updated (e.g. 2026-06-26T10:05:00Z).