Getting Started

Welcome

This is a payment gateway that lets you accept payments through multiple PSPs with a single integration.

Quick Start

1. Get your API key

Sign up for an account and create an API key from the merchant dashboard.

2. Create a payment session

curl -X POST https://api.settleflow.io/v2/payments \
  -H "X-Api-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 1000,
    "currency": "EUR",
    "reference": "order_123"
  }'

3. Redirect to payment page

Use the hosted_page_url from the response to redirect your customer to the payment page, or use the client_secret with the Hosted Fields SDK for a custom checkout.

4. Handle webhooks

Configure a webhook endpoint to receive payment status updates in real-time.

Next Steps

• Authentication — Authenticate your API requests
• Idempotency — Safely retry requests
• Payment Flow — Understand the payment lifecycle
• Hosted Fields — Collect cards in iframes (SAQ A-EP)
• Payment Links — Get paid with a shareable link, no integration
• Data Exports — Export your payments as CSV
• Webhooks — Receive real-time event notifications
• Error Handling — Error codes and how to react
• API Reference — Full endpoint documentation