Introdução

A API da Gravity Pay — crie cobranças, redirecione para o checkout e receba pagamentos por webhook.

A Gravity Pay é 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

https://api.gravitypay.app

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

Gere uma chave de API no painel, em Integrações → API.
Faça uma chamada de teste para criar uma cobrança — veja Cobranças.
Configure como receber os eventos — veja Webhooks.

Ambiente de testes

Chaves gp_test_… e gp_live_… separam teste de produção. Comece pelo teste.