Pular para o conteúdo
xFlow Payments
EntrarCriar conta

Integrações

Você pode integrar a API Pix da xFlow sem código, com os recursos genéricos de requisição HTTP e webhook do n8n, do Zapier e do Make, ou com assistentes de IA, entregando a eles o llms.txt da documentação. A xFlow não tem app nativo nessas ferramentas.

Para integrar a API Pix da xFlow, você tem dois caminhos além de programar do zero: montar o fluxo numa ferramenta de automação ou pedir o código a um assistente de IA. Os dois partem da mesma API Pix: REST, autenticação HTTP Basic, valores em centavos e webhooks assinados com HMAC-SHA256.

Ferramentas de automação

A xFlow não tem app nativo no n8n, no Zapier nem no Make. A integração usa os recursos genéricos de cada ferramenta:

Ferramenta Criar a cobrança Receber o pagamento
n8n Nó HTTP Request Nó Webhook
Zapier Webhooks by Zapier, Custom Request Webhooks by Zapier, Catch Raw Hook
Make HTTP, Make a request Webhooks, Custom webhook

Em todas, a assinatura do webhook Pix precisa ser conferida antes de dar baixa no pedido. Cada guia mostra como.

Assistentes de IA

A documentação tem uma versão em texto puro para modelos de linguagem, o llms.txt. Com ela, editores e assistentes como Cursor, Claude, Lovable, v0 e Bolt podem gerar o código a partir da API real. O guia traz um prompt de exemplo e o que revisar antes de publicar.

Antes de começar

Gere uma chave de teste e valide o fluxo no sandbox da API Pix, sem mover dinheiro. Para código pronto, veja os exemplos da API Pix. O mapa da documentação está em Desenvolvedores.

SoluçãoIntegrar pagamento Pix com IAPara integrar pagamento Pix com IA, entregue ao assistente o llms.txt da xFlow, a referência da API Pix em texto puro feita para modelos de linguagem, e peça o código com o segredo só no servidor, valores em centavos e validação da assinatura do webhook. Depois, revise o resultado e teste no sandbox.SoluçãoPix no MakeA xFlow não tem app no Make, o antigo Integromat. Você cria a cobrança Pix com o módulo HTTP > Make a request, usando Basic Auth, e recebe o aviso de pagamento com Webhooks > Custom webhook, validando a assinatura com a função sha256 do Make, que devolve um HMAC quando recebe uma chave.SoluçãoPix no n8nA xFlow não tem nó próprio no n8n, e ele não faz falta: o nó HTTP Request cria a cobrança Pix na API, com Basic auth e valores em centavos, e o nó Webhook recebe o aviso de pagamento, que você valida pelo HMAC-SHA256 do corpo antes de dar baixa no pedido.SoluçãoPix no ZapierA xFlow não tem app no Zapier. Para usar Pix no Zapier, você cria a cobrança com a ação Custom Request do Webhooks by Zapier, recebe o aviso de pagamento com o gatilho Catch Raw Hook e confere a assinatura HMAC num passo Code by Zapier antes de seguir.

Perguntas frequentes

A xFlow tem app nativo no n8n, no Zapier ou no Make?

Não. A integração usa os recursos genéricos de cada ferramenta: o nó HTTP Request e o nó Webhook no n8n, o Webhooks by Zapier no Zapier e os apps HTTP e Webhooks no Make.

Preciso saber programar para integrar a API Pix?

Não para a maior parte do fluxo. Criar a cobrança e receber o webhook se faz com os recursos visuais das ferramentas. A conferência da assinatura usa um trecho curto de código ou uma função pronta, mostrados em cada guia.

Por onde começo?

Gere uma chave de teste (pk_test_ e sk_test_) no painel, monte o fluxo e simule o pagamento no sandbox. Nenhum dinheiro real é movimentado.

Continue lendo

SoluçãoAPI PixA API Pix da xFlow Payments é uma API REST para criar cobranças Pix com QR Code e copia e cola, estornar, sacar e receber webhooks assinados. Uma única integração conecta a sua operação a 11 adquirentes, com roteamento por regras e retentativa automática.DesenvolvedoresA documentação da API de pagamentos Pix da xFlow é aberta e fica em app.xflowpayments.com/docs, com uma versão em texto para assistentes de IA no llms.txt. Esta página reúne o caminho para integrar: chaves, sandbox, webhooks, logs e guias técnicos.FerramentaExemplos de código da API PixArquivos prontos para integrar a API Pix da xFlow em Node.js, PHP e Python: criar a cobrança, mostrar o QR Code e o copia e cola, receber o webhook assinado, testar no sandbox e conciliar as cobranças pagas. Licença MIT.BlogWebhook Pix: eventos, assinatura HMAC e boas práticasWebhook Pix é o aviso que a API envia para a sua URL quando algo acontece com uma cobrança ou um saque, como o pagamento confirmado. Na xFlow, cada aviso é um POST JSON assinado com HMAC-SHA256, reenviado até 3 vezes até você responder 2xx.BlogAPI Pix sandbox: como testar sem mover dinheiroO sandbox da API Pix da xFlow funciona com chaves pk_test_ e sk_test_: mesmos endpoints, mesmas respostas com livemode: false, nenhum dinheiro real e um endpoint para simular o pagamento que dispara o webhook transaction.paid.