Docs
APIReferênciaPedidos

Devolver em gift card

Devolve o valor do pedido como saldo num gift card, em vez de reembolsar.

Permissão da chave: Reembolsos › escrever.

Autenticação

bearer
headerAuthorizationBearer <chave de API>

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

Parâmetros do caminho

id*string

Headers

Idempotency-Key*string

Chave única por operação (ex.: o id do pedido no seu sistema). Repetir a chamada com a mesma chave devolve a mesma resposta, sem duplicar.

Padrão (regex)^[A-Za-z0-9._:-]+$
Tamanho8 <= length <= 255

Corpo da requisição

application/json
  1. body
amountCents*number
Intervalo100 <= value <= 1000000

Corpo da resposta

Exemplo de requisição
curl -X POST "https://api.rivoo.gg/v1/orders/ord_mhexample0000vip0000001/gift-card-credit" \  -H "Authorization: Bearer $RIVOO_API_KEY" \  -H "Idempotency-Key: pedido_123" \  -H "Content-Type: application/json" \  -d '{"amountCents":100}'
Exemplo de resposta
Vazio

Criar pedido POST

Cria um pedido com produtos do catálogo. Mande o comprador para o `checkoutUrl` da resposta para pagar. Use `Idempotency-Key` para não duplicar. **Permissão da chave:** Pedidos › escrever.

Gift cards usados no pedido GET

Gift cards que pagaram parte ou todo o pedido. **Permissão da chave:** Pedidos › ler.