Sua primeira transação
Atualizado
Isto foi útil?
Atualizado
Isto foi útil?
Este guia apresenta a integração básica da API de pagamentos da Barte, focando no essencial para realizar uma transação. Ideal para quem busca um entendimento prático e direto do fluxo principal (o "80/20"), esta abordagem inicial permite iniciar as operações de pagamento de forma simplificada. É importante notar que a Barte oferece diversas outras funcionalidades e recursos avançados que podem ser explorados para modelos de negócio mais complexos e necessidades específicas, como One Buy Click, Pré Captura e Apple Pay, que não estão contemplados neste guia introdutório.
Certifique-se de incluir a chave de API, que foi gerada durante a etapa de Configurações Iniciais, no cabeçalho (header) de cada solicitação. Isso deve ser feito adicionando um campo chamado X-Token-Api.
Caso você esteja integrando a Barte ao seu checkout, esta é a primeira API que deve ser utilizada em usa integração.
Utilizando o método POST em {server}/v2/buyers, você cadastrar o comprador que irá realizar a compra.
Ao final do seu checkout, no momento de finalização da compra do comprador, para gerar uma cobrança pontual, realize uma requisição de POST para /v2/orders.
Além disso, os campos a serem enviados no corpo da requisição, variam de acordo com o método de pagamento da cobrança.
Na geração das orders, um campo adicional deve ser enviado no cabeçalho (header) das requisições: x-idempotency-key. A chave de idempotência deve ser um valor único (preferencialmente do tipo) e deve ser enviado em toda nova requisição. Sua função é garantir que não ocorram cobranças duplicadas de forma indesejada.