Checkbook.io
Quick Start
- Sign up at checkbook.io 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
Checkbook — Digital Checks, Physical Checks
| Provider ID | checkbook |
| Category | Bank Transfers |
| Website | checkbook.io |
Supported operations: Create Invoice (payments_authorize) Get Invoice (payments_status)
Authentication
Method: Custom (Concatenated Keys)
Header format:
Authorization: {publishable_key}:{secret_key}
Example:
Authorization: pub_abc123:sec_xyz789
⚠️ Important: Keys are simply concatenated via colon, without Base64 encoding!
Configuration
Required Parameters
| Parameter | Description |
|---|---|
base_url | Base API URL |
publishable_key | Publishable Key |
secret_key | Secret Key |
Status Mapping
| Provider Status | 4pay Status | Description |
|---|---|---|
PAID | Charged | Check paid |
MAILED | Charged | Check mailed |
PRINTED | Charged | Check printed |
FAILED | Failure | Processing error |
EXPIRED | Failure | Expired |
VOID | Voided | Check annulled |
UNPAID | Processing | Not paid |
IN_PROCESS | Processing | Processing |
PROCESSING | Processing | Being processed |
API Reference
| Method | Endpoint | Description |
|---|---|---|
| GET | /v3/invoice/{invoiceId} |