Quickstart

Make your first API-key call in minutes.

This gets you from a key to a live API call.

1. Get a key

Grab your Payments test key from the dashboard — see Get your API keys. Then set your environment:

export RACH_BASE="https://api.rach.finance/api/v1"
export RACH_KEY="test_sk_your_key_here"

2. Create a checkout

Accept a crypto payment with a hosted checkout (Crypto Gateway):

cURL

curl "$RACH_BASE/checkout/create" \
  -H "X-API-Key: $RACH_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 50,
    "currency": "USD",
    "reference": "order_1001",
    "callback_url": "https://yourapp.com/webhooks/rach",
    "payment_method": "crypto"
  }'

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 your customer to payment_url.

3. Confirm

Poll the session, or (better) receive a webhook on settlement:

curl "$RACH_BASE/checkout/verify/cs_1a2b3c" -H "X-API-Key: $RACH_KEY"

You just took a crypto payment in sandbox. Swap the test_sk_ key for a live_sk_ key to go live — no code changes. See Test vs Live.

Next

Crypto Gateway

Wallet-as-a-Service

CaaS (Stablecoins)

Webhooks