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.

Android POS SDK — Tap to Pay

Accept card-present payments on the merchant's Android phone. Your server creates payment intents, and your Android app uses the Synapto POS SDK to set up the phone, take payments, and recover unresolved results.

Contact Synapto for SDK access and merchant setup. Start with Tap to Pay Setup, then Tap to Pay Payments. See Android POS SDK for the method reference.

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