Crypto Payment Gateway

The Crypto Payment Gateway lets you take crypto payments that settle to your Rach balance. Use a hosted checkout (Rach renders the pay page) or drive your own UI with deposit addresses. Authenticate with your Payments API key (X-API-Key).

Base URL: https://api.rach.finance/api/v1/ · Auth: X-API-Key

Create a checkout

number

required

Amount to charge.

string

required

e.g. USD, NGN.

string

Your unique order reference for reconciliation.

string

Buyer email for the receipt.

string

Where Rach POSTs the webhook on settlement.

string

crypto.

object

Any key/values you want echoed back.

curl https://api.rach.finance/api/v1/checkout/create \
  -H "X-API-Key: $RACH_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 50,
    "currency": "USD",
    "reference": "order_1001",
    "customer_email": "buyer@example.com",
    "callback_url": "https://yourapp.com/webhooks/rach",
    "payment_method": "crypto",
    "metadata": { "cart_id": "9f3" }
  }'

const res = await fetch("https://api.rach.finance/api/v1/checkout/create", {
  method: "POST",
  headers: { "X-API-Key": process.env.RACH_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({
    amount: 50, currency: "USD", reference: "order_1001",
    customer_email: "buyer@example.com",
    callback_url: "https://yourapp.com/webhooks/rach",
    payment_method: "crypto",
  }),
});
const session = await res.json();
// redirect the customer to session.payment_url

import requests, os
session = requests.post(
    "https://api.rach.finance/api/v1/checkout/create",
    headers={"X-API-Key": os.environ["RACH_KEY"]},
    json={
        "amount": 50, "currency": "USD", "reference": "order_1001",
        "customer_email": "buyer@example.com",
        "callback_url": "https://yourapp.com/webhooks/rach",
        "payment_method": "crypto",
    },
).json()
print(session["payment_url"])

Response

{
  "session_id": "cs_1a2b3c",
  "payment_url": "https://api.rach.finance/pay/1a2b3c",
  "amount": 50,
  "currency": "USD",
  "status": "pending",
  "expires_at": "2026-08-14T13:00:00Z"
}

Redirect the customer to payment_url. They pick a coin/network and pay.

Verify a payment

Poll the session (or rely on the webhook):

curl https://api.rach.finance/api/v1/checkout/verify/cs_1a2b3c \
  -H "X-API-Key: $RACH_KEY"

Response

{
  "session_id": "cs_1a2b3c",
  "status": "paid",
  "amount": 50,
  "currency": "USD",
  "reference": "order_1001",
  "paid_at": "2026-08-14T12:41:00Z"
}

status is one of pending, paid, expired, failed.

Full lifecycle

Create session

Send amount, currency, a unique reference, and a callback_url.

Customer pays

Redirect to payment_url; Rach handles coin/network selection.

Confirmation

Rach watches the chain and marks the session paid.

Webhook + settlement

Funds land in your balance and Rach POSTs your callback_url.

Other endpoints

Endpoint	Purpose
`GET /checkout/list`	Your checkout sessions (paginated)
`GET /checkout/stats`	Aggregate checkout stats
`GET /checkout/addresses`	Deposit addresses (USDT/USDC), filter by `network`/`currency`
`GET /checkout/{uuid}`	Public session details for your own pay page

See the full schema in the Payments API Reference under Checkout (Crypto Gateway).

Get Started

Core Products

Monitoring & Webhooks

Crypto Payment Gateway

Create a checkout

Verify a payment

Full lifecycle

Other endpoints

​Create a checkout

​Verify a payment

​Full lifecycle

​Other endpoints

Create a checkout

Verify a payment

Full lifecycle

Other endpoints