Criar conta grátis
API Pix Cakto

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.

Integrar PixExplore o código
Da sua aplicação ao pagamento
SEU SERVIDOR
POST/public_api/payments/
{
  "paymentMethod": "pix",
  "items": [{
    "offerId": "sua_oferta"
  }]
}
Requisição autenticada
PixPague com Pix
R$ 197,00
QR Code de demonstração que abre a documentação da API Pix
Aponte a câmera para conhecer a API.
Demonstração · sem cobrança
SUA APLICAÇÃO

Pronta para ouvir.

purchase_approved

Atualize o pedido.
Continue a experiência.

Aguardando confirmação
01

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.

02

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.

03

Uma resposta que conecta.

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

Por trás de um pagamento simples

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.

Referência completa
Criar cobrançacURL
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": "[email protected]",    "phone": "5511999999999",    "fingerprint": "SEU_FINGERPRINT",    "docType": "cpf",    "docNumber": "CPF_DO_CLIENTE"  },  "items": [    {      "offerId": "ID_DA_SUA_OFERTA"    }  ],  "pixExpiresIn": 900}'
O cuidado também está na integração

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.

Conheça a conta
Suas próximas perguntas

Antes de começar.

Central de ajuda
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 vendacomeça aqui.

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

Criar checkout grátisVer recursos da Cakto
Sem mensalidade. Mais espaço para crescer.