Guia Completo: Como Integrar um Gateway de Pagamento via API

FaryPay - Gateway de Pagamentos

Guia Completo: Como Integrar um Gateway de Pagamento via API

Integrar um gateway de pagamento ao seu sistema pode parecer complexo, mas com a abordagem certa, você pode estar recebendo pagamentos em poucas horas. Este guia passo a passo mostra como fazer.

Passo 1: Crie sua Conta e Obtenha as Credenciais

Cadastre-se na FaryPay e acesse o painel. Em Configurações > API, gere seu token de acesso. Guarde-o em local seguro (variável de ambiente, nunca no código-fonte).

Passo 2: Crie uma Cobrança PIX

const response = await fetch("https://farypay.site/api/pix/create", {\n  method: "POST",\n  headers: {\n    "Authorization": "Bearer SEU_TOKEN",\n    "Content-Type": "application/json"\n  },\n  body: JSON.stringify({\n    amount: 99.90,\n    description: "Pedido #1234"\n  })\n});\nconst { qr_code, pix_key } = await response.json();

Passo 3: Exiba o QR Code

Use o qr_code retornado para gerar a imagem do QR Code na sua página de checkout. O pix_key é o código copia-e-cola.

Passo 4: Configure o Webhook

No painel, configure a URL de webhook do seu sistema. Quando o pagamento for confirmado, enviaremos um POST com os dados da transação.

Passo 5: Valide o Pagamento

No seu endpoint de webhook, verifique a assinatura da requisição e atualize o status do pedido no seu banco de dados.

Pronto! Com esses 5 passos, sua integração está completa. A documentação completa da API está disponível no painel da FaryPay.