Listar pedidos

Lista os pedidos da loja, do mais novo ao mais antigo, com filtro por status e cliente.

Permissão da chave: Pedidos › ler.

Autenticação

bearer

headerAuthorizationBearer <chave de API>

Chave de API da loja (Painel › Integrações › Chaves de API)

Parâmetros da URL

status?string

Valor em"EXPIRED""CANCELED""OPEN""PAID""PARTIALLY_REFUNDED""REFUNDED"

paid?boolean

paidFrom?string

paidTo?string

source?string

Valor em"STOREFRONT""PLUGIN""API""PAYMENT_LINK""SUBSCRIPTION""DISCORD""MANUAL"

customerId?string

state?string

Valor em"paid""open""closed"

q?string

Tamanho1 <= length <= 100

method?string

Valor em"PIX""PIX_AUTOMATIC""CARD""BOLETO"

paymentLinkId?string

subscriptionId?string

delivery?string

Valor em"pending""failed"

dispute?"open"

Valor em"open"

createdFrom?string

createdTo?string

Corpo da resposta

application/json

Exemplo de requisição

curl -X GET "https://api.rivoo.gg/v1/orders?status=EXPIRED&paidFrom=2026-11-01T00%3A00%3A00.000Z&paidTo=2026-11-01T00%3A00%3A00.000Z&source=STOREFRONT&customerId=cus_mhexample0000steve00001&state=paid&q=pedido_123&method=PIX&paymentLinkId=plink_mhexample0000vip00001&subscriptionId=sub_mhexample0000vip0000001&delivery=pending&dispute=open&createdFrom=2026-11-01T00%3A00%3A00.000Z&createdTo=2026-11-01T00%3A00%3A00.000Z" \
  -H "Authorization: Bearer $RIVOO_API_KEY"

Exemplo de requisição

curl -X GET "https://api.rivoo.gg/v1/orders?status=EXPIRED&paidFrom=2026-11-01T00%3A00%3A00.000Z&paidTo=2026-11-01T00%3A00%3A00.000Z&source=STOREFRONT&customerId=cus_mhexample0000steve00001&state=paid&q=pedido_123&method=PIX&paymentLinkId=plink_mhexample0000vip00001&subscriptionId=sub_mhexample0000vip0000001&delivery=pending&dispute=open&createdFrom=2026-11-01T00%3A00%3A00.000Z&createdTo=2026-11-01T00%3A00%3A00.000Z" \  -H "Authorization: Bearer $RIVOO_API_KEY"

Exemplo de resposta

{
  "data": [
    {
      "id": "ord_mhexample0000vip0000001",
      "source": "API",
      "status": "PAID",
      "customerId": "cus_mhexample0000steve00001",
      "externalId": "pedido_123",
      "recipient": {
        "kind": "MINECRAFT",
        "ref": "Steve",
        "name": "Steve"
      },
      "items": [
        {
          "id": "oitem_mhexample0000vip00001",
          "productId": "prod_mhexample0000vip00001",
          "priceId": "price_mhexample0000vip0001",
          "name": "VIP+ 30 dias",
          "quantity": 1,
          "unitAmount": {
            "amount": 2990,
            "currency": "BRL"
          },
          "total": {
            "amount": 2990,
            "currency": "BRL"
          },
          "adjustments": [],
          "recipient": null,
          "gift": null
        }
      ],
      "totals": {
        "subtotal": {
          "amount": 2990,
          "currency": "BRL"
        },
        "discount": {
          "amount": 0,
          "currency": "BRL"
        },
        "giftCard": {
          "amount": 0,
          "currency": "BRL"
        },
        "total": {
          "amount": 2990,
          "currency": "BRL"
        },
        "refunded": {
          "amount": 0,
          "currency": "BRL"
        }
      },
      "allowedMethods": [
        "PIX",
        "CARD",
        "BOLETO"
      ],
      "paidByPaymentId": "pay_mhexample0000vip0000001",
      "note": null,
      "metadata": {
        "pedido": "123"
      },
      "customer": {
        "id": "cus_mhexample0000steve00001",
        "name": "Steve",
        "email": "[email protected]"
      },
      "expiresAt": "2026-11-01T21:04:13.000Z",
      "paidAt": "2026-10-31T21:04:51.000Z",
      "expiredAt": null,
      "canceledAt": null,
      "createdAt": "2026-10-31T21:04:13.000Z",
      "method": "PIX",
      "paymentLink": null,
      "dispute": null,
      "delivery": "done"
    }
  ],
  "hasMore": false,
  "totalCount": 1
}

{  "data": [    {      "id": "ord_mhexample0000vip0000001",      "source": "API",      "status": "PAID",      "customerId": "cus_mhexample0000steve00001",      "externalId": "pedido_123",      "recipient": {        "kind": "MINECRAFT",        "ref": "Steve",        "name": "Steve"      },      "items": [        {          "id": "oitem_mhexample0000vip00001",          "productId": "prod_mhexample0000vip00001",          "priceId": "price_mhexample0000vip0001",          "name": "VIP+ 30 dias",          "quantity": 1,          "unitAmount": {            "amount": 2990,            "currency": "BRL"          },          "total": {            "amount": 2990,            "currency": "BRL"          },          "adjustments": [],          "recipient": null,          "gift": null        }      ],      "totals": {        "subtotal": {          "amount": 2990,          "currency": "BRL"        },        "discount": {          "amount": 0,          "currency": "BRL"        },        "giftCard": {          "amount": 0,          "currency": "BRL"        },        "total": {          "amount": 2990,          "currency": "BRL"        },        "refunded": {          "amount": 0,          "currency": "BRL"        }      },      "allowedMethods": [        "PIX",        "CARD",        "BOLETO"      ],      "paidByPaymentId": "pay_mhexample0000vip0000001",      "note": null,      "metadata": {        "pedido": "123"      },      "customer": {        "id": "cus_mhexample0000steve00001",        "name": "Steve",        "email": "[email protected]"      },      "expiresAt": "2026-11-01T21:04:13.000Z",      "paidAt": "2026-10-31T21:04:51.000Z",      "expiredAt": null,      "canceledAt": null,      "createdAt": "2026-10-31T21:04:13.000Z",      "method": "PIX",      "paymentLink": null,      "dispute": null,      "delivery": "done"    }  ],  "hasMore": false,  "totalCount": 1}

AutenticaçãoCopiar link

Parâmetros da URLCopiar link

Corpo da respostaCopiar link

Autenticação

Parâmetros da URL

Corpo da resposta