Synapto Collect Overview

Synapto Collect lets you accept payments from your customers via card payments, checkout sessions, and invoices. This guide helps you choose the integration path that fits your use case.

Make sure you've completed the Quickstart first — you'll need a working API key and account ID.

Checkout sessions — hosted payment page

The fastest way to collect payments. Create a session and redirect your customer to a Synapto-hosted payment page. No frontend code required. The Idempotency-Key header lets you safely retry requests — see Idempotency.

curl -X POST https://api.synaptopay.com/v1/accounts/acct_YOUR_ACCOUNT/checkout-sessions \
  -H "Authorization: Api-Key $API_KEY" \
  -H "Idempotency-Key: YOUR_UNIQUE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "10000",
    "currency": "GBP",
    "success_url": "https://example.com/success"
  }'

The response includes a url — send your customer there to pay.

See Checkout Sessions for the full guide.

Payment intents + JS SDK — custom payment form

For full control over the payment experience, use payment intents with the JS SDK to build your own checkout. This lets you save cards, charge them later, and handle 3D Secure in your own UI. This path requires both an API key (server-side) and a publishable key (client-side).

See Taking Payments and JS SDK to get started.

Invoices — bill customers directly

Create invoices with line items and send them to customers for payment.

See Invoices for the full guide.

Next steps

Checkout Sessions — hosted payment pages with shareable URLs
Taking Payments — collecting payments with payment intents
Customers — creating and managing customers
Saving Cards — securely storing customer payment methods
Invoices — creating and collecting invoices
Subscriptions — recurring billing
Refunds — returning funds to customers
Independent Accounts — creating independent merchant sub-accounts
Collect Webhooks — event types, signatures, retries
Testing — test card numbers and simulating declines