Payments infra for the AI era
One API for in-store and online payments. PCI DSS 4.0 certified. LLM-ready documentation. Go from signup to a live terminal in under 5 hours.
How can I help you integrate today?
From zero to live in four steps
Create your account
Sign up at the Developer Portal and access the sandbox instantly. No approval process.
2 min
Get your API keys
Generate API credentials from the Console in seconds.
10 min
Build your integration
Use our SDKs, APIs, or AI tools to build and test payments. Use our MCP server or AI assistant to build even faster.
15 min
Go live
Switch to production credentials and start processing real transactions. Our current record is 5 hours from signup to live.
Same day
Create your account
Sign up at the Developer Portal and access the sandbox instantly. No approval process.
2 min
Get your API keys
Generate API credentials from the Console in seconds.
10 min
Build your integration
Use our SDKs, APIs, or AI tools to build and test payments. Use our MCP server or AI assistant to build even faster.
15 min
Go live
Switch to production credentials and start processing real transactions. Our current record is 5 hours from signup to live.
Same day
One platform. Every payment channel.
Integrate once and get access to in-store terminals, online checkout, recurring billing, and more — all through a single API.
Accepting Payments
Tap to Pay on iPhone
Accept contactless payments on iPhone with the iOS SoftPOS SDK. No external hardware required.
Read guide →Android SoftPOS
Turn Android devices into payment terminals with the Android SDK.
Read guide →EMV Terminal
Integrate traditional card-present terminals through a unified API.
Read guide →Inter-App Integration
Integrate your POS app with CheckoutX via native app switch on terminals and Tap to Pay devices.
Read guide →Online Checkout
Payments & Orders
Create an Order
Create orders with line items, tax, and customer details. The starting point for payments.
Read guide →Capture a Payment
Finalize delayed-capture and pre-authorization payments when ready to charge.
Read guide →Cancel a Payment
Stop an in-progress payment before it completes.
Read guide →Void a Payment
Reverse a completed payment before settlement, avoiding refund fees.
Read guide →Refund an Order
Process full refunds by creating return orders with negative quantities.
Read guide →Partial Refund
Refund specific items or reduced amounts from a completed order.
Read guide →Partial Payments
Split an order across multiple payment methods or transactions.
Read guide →Server-to-Server API
Process payments entirely from your backend with tokenization and stored cards.
Read guide →Payment Lifecycle
Manage orders from creation through capture, void, cancel, and refund operations.
Read guide →Recurring Payments
Set up subscriptions and recurring charges with tokenization and stored card tokens.
Read guide →Terminals & Devices
Terminal & Device Management
Register, configure, and manage terminals and devices through the API.
Read guide →Receipts
Generate, email, and print receipts. Supports ESC/POS custom templates.
Read guide →Tips Configuration
Configure tip presets and custom amounts at merchant, store, and terminal levels.
Read guide →NFC Tag Reading
Read NFC and RFID tags on terminals for product identification at checkout.
Read guide →Multi-Merchant Terminals
Share a single terminal across multiple merchants for food courts, events, and more.
Read guide →Merchants & Stores
Merchant Onboarding
Create merchants, trigger KYB verification, and set up stores for in-store and online payments.
Read guide →Store Management
Create, update, and manage stores with domain verification and terminal association.
Read guide →Account & Service Providers
Manage user accounts, roles, and service provider integrations.
Read guide →Commerce & Operations
Gift Cards & Promotions
Create and manage gift cards and store promotions through the API.
Read guide →Product Catalog
Build product catalogs with variants, inventory tracking, and analytics.
Read guide →Settlements & Reporting
Fetch settlement reports, adjustments, and manage merchant charges.
Read guide →Webhooks & Notifications
Receive real-time event updates via webhooks, email, Slack, and SFTP.
Read guide →Configuration & Security
Payment Methods
Activate, deactivate, and manage payment methods like Swish, Klarna, AMEX, and more.
Read guide →Client Auth Tokens
Generate secure client-side tokens for frontend API access without exposing credentials.
Read guide →Partner Branding
Configure white-label colors, fonts, logos, and images for terminals and payment pages.
Read guide →Built for Builders
One API call. Order and payment, handled.
The Carbon API uses an orders-first workflow. Create an order, and the payment is initiated in the same call. No separate charge step, no two-phase orchestration. One POST, one response, done.
// Create order and initiate payment in one call
POST /merchants/:merchantId/orders
{
"terminal$id": "8386af3b0f71b80b04",
"orderLines": [
{
"id": "ITEM123",
"name": "Product",
"quantity": 1,
"amount": {
"total": 10000,
"currency": "752"
}
}
],
"controlFunctions": {
"initiatePaymentsOptions": {
"paymentMethod": "CARD",
"amount": 10000
}
}
}
AI-Powered Development
Build integrations with AI
Surfboard publishes an MCP server and llms.txt so AI coding assistants can read our documentation natively. Point ChatGPT, Claude, or Cursor at our docs and generate working integration code in minutes instead of hours.
~ Ask Claude to integrate Surfboard
"Create an order with Surfboard's Carbon API
and handle the webhook response"
Start building today
Create a free developer account and get instant access to the sandbox. No sales call required.
Get in touch with our team
Have questions about our APIs or need help with your integration? Our developer support team is here to help.