Centro de
Integração

1. O seu Ponto de Partida

A arquitetura da PixSplit foi desenhada em rigoroso padrão RESTful. Todas as chamadas à API são autenticadas via cabeçalhos HTTP e os payloads utilizam invariavelmente o formato JSON.

Para interagir com o motor financeiro, necessitará de uma Secret API Key (com o prefixo sk_live_... ou sk_test_...). Poderá gerar e rodar as suas chaves de forma segura através da sua consola, navegando até Chaves de API.

2. O Fluxo de Integração Recomendado

Para garantir que a infraestrutura do seu ERP atinge a conformidade e estabilidade máxima, recomendamos o seguinte fluxo de adoção:

• Ambiente de Testes (Sandbox): Utilize as chaves sk_test no nosso API Playground para gerar transações simuladas e familiarizar-se com a resposta do nosso servidor sem movimentar fundos reais.
• Configuração Assíncrona: Registe a URL do seu sistema de forma segura na aba de Webhooks para receber payloads pix.paid em tempo real.
• Proteção Criptográfica: Em rotas de saque e transferência (Payout B2B), exija que os seus serviços incluam o cabeçalho x-idempotency-key para evitar problemas de concorrência ou duplicação na rede.

3. Bibliotecas Oficiais (SDKs)

Para impulsionar o seu *Time-to-Market*, mantemos bibliotecas robustas e tipadas para as principais linguagens do mercado:

• Node.js: Instale via npm install pixsplit-node (Totalmente compatível com TypeScript e ES Modules).
• Python: Instale via pip install pixsplit-python (Preparado para AsyncIO e Pydantic).
• PHP: Disponível no Packagist via Composer para fácil implementação em sistemas legados.