Client Onboarding

1. Create Your Account

Sign up at /auth/signup using one of the supported OAuth providers:

  • Google
  • GitHub
  • Discord

Select the Client role during signup.

2. Describe Your Activity

After signup, fill in your profile with details about your business activity. This information is reviewed by staff before your account is approved.

Approval is not guaranteed. The review process may take an indefinite amount of time.

3. Set Up Your Wallet

A Solana wallet is automatically generated. Configure your withdraw address:

  1. Go to Dashboard → Deposit
  2. Enter your external Solana wallet address
  3. This is where you'll receive settlements and withdrawals

Withdraw Address Required

You must configure a withdraw address before creating payments. The system checks for this during payment initialization.

4. Generate an API Key

  1. Go to Dashboard → Settings
  2. Click Generate API Key
  3. Copy and securely store the key — it's shown only once

The API key is a UUID format: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

It's stored as a SHA-256 hash in the database, so it cannot be recovered if lost. Generate a new one if needed.

5. Configure Webhooks (Optional)

Set up a webhook URL to receive payment notifications:

  1. Go to Dashboard → Settings
  2. Enter your webhook URL
  3. The system sends a test payload to verify the URL responds with HTTP 200
  4. Once verified, the URL is saved

See Webhook Events for the payload format.

6. Enable 2FA

Same as Relay — required for withdrawals:

  1. Go to Dashboard → Settings
  2. Enable TOTP 2FA with your authenticator app

7. Create Your First Payment

See Creating Payments for the full API guide.