Coinbase Commerce
Quick Start
- Sign up at commerce.coinbase.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
Coinbase Commerce — Official Coinbase API for merchants
| Provider ID | coinbase |
| Category | Crypto & Blockchain |
| Website | commerce.coinbase.com |
Supported operations: Create Charge (payments_authorize) Get Charge (payments_status)
Authentication
Method: API Key (Custom header)
Headers:
x-cc-api-key: {api_key}
x-cc-version: 2018-03-22
Content-Type: application/json
Example:
x-cc-api-key: abc123xyz
x-cc-version: 2018-03-22
⚠️ Important: You must specify the API version in the header x-cc-version!
Configuration
Required Parameters
| Parameter | Description |
|---|---|
base_url | Base API URL |
api_key | API key for authentication |
name | Merchant name (displayed on checkout) |
Status Mapping
| Provider Status | 4pay Status | Description |
|---|---|---|
COMPLETED | Charged | Payment completed |
RESOLVED | Charged | Issue resolved, payment processed |
EXPIRED | Failure | Charge expired |
CANCELED | Voided | Charge cancelled |
REFUNDED | Refunded | Funds returned |
PENDING REFUND | PartiallyRefunded | Refund in progress |
(other) | AuthenticationPending | Awaiting action |