O link de pagamento resolve muitas vendas, mas chega uma hora em que o negócio pede mais: cobrar direto no site, no app ou no ERP, sem copiar e colar nada. É aí que entra a API de pagamentos.
O que é uma API de pagamentos
API (interface de programação de aplicações) é a porta de comunicação entre o seu sistema e a plataforma de pagamentos. Com ela, o seu software cria cobranças, acompanha o status e recebe confirmações de forma automática, usando requisições HTTP com dados em JSON.
Como funciona a integração, passo a passo
- Crie a conta e gere as chaves: no painel da Sila Pay, o menu API Key gera a sua api-key e a sua secret-key, enviadas no header de cada requisição.
- Crie a cobrança: o seu sistema envia um POST para https://api.silapay.pro/v1/transactions com o valor, os dados do cliente e o meio de pagamento (pix, creditCard ou billet).
- Mostre o pagamento ao cliente: no Pix, a resposta traz o código copia e cola; no boleto, a cobrança é emitida com o vencimento definido; no cartão, você recebe o resultado da transação.
- Receba a confirmação: informe uma postbackUrl e o seu sistema é avisado por webhook quando o pagamento mudar de status.
Pix, cartão e boleto: o que muda em cada um
- Pix: a cobrança é criada com status pendente e um código copia e cola; a confirmação chega por webhook assim que o pagamento é identificado.
- Cartão de crédito: aceita parcelamento, informando o número de parcelas na requisição, e pode levar o cliente a uma página de sucesso (successUrl).
- Boleto: você define o vencimento e pode enviar uma referência própria (externalReference) para ligar a cobrança ao pedido.
Vantagens de integrar por API
- Experiência sob seu controle: você decide onde e como a cobrança aparece para o cliente.
- Menos trabalho manual: pedidos criados e confirmados automaticamente.
- Uma integração, três meios de pagamento: Pix, cartão e boleto no mesmo endpoint.
- Cresce junto com o negócio: o mesmo fluxo atende poucos ou muitos pedidos por dia.
Quer integrar pagamentos ao seu sistema? Crie sua conta na Sila Pay
Boas práticas na integração
- Chaves só no servidor: nunca coloque a api-key e a secret-key no front-end ou no app; as chamadas devem sair do seu back-end.
- Valide os webhooks: confira o header X-Silapay-Signature antes de dar baixa no pedido.
- Guarde o ID da transação: relacione o id retornado pela API ao pedido do seu sistema.
- Trate erros e tempo limite: mostre uma mensagem clara e permita tentar de novo sem duplicar a cobrança.
- Comece com valores baixos: teste o fluxo completo antes de liberar para todos os clientes.
Perguntas frequentes
Preciso de um desenvolvedor?
Para integrar pela API, sim: alguém precisa programar as chamadas no seu sistema. Se você usa WooCommerce ou Shopify, os plugins da Sila Pay são um caminho mais simples; e, sem site, o link de pagamento já resolve.
Onde está a documentação?
Em doc.silapay.pro, com as chamadas de Pix, cartão, boleto, saldo e webhooks, além de exemplos de requisição e resposta.
A API serve só para receber?
Não. Além de criar cobranças, a documentação descreve o envio de Pix (cash-out) e a consulta de saldo.
Preciso de CNPJ?
Na Sila Pay você pode vender como pessoa física ou jurídica; o cadastro indica os documentos necessários para cada caso.
Integre Pix, cartão e boleto com uma única API. Cadastre-se na Sila Pay