Criando um Pedido

Na Barte, todo fluxo de cobrança começa pela criação de um pedido (order). O pedido centraliza as informações da compra, como valor, parcelas, método de pagamento e dados do comprador.

Pré-requisito

Antes de criar uma order, é necessário ter criado um comprador (buyer) e utilizar o uuid retornado.

---

Importância do Antifraude

Ao processar pagamentos, é essencial fornecer dados completos de antifraude. A Barte analisa milhares de variáveis para reduzir riscos de:

• Transações não autorizadas.

• Chargebacks.

• Bloqueios de adquirentes e bandeiras.

Recomendações:

• Sempre envie documento (CPF/CNPJ), endereço, e-mail e telefone.

• Evite dados fictícios em produção — isso reduz a taxa de aprovação.

• Utilize informações de billing (endereço de cobrança) reais do portador.

---

Métodos de Pagamento

No campo payment.method, você pode escolher entre:

• CREDIT_CARD → Cartão de crédito.

• DEBIT_CARD → Cartão de débito.

• PIX → Pagamento instantâneo via Pix.

• BANK_SLIP → Boleto bancário.

• CREDIT_CARD_EARLY_SELLER → Antecipação para o vendedor.

• CREDIT_CARD_EARLY_BUYER → Antecipação para o comprador.

Veja mais sobre métodos de pagamento em "Métodos de Pagamento".

Outros parâmetros importantes

• capture: define se a transação deve ser capturada automaticamente após a autorização. (Como funciona a Pré-Captura)

• softDescriptor: texto que aparecerá na fatura do cartão (máx. 13 caracteres).

• installments: número de parcelas (mínimo 1).

---

Metadados

O campo metadata permite anexar informações personalizadas ao pedido, como:

• ID interno da transação.

• Código de referência.

• Qualquer chave de negócio necessária para sua operação.

Esses metadados retornam nas consultas, facilitando conciliações e integrações.

---

Veja um exemplo de requisição em nossa Referência API:

Criar Pedido

---

Boas práticas

• Sempre associe o pedido a um comprador válido.

• Envie dados completos para análise antifraude.

• Utilize metadados para rastrear a transação no seu sistema.

• Teste diferentes métodos de pagamento no sandbox antes de ir para produção.

---

Assim, a criação de pedidos garante maior taxa de aprovação, segurança contra fraudes e flexibilidade para integrar diferentes meios de pagamento na sua aplicação.