Link de Pagamento Pontual

O Link de Pagamento Pontual permite criar uma cobrança única através de um checkout hospedado pela Barte. Ao acessar o link, o cliente pode realizar o pagamento utilizando os métodos configurados, sem a necessidade de integração direta com checkout.

Esse tipo de link é indicado para vendas avulsas, cobranças manuais e pagamentos enviados por canais externos.

---

Quando usar Link de Pagamento Pontual?

Utilize esse recurso quando:

• A cobrança for pontual (não recorrente)

• Você não possui checkout próprio

• Precisa enviar cobranças por WhatsApp, e-mail ou redes sociais

• Quer aceitar PIX, cartão e boleto no mesmo link

• Deseja um checkout pronto, seguro e hospedado pela Barte

---

Fluxo de pagamento

Link de pagamento pontual é criado
            ↓
Link é enviado ao cliente
            ↓
Cliente acessa o checkout Barte
            ↓
Pagamento é realizado
            ↓
Status da transação é atualizado
            ↓
Webhook é enviado para seu sistema

💡 A confirmação do pagamento deve ser feita via webhook, independentemente do método de pagamento.

---

Criando um Link de Pagamento Pontual

Endpoint

POST /v2/payment-links

---

Headers obrigatórios

Header	Valor
X-Token-Api	Sua chave de API
Content-Type	application/json

---

Body

{
  "type": "ORDER",
  "scheduledDate": "2026-01-30",
  "paymentOrder": {
    "title": "Link de Pagamento pontual",
    "description": "Cobrança referente ao pedido X",
    "value": 100,
    "installments": 1,
    "timer": true,
    "expirationDate": "2026-02-10T18:00:00",
    "customInstallmentsValues": [
      {
        "paymentMethod": "PIX",
        "installments": 1
      },
      {
        "paymentMethod": "CREDIT_CARD_EARLY_BUYER",
        "installments": 10
      },
      {
        "paymentMethod": "BANK_SLIP",
        "installments": 1
      }
    ]
  },
  "paymentMethods": [
    "PIX",
    "CREDIT_CARD_EARLY_BUYER",
    "BANK_SLIP"
  ]
}

---

Response

Após a criação, a API retorna os dados do link de pagamento.

{
  "id": 9448,
  "uuid": "a1b33060-6fc3-4057-bcd2-19a253c7b90e",
  "type": "ORDER",
  "url": "https://sandbox-checkout.barte.com/payment-link/a1b33060-6fc3-4057-bcd2-19a253c7b90e",
  "scheduledDate": "2026-01-30",
  "paymentOrder": {
    "title": "Link de Pagamento Pontual",
    "description": "Cobrança referente ao pedido X",
    "value": 100,
    "installments": 1,
    "customInstallmentsValues": [
      {
        "paymentMethod": "PIX",
        "installments": 1
      },
      {
        "paymentMethod": "CREDIT_CARD_EARLY_BUYER",
        "installments": 10
      },
      {
        "paymentMethod": "BANK_SLIP",
        "installments": 1
      }
    ],
    "expirationDate": "2026-02-10T18:00:00",
    "timer": true
  },
  "processed": 0,
  "enableAnchoring": false,
  "allowedPaymentMethods": {
    "pixMethod": {},
    "bankSlipMethod": {},
    "creditCardMethod": {
      "type": "EARLY_BUYER"
    }
  },
  "paymentMethods": [
    "PIX",
    "BANK_SLIP",
    "CREDIT_CARD_EARLY_BUYER"
  ],
  "enableBankSlip": true,
  "enableCreditCard": true,
  "enablePixPayment": true,
  "subSellerResponse": [],
  "idSeller": 2890
}

Campo mais importante da resposta

• url → link de pagamento pontual que deve ser enviado ao cliente

---

Confirmação do pagamento

Após o cliente realizar o pagamento:

• O status da transação é atualizado na Barte

• Um webhook é disparado para o seu sistema

Utilize o webhook como fonte de verdade para confirmar o pagamento.

---

Boas práticas

• Utilize sempre expirationDate

• Confirme pagamentos apenas via webhook

• Armazene o uuid do link para rastreabilidade

• Use links pontuais para cobranças únicas

---

O que não fazer

• Confirmar pagamento sem webhook

• Reutilizar links expirados

• Expor sua chave de API no frontend