Bambora
Quick Start
- Sign up at bambora.com and obtain API credentials
- Create a terminal in the Admin Console with the parameters below
- Start processing — the adapter is pre-built and ready to use
Overview
Bambora (Worldline) — Payments (payment processor)
| Provider ID | bambora |
| Category | Card Processors |
| Website | bambora.com |
Supported operations: Sale (payments_authorize - one_phase) Pre-Auth (payments_authorize - two_phase verify) Completion (payments_capture - two_phase commit) Status (payments_status) Refund (payments_refund)
Authentication
Method: Passcode (Base64 encoded)
Header format:
Authorization: Passcode {base64(merchant_id:api_key)}
Example:
import base64
merchant_id = "123456789"
api_key = "passcode_abc"
credentials = f"{merchant_id}:{api_key}"
encoded = base64.b64encode(credentials.encode()).decode()
# Authorization: Passcode {encoded}
⚠️ Important: Used keyword Passcode, not Basic!
Configuration
Required Parameters
| Parameter | Description |
|---|---|
base_url | Base API URL |
merchant_id | Merchant ID |
api_key | API Key (Passcode) |
Status Mapping
| Provider Status | 4pay Status | Description |
|---|---|---|
"1" | Charged | Sale successful |
"1" | Pending | Pre-auth successful |
not "1" | Failure | Transaction declined |
"1" | Success | |
not "1" | Failure |
API Reference
| Method | Endpoint | Description |
|---|---|---|
| POST | /v1/payments | |
| POST | /v1/payments/{payment_id}/completions | |
| GET | /v1/payments/{payment_id} | |
| POST | /v1/payments/{payment_id}/returns |