# API Pix Cakto: um Pix, infinitas conexões

URL: https://www.cakto.com.br/api-pix

Um Pix. Infinitas conexões.

O pagamento que seu cliente conhece, dentro da experiência que você criou. Da cobrança à confirmação, conecte o Pix à sua aplicação.

```
{
  "paymentMethod": "pix",
  "items": [{
    "offerId": "sua_oferta"
  }]
}
```

Atualize o pedido. Continue a experiência.

## Uma oferta. Seu produto.

Crie a cobrança a partir de uma oferta ativa da sua conta. Produto, preço e divisão financeira seguem a configuração da Cakto.

## Copia, cola, paga.

Apresente o código Pix e a validade na interface do seu produto. A API retorna os dados; a experiência leva sua assinatura.

## Uma resposta que conecta.

Receba o evento de pagamento e mantenha sua operação atualizada. Seu sistema acompanha a evolução do pedido.

## Você escreve. O fluxo acontece.

Autentique sua aplicação e envie a oferta com os dados do cliente. Os campos em maiúsculas são valores que você precisa substituir.

```
curl -X POST https://api.cakto.com.br/public_api/payments/ \
  -H "Authorization: Bearer SEU_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -H "X-Idempotency-Key: UUID_DA_OPERACAO" \
  -d '{
  "paymentMethod": "pix",
  "customer": {
    "name": "Maria Souza",
    "email": "maria@example.com",
    "phone": "5511999999999",
    "fingerprint": "SEU_FINGERPRINT",
    "docType": "cpf",
    "docNumber": "CPF_DO_CLIENTE"
  },
  "items": [
    {
      "offerId": "ID_DA_SUA_OFERTA"
    }
  ],
  "pixExpiresIn": 900
}'
```

## Projetada para o mundo real.

### Acesso por escopo

OAuth2 e permissão de escrita em pagamentos para autenticar cada cobrança.

### Repetir com segurança

Uma chave de idempotência identifica a operação nas retentativas de envio.

### Status que faz sentido

Acompanhe o pedido e trate o evento de aprovação antes de liberar a entrega.

### Antes de cobrar, conecte sua conta.

O Pix pela API exige uma conta Cakto Banking ativa, principal e com abertura concluída. Confira a situação no seu painel.

## Antes de começar.

### O que a API Pix retorna?

A criação retorna o pedido e os dados do Pix, incluindo o código copia e cola em pix.qrCode e a expiração. Sua aplicação gera a imagem do QR Code a partir desse código.

### Preciso de uma conta digital Cakto?

Sim. A documentação exige uma conta Cakto Banking com abertura concluída, ativa, principal do produtor e fora de encerramento para criar cobranças Pix pela API.

### Como o valor é definido?

A cobrança usa o ID de uma oferta ativa da sua conta. A API resolve o produto e aplica as configurações de preço e divisão financeira. O exemplo desta página não cria cobranças.

### Como evito cobranças duplicadas?

Use o header obrigatório X-Idempotency-Key e mantenha a mesma chave para retentar a mesma operação com payload idêntico. Consulte o guia para o comportamento de conflitos e erros.

### Como sei que o cliente pagou?

Configure um webhook e valide a origem da notificação. O evento purchase_approved informa a aprovação; faça o processamento de forma idempotente e consulte o pedido quando necessário.

### É a mesma coisa que Pix Automático?

Não. O Pix transacional cria uma cobrança pontual. O Pix Automático inicia uma autorização para cobranças recorrentes futuras e possui um fluxo próprio.

## Sua próxima venda começa aqui.

Você cria. A Cakto cuida do checkout, dos pagamentos e da entrega. Transforme sua próxima ideia em um negócio.