Bread Pay
Quick Start
- Sign up at breadpayments.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
Breadpay — Installment for buyers
| Provider ID | breadpay |
| Category | Buy Now, Pay Later |
| Website | breadpayments.com |
Supported operations: Create Cart (payments_authorize) Get Transaction (payments_status) Refund (refund)
Authentication
Method: Basic Auth (api_key:api_secret)
Header format:
Authorization: Basic {base64(api_key:api_secret)}
Example:
import base64
api_key = "api_abc123"
api_secret = "secret_xyz789"
credentials = f"{api_key}:{api_secret}"
encoded = base64.b64encode(credentials.encode()).decode()
# Authorization: Basic {encoded}
Configuration
Required Parameters
| Parameter | Description |
|---|---|
base_url | Base API URL |
api_key | API Key |
api_secret | API Secret |
callback_url | URL for webhooks (optional) |
Status Mapping
| Provider Status | 4pay Status | Description |
|---|---|---|
PENDING | Processing | Transaction processing |
AUTHORIZED | Authorized | Approved, but not completed |
SETTLED | Charged | Transaction completed |
CANCELED | Voided | Transaction cancelled |
REFUNDED | Refunded | Funds returned |
EXPIRED | Failure | Expired |
succeeded | Refunded | |
failed | Failure | |
(other) | PartiallyRefunded |
API Reference
| Method | Endpoint | Description |
|---|---|---|
| POST | /carts | |
| GET | /transactions/{id} | |
| POST | /transactions/actions/{id} |