Listar pedidos
curl --request GET \
--url https://api.vertracloud.app/v1/orders \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.vertracloud.app/v1/orders', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.vertracloud.app/v1/orders"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.vertracloud.app/v1/orders"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"response": [
{
"id": "order-abc123",
"status": "paid",
"price": 24.9,
"provider": "pix",
"type": "purchase",
"related_to": { "plan": { "name": "PRO", "duration": 1, "months": 1 } },
"created_at": "2026-08-01T12:00:00.000Z",
"paid_at": "2026-08-01T12:05:00.000Z",
"has_receipt": true
}
]
}
Cobrança
Listar pedidos
Lista os pedidos do usuário autenticado (compras, renovações e upgrades de plano).
GET
/
v1
/
orders
Listar pedidos
curl --request GET \
--url https://api.vertracloud.app/v1/orders \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.vertracloud.app/v1/orders', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.vertracloud.app/v1/orders"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.vertracloud.app/v1/orders"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"response": [
{
"id": "order-abc123",
"status": "paid",
"price": 24.9,
"provider": "pix",
"type": "purchase",
"related_to": { "plan": { "name": "PRO", "duration": 1, "months": 1 } },
"created_at": "2026-08-01T12:00:00.000Z",
"paid_at": "2026-08-01T12:05:00.000Z",
"has_receipt": true
}
]
}
string
Filtra pelo meio de pagamento. Valores possíveis:
pix, card, redeem_code.Resposta
array
Um array de pedidos, do mais recente para o mais antigo.
Mostrar Mostrar objeto
Mostrar Mostrar objeto
string
O ID do pedido.
string
Status do pedido. Valores possíveis:
unpaid, paid, cancelled, expired.number
O preço final cobrado, depois de qualquer desconto de cupom.
string
Como o pedido foi ou será pago. Valores possíveis:
pix, card, redeem_code.string
Para que serve o pedido. Valores possíveis:
purchase, renew, upgrade.object
string
Quando o pedido foi criado.
string | null
Quando o pedido foi pago, ou
null se ainda não foi pago.boolean
Se existe um recibo de pagamento para este pedido. Os recibos ficam disponíveis no histórico de cobrança do painel.
{
"response": [
{
"id": "order-abc123",
"status": "paid",
"price": 24.9,
"provider": "pix",
"type": "purchase",
"related_to": { "plan": { "name": "PRO", "duration": 1, "months": 1 } },
"created_at": "2026-08-01T12:00:00.000Z",
"paid_at": "2026-08-01T12:05:00.000Z",
"has_receipt": true
}
]
}
Respostas de erro
string
O código de erro que indica o motivo da falha. Valores possíveis:
AUTH_TOKEN_MISSING,API_KEY_INVALID,SESSION_REVOKED: o headerAuthorizationestá ausente, a chave de API é inválida ou a sessão do painel foi revogada (401).API_KEY_IP_DENIED,API_KEY_SCOPE_DENIED: a chave de API é usada a partir de um IP fora da sua allowlist, ou não tem o escopo que a rota exige (403).USER_NOT_FOUND: o usuário autenticado não foi encontrado.INTERNAL_SERVER_ERROR: ocorreu um erro inesperado no servidor.
{
"code": "AUTH_TOKEN_MISSING"
}
Última modificação em 28 de outubro de 2026