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. Se você vende cursos, a API também lê a sua área de membros: cursos, turmas, alunos, matrículas e o progresso de cada aluno.

​
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.

​
Área de membros

Leia alunos, turmas e progresso

GET /v1/students com as matrículas e a turma de cada aluno, e GET /v1/students/{id}/progress com o progresso por curso e por aula.

​
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, com os escopos que a integração precisa. Veja Autenticação.
  2. Faça uma chamada de teste para criar uma cobrança — veja Cobranças.
  3. Configure como receber os eventos — veja Webhooks.
  4. Para sincronizar alunos e progresso, veja Área de membros.
Ambiente de testes — Chaves gp_test_… e gp_live_… separam teste de produção. Comece pelo teste.