Breb Payment Flow

Breb enables payments via bank transfer using a QR code or transfer key. The buyer scans the QR or enters the key in their banking app to complete the payment.

How it works

Create order

Call POST /v1/orders with the buyer’s id_number, id_type, and the Breb gateway ID.

Display QR code and key

The response includes a qr_code (base64-encoded image) and a key (text string). Display both to the buyer — the QR code for scanning, and the key as a fallback for manual entry.

Buyer completes transfer

The buyer opens their banking app, scans the QR code or enters the transfer key, and confirms the payment.

Payment confirmed

Once the transfer is completed, the order status changes to confirmed. You receive a webhook notification, or you can poll for the status.

Required fields

Field	Required	Description
`shopper.id_number`	Yes	Buyer’s national ID (cedula)
`shopper.id_type`	Yes	Document type ID from Document Types
`shopper.email`	Yes	Buyer’s email
`shopper.phone_number`	Yes	Buyer’s phone number
`shopper.country`	Yes	`CO`

Like Daviplata, Breb only accepts the following document types: CC (ID 1), CE (ID 2), and TI (ID 3).

Example request

curl -X POST "https://api.wava.co/v1/orders" \
  -H "merchant-key: YOUR_MERCHANT_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 100000,
    "description": "Invoice payment",
    "currency": "COP",
    "shopper": {
      "first_name": "Carlos",
      "last_name": "Rodriguez",
      "email": "carlos@email.com",
      "phone_number": "+573009876543",
      "country": "CO",
      "id_number": "87654321",
      "id_type": 1
    },
    "payment_gateway": {
      "id_payment_gateway": 9
    },
    "order_key": "invoice-11111"
  }'

Example response

{
  "data": {
    "id_order": 12347,
    "status": "processing",
    "payment_gateway": {
      "breb": {
        "qr_code": "iVBORw0KGgoAAAANSUhEUgAAAQAAAAEA...",
        "key": "BREB-TXN-2025-ABCDEF123456"
      }
    }
  }
}

Displaying the QR code

The qr_code field contains a base64-encoded PNG image. To display it in HTML:

<img src="data:image/png;base64,{qr_code_value}" alt="Payment QR Code" />

Display the key value as text alongside the QR code so the buyer can copy and paste it if they prefer not to scan.

Important notes

The buyer completes payment asynchronously (like Nequi), so you must rely on webhooks or polling for confirmation.
Breb requires the same national ID fields as Daviplata, and only accepts CC, CE, and TI document types.
The QR code and key have a limited validity window. If expired, cancel the order and create a new one.

Getting Started

Orders

Payment Flows

Payment Links

Partners

Webhooks

Integrations

Testing

Error Handling

Breb

Breb Payment Flow

How it works

Required fields

Example request

Example response

Displaying the QR code

Important notes

​Breb Payment Flow

​How it works

​Required fields

​Example request

​Example response

​Displaying the QR code

​Important notes

Breb Payment Flow

How it works

Required fields

Example request

Example response

Displaying the QR code

Important notes