> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gravitypay.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Introdução

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

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

<CardGroup cols={3}>
  <Card title="1 · Crie a cobrança" icon="file-invoice-dollar" href="/charges">
    `POST /v1/charges` com os itens da fatura. Recebe uma `checkoutUrl`.
  </Card>

  <Card title="2 · Leve ao checkout" icon="cart-shopping" href="/checkout">
    Redirecione o cliente para a `checkoutUrl` (ou embuta num iframe).
  </Card>

  <Card title="3 · Receba o webhook" icon="bell" href="/webhooks">
    No pagamento, enviamos `payment.paid` assinado para o seu sistema.
  </Card>
</CardGroup>

## 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

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](/charges).
3. Configure como receber os eventos — veja [Webhooks](/webhooks).

<Note>
  **Ambiente de testes** — Chaves `gp_test_…` e `gp_live_…` separam teste de
  produção. Comece pelo teste.
</Note>