# Documentação da API GoiabaPay > API de pagamentos Pix. Base URL: https://api.goiabapay.com/v1. Autenticação com chave de API no cabeçalho Authorization: Bearer. ## Documentação ### Começando - [Introdução](https://docs.goiabapay.com/): Receba pagamentos Pix no seu sistema com uma API simples e segura. Veja como funciona e por onde começar. - [Começar em 5 minutos](https://docs.goiabapay.com/comecar-em-5-minutos): Crie uma chave de API, faça o primeiro pagamento Pix e receba a confirmação. - [Autenticação](https://docs.goiabapay.com/autenticacao): Toda chamada usa uma chave de API no cabeçalho Authorization. Cada chave tem escopos que limitam o que ela pode fazer. ### Pagamentos - [Consultar o status da forma correta](https://docs.goiabapay.com/consultar-status): Use o webhook como fonte principal e a consulta por id como reforço, com intervalo mínimo. Veja cada status e o que fazer. ### Dinheiro - [Reembolsos](https://docs.goiabapay.com/reembolsos): Devolva ao cliente o valor de um pagamento, inteiro ou em parte. Todo pedido de reembolso passa por aprovação. - [Infrações](https://docs.goiabapay.com/infracoes): Quando um cliente contesta um Pix no banco dele, o valor contestado fica retido até a análise terminar. - [Saldo e saques](https://docs.goiabapay.com/saldo-e-saques): Veja quanto você tem disponível e saque para a sua chave Pix. Todo saque passa por aprovação. ### Integração - [Webhooks](https://docs.goiabapay.com/webhooks): Receba avisos no seu servidor quando um pagamento, reembolso, saque ou infração muda. Valide a assinatura de cada aviso. - [Idempotência](https://docs.goiabapay.com/idempotencia): Envie o cabeçalho Idempotency-Key em todo POST. Assim uma requisição repetida nunca cria um segundo pagamento. ### Referência - [Erros e códigos](https://docs.goiabapay.com/erros): Toda resposta de erro tem um código estável em inglês e uma mensagem em português. Trate os erros pelo código. - [Limites](https://docs.goiabapay.com/limites): Limites de requisições por chave, tamanhos e valores aceitos pela API. - [Boas práticas de segurança](https://docs.goiabapay.com/seguranca): As regras que protegem o seu dinheiro e os dados dos seus clientes. Siga todas. - [Perguntas frequentes](https://docs.goiabapay.com/perguntas-frequentes): Respostas curtas para as dúvidas mais comuns. ## Referência da API ### Pagamentos - [Criar um pagamento Pix](https://docs.goiabapay.com/criar-pagamento): Cria uma cobrança Pix e devolve o código copia e cola para o cliente pagar. - [Buscar um pagamento](https://docs.goiabapay.com/buscar-pagamento): Devolve o pagamento com o status atual. Use como reforço do webhook, com intervalo mínimo. - [Listar pagamentos e paginação](https://docs.goiabapay.com/listar-pagamentos): Lista os pagamentos da sua conta, do mais novo para o mais antigo, com filtros e paginação por cursor. ### Reembolsos - [Pedir um reembolso](https://docs.goiabapay.com/pedir-reembolso): Pede a devolução de um pagamento pago, inteira ou parcial. O valor fica reservado no seu saldo até a análise. - [Listar reembolsos](https://docs.goiabapay.com/listar-reembolsos): Lista os seus reembolsos, do mais novo para o mais antigo, com filtros e paginação por cursor. - [Buscar um reembolso](https://docs.goiabapay.com/buscar-reembolso): Devolve um reembolso com o status atual. ### Saldo e saques - [Consultar o saldo](https://docs.goiabapay.com/consultar-saldo): Devolve o seu saldo disponível, o valor reservado para pedidos em andamento e o valor retido por infrações. - [Cadastrar a chave Pix de saque](https://docs.goiabapay.com/cadastrar-chave-pix): Cadastra a chave Pix que recebe os seus saques. Pela API, toda chave passa por análise antes de valer. - [Listar as chaves Pix de saque](https://docs.goiabapay.com/listar-chaves-pix): Mostra a chave de saque ativa e, se houver, a troca em análise. - [Pedir um saque](https://docs.goiabapay.com/pedir-saque): Pede um saque do saldo disponível para a sua chave Pix ativa. O valor fica reservado até a análise. - [Simular um saque](https://docs.goiabapay.com/simular-saque): Mostra a taxa e o valor exato que chega na sua chave Pix para um saque, sem pedir o saque. - [Listar saques](https://docs.goiabapay.com/listar-saques): Lista os seus saques, do mais novo para o mais antigo, com filtro de status e paginação por cursor. ### Infrações - [Listar infrações e reembolsos](https://docs.goiabapay.com/listar-infracoes): Lista as infrações (contestações) e os reembolsos concluídos de um período, com filtros e paginação por cursor. - [Buscar uma infração](https://docs.goiabapay.com/buscar-infracao): Devolve uma infração ou um reembolso, com os dados da venda e o histórico. ## Changelog ### Changelog - [Changelog](https://docs.goiabapay.com/changelog): O que mudou na API e nesta documentação. ## Arquivos para ferramentas de IA - [llms-full.txt](https://docs.goiabapay.com/llms-full.txt) - [openapi.json](https://docs.goiabapay.com/openapi.json)