Quickstart

This quickstart walks you through account setup, API key generation, and your first bluSwap API call. By the end, you will have a working request against the sandbox environment.

Create your bluSwap account

Generate API credentials

From your dashboard, navigate to Settings → API Keys and create a new key pair. Store your client_id and client_secret securely.

Configure your callback URL

Add your webhook endpoint in Settings → Webhooks before processing live transactions. See Webhooks.

Make your first request

Test authentication by calling the balance endpoint:

curl -X GET https://api.bluswap.co/payouts/balances \
  -H "X-Client-Id: your_client_id" \
  -H "X-Client-Secret: your_client_secret"

const res = await fetch("https://api.bluswap.co/payouts/balances", {
  headers: {
    "X-Client-Id": process.env.BLUSWAP_CLIENT_ID,
    "X-Client-Secret": process.env.BLUSWAP_CLIENT_SECRET,
  },
});
console.log(await res.json());

import os, requests
r = requests.get(
    "https://api.bluswap.co/payouts/balances",
    headers={
        "X-Client-Id": os.environ["BLUSWAP_CLIENT_ID"],
        "X-Client-Secret": os.environ["BLUSWAP_CLIENT_SECRET"],
    },
)
print(r.json())

Get Started

Collections

Payouts

Refunds

Next steps

Accept payments

Send payouts

​Next steps

Accept payments

Send payouts

Next steps