Swiftspace API

Appearance

Swiftspace APISeamless Payment Integration

Build secure, scalable payment solutions with our comprehensive API. Support for multiple providers, currencies, and instant settlement.

🚀 Get Started
📚 API Reference
Swiftspace API
🔀

Multi-Provider Mode

Omit the provider parameter to let customers choose their preferred payment provider at checkout for maximum conversion.

đŸŽ¯

Single-Provider Mode

Specify a provider to enforce provider-specific currency and amount validation, creating a seamless single-gateway experience.

⚡

Instant Settlement

Real-time payment processing and webhook notifications to keep your system in sync.

Quick Start ​

Get your first payment up and running in under 5 minutes:

bash
curl -X POST https://app.swiftspace.co/api/v1/payment \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 100.00,
    "currency": "USD",
    "email": "customer@example.com",
    "webhook": "https://your-site.com/webhook"
  }'
javascript
const response = await fetch("https://app.swiftspace.co/api/v1/payment", {
    method: "POST",
    headers: {
        Authorization: "Bearer your-api-key",
        "Content-Type": "application/json",
    },
    body: JSON.stringify({
        amount: 100.0,
        currency: "USD",
        email: "customer@example.com",
        webhook: "https://your-site.com/webhook",
    }),
});
typescript
interface PaymentRequest {
  amount: number;
  currency: string;
  email: string;
  webhook: string;
}

const response = await fetch("https://app.swiftspace.co/api/v1/payment", {
  method: "POST",
  headers: {
    Authorization: "Bearer your-api-key",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    amount: 100.0,
    currency: "USD",
    email: "customer@example.com",
    webhook: "https://your-site.com/webhook",
  } as PaymentRequest),
});

const data = await response.json();
console.log(data);
python
import requests

response = requests.post(
    'https://app.swiftspace.co/api/v1/payment',
    headers={
        'Authorization': 'Bearer your-api-key',
        'Content-Type': 'application/json'
    },
    json={
        'amount': 100.00,
        'currency': 'USD',
        'email': 'customer@example.com',
        'webhook': 'https://your-site.com/webhook'
    }
)

Single Provider Payments ​

Specify a payment provider to enforce currency and amount validation. The API validates that:

  • The provider is active and supported
  • The currency is supported by that provider
  • The amount meets the provider's minimum
bash
curl -X POST https://app.swiftspace.co/api/v1/payment \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 100.00,
    "currency": "USD",
    "email": "customer@example.com",
    "webhook": "https://your-site.com/webhook",
    "provider": "stripe"
  }'
javascript
const response = await fetch("https://app.swiftspace.co/api/v1/payment", {
    method: "POST",
    headers: {
        Authorization: "Bearer your-api-key",
        "Content-Type": "application/json",
    },
    body: JSON.stringify({
        amount: 100.0,
        currency: "USD",
        email: "customer@example.com",
        webhook: "https://your-site.com/webhook",
        provider: "stripe",
    }),
});
typescript
interface PaymentRequest {
  amount: number;
  currency: string;
  email: string;
  webhook: string;
  provider?: string;
}

const response = await fetch("https://app.swiftspace.co/api/v1/payment", {
  method: "POST",
  headers: {
    Authorization: "Bearer your-api-key",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    amount: 100.0,
    currency: "USD",
    email: "customer@example.com",
    webhook: "https://your-site.com/webhook",
    provider: "stripe",
  } as PaymentRequest),
});

const data = await response.json();
console.log(data);
python
import requests

response = requests.post(
    'https://app.swiftspace.co/api/v1/payment',
    headers={
        'Authorization': 'Bearer your-api-key',
        'Content-Type': 'application/json'
    },
    json={
        'amount': 100.00,
        'currency': 'USD',
        'email': 'customer@example.com',
        'webhook': 'https://your-site.com/webhook',
        'provider': 'stripe'
    }
)

Error Responses ​

If a provider is specified, the API returns validation errors for:

  • Invalid Provider: "Provider 'x' is not active or supported."
  • Unsupported Currency: "Currency 'x' is not supported by provider 'y'."
  • Amount Too Low: "Minimum amount for provider 'x' in 'y' is z. Your total with fees is a."

Copyright Š 2026 Swiftspace. All rights reserved.