Skip to main content
A Gravity Play é um orquestrador de pagamentos. Com a API você gera cobranças (charges) diretamente do seu sistema, redireciona o cliente para um checkout hospedado e seguro, e recebe o resultado em tempo real por webhook. Caso clássico: o seu sistema emite uma fatura, chama a nossa API para criar a cobrança, manda o cliente pagar no checkout e, quando o pagamento confirma, recebe um webhook para dar baixa.

Como funciona

1 · Crie a cobrança

POST /v1/charges com os itens da fatura. Recebe uma checkoutUrl.

2 · Leve ao checkout

Redirecione o cliente para a checkoutUrl (ou embuta num iframe).

3 · Receba o webhook

No pagamento, enviamos payment.paid assinado para o seu sistema.

Base URL

Todos os endpoints da API ficam sob o prefixo /v1. As requisições e respostas usam JSON, e os valores monetários são sempre inteiros em centavos (amountInCents).

Primeiros passos

  1. Gere uma chave de API no painel, em Integrações → API.
  2. Faça uma chamada de teste para criar uma cobrança — veja Cobranças.
  3. Configure como receber os eventos — veja Webhooks.
Ambiente de testes — Chaves gp_test_… e gp_live_… separam teste de produção. Comece pelo teste.