Bem-vindo

Integre a API TurbofyPay com clareza desde a primeira chamada

Esta documentacao foi escrita para uso real de integrador: menos friccao, contratos claros e fluxo direto para sair de teste e entrar em producao.

Configurar autenticacao Criar primeira cobranca PIX

O que voce resolve com a TurbofyPay

Cobranca PIX

Crie cobrancas com QR Code e copia e cola para checkout rapido.

Payouts

Envie pagamentos em lote com assinatura HMAC e trilha auditavel.

Webhooks

Receba eventos de ciclo de vida sem depender de polling constante.

Comece em 3 passos

Configure credenciais em Autenticacao.
Emita uma cobranca em Criar cobranca PIX.
Feche o ciclo assincrono em Webhooks.

Jornada de integracao da TurbofyPay em quatro etapas: credenciais, cobranca PIX, webhook e producao.

Visao operacional da jornada recomendada: autenticar, emitir o primeiro PIX, receber eventos assincronos e validar criterios de producao.

Quickstart (5 minutos)

Copie x-client-id e x-client-secret no painel TurbofyPay.
Envie POST /sellers/pix com um x-idempotency-key unico.
Salve o id retornado para conciliacao.
Configure seu endpoint de callback em Webhooks.
Confirme o ciclo completo: cobranca criada, evento recebido e status atualizado.

Exemplo rapido

curl --request POST \
  --url https://api.turbofypay.com/sellers/pix \
  --header "x-client-id: <client-id>" \
  --header "x-client-secret: <client-secret>" \
  --header "x-idempotency-key: pedido-123" \
  --header "Content-Type: application/json" \
  --data '{
    "amountCents": 2990,
    "description": "Pedido #123",
    "externalRef": "pedido-123"
  }'

Como esta docs foi desenhada

Direta ao ponto: cada endpoint responde rapidamente o que enviar e o que esperar.
Consistente: headers, erros e exemplos seguem um mesmo padrao operacional.
Auditavel: orientacoes de idempotencia, assinatura e observabilidade estao no fluxo principal.

Jornada ideal de integracao

Etapa	O que voce quer sentir	O que esta docs entrega
Descoberta	”isso parece confiavel”	Introducao clara, branding limpo e exemplo funcional.
Integracao inicial	”sei por onde comecar”	Quickstart de 5 minutos e autenticacao objetiva.
Primeira execucao	”deu certo”	Resposta explicada, codigos de status e proximos passos.
Escala/operacao	”consigo manter isso”	Webhooks, checklist de producao e troubleshooting.

Proximo passo recomendado

Siga para Autenticacao, valide uma requisicao real e depois avance para a aba API Reference para detalhes por endpoint.

​Integre a API TurbofyPay com clareza desde a primeira chamada

​O que voce resolve com a TurbofyPay

​Cobranca PIX

​Payouts

​Webhooks

​Comece em 3 passos

​Quickstart (5 minutos)

​Exemplo rapido

​Como esta docs foi desenhada

​Jornada ideal de integracao

​Proximo passo recomendado