Checkout.com
Quick Start
- Sign up at checkout.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
Checkout.com — Payments (payment gateway)
| Provider ID | checkout |
| Category | Card Processors |
| Website | checkout.com |
Supported operations: Create Payment (payments_authorize) Get Payment (payments_status) Refund (refund)
Authentication
Method: Bearer Token (OAuth2-style)
Header format:
Authorization: Bearer {api_secret}
Example:
Authorization: Bearer sk_test_abc123xyz
Configuration
Required Parameters
| Parameter | Description |
|---|---|
base_url | Base API URL (optional) |
api_secret | Secret Key for authorization |
processing_channel_id | Processing Channel ID |
capture | Auto-capture flag (by default: true) |
Status Mapping
| Provider Status | 4pay Status | Description |
|---|---|---|
Captured | Charged | Payment captured |
Partially Captured | Charged | Partially captured |
Authorized | Charged (capture=true) / Authorized | Authorized |
Pending | AuthenticationPending | Awaiting authentication |
Card Verified | Charged | Card verified |
Refunded | Refunded | Fully refunded |
Partially Refunded | PartiallyRefunded | Partially refunded |
Voided | Voided | Payment annulled |
Canceled | Voided | Payment cancelled |
Expired | Failure | Expired |
Declined | Failure | Declined |
Retry Scheduled | Pending | Retry scheduled |
Testing
Sandbox URL
https://{prefix}.api.sandbox.checkout.com
Test Cards
| Card | Number | Exp | CVV | Result |
|---|---|---|---|---|
| Visa | 4242 4242 4242 4242 | any future | any 3 digits | Approved |
| Mastercard | 5555 5555 5555 4444 | any future | any 3 digits | Approved |
| Amex | 3742 4545 5400 126 | any future | any 4 digits | Approved |
| Declined | 4000 0000 0000 0002 | any future | any 3 digits | Declined |