Geral

API de pagamentos: como integrar Pix, cartão e boleto ao seu sistema

Guia da API de pagamentos: o que é, como funciona a integração e como cobrar por Pix, cartão de crédito e boleto direto do seu site, app ou sistema.

Por Equipe Sila Pay3 min de leitura
Dois colegas sorrindo conversam ao lado de um notebook em um pequeno escritório

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

  1. 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.
  2. 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).
  3. 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.
  4. 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

#pagamentos#vendas online
CompartilharWhatsAppLinkedInX

Pronto para colocar isso em prática?

Crie sua conta na Sila Pay em minutos e comece a receber por Pix, cartão e link de pagamento.

  • ✓ Cadastro grátis
  • ✓ Sem mensalidade
  • ✓ Recebimento em D+1
Criar conta grátis →

Receba os próximos artigos

Conteúdo prático sobre pagamentos e vendas online, direto no seu e-mail.

Sem spam. Cancele quando quiser.

Leia também

Sila Pay

Tudo o que você precisa para vender em um só lugar.

Comece agora →