Orangepill Cloud

Bre-B Quickstart

Accept instant bank transfers in Colombia with Bre-B. Real-time confirmation, 24/7 availability.

What you’ll build

  • Create Bre-B payment request
  • Customer pays from any bank app
  • Receive instant confirmation webhook
  • Complete order fulfillment

Quick example

curl https://api.orangepill.cloud/v1/payment-requests \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 50000,
    "currency": "COP",
    "payment_method_types": ["bre_b"],
    "customer": {
      "email": "[email protected]",
      "phone": "+573001234567"
    },
    "metadata": {
      "order_id": "order_123"
    }
  }'

Response:

{
  "id": "preq_abc123",
  "status": "pending",
  "amount": 50000,
  "currency": "COP",
  "payment_url": "https://checkout.orangepill.cloud/preq_abc123",
  "expires_at": "2024-01-15T10:30:00Z"
}

Customer experience

  1. Customer clicks payment link
  2. Selects bank (Bancolombia, Davivienda, etc.)
  3. Authenticates in banking app
  4. Confirms payment
  5. Instant confirmation

Supported banks

  • Bancolombia
  • Banco de Bogotá
  • Davivienda
  • BBVA
  • Nequi
  • Daviplata
  • All 20+ Bre-B participant banks

Webhook confirmation

{
  "event": "payment.succeeded",
  "data": {
    "id": "preq_abc123",
    "status": "succeeded",
    "amount": 50000,
    "currency": "COP",
    "payment_method": "bre_b",
    "metadata": {
      "order_id": "order_123"
    }
  }
}

Next steps