POST /api/v1/auth/register

Create a new business account on Rach Payments.

Authentication

None required

---

Request

Endpoint

POST https://payments-api-dev-966260606560.europe-west2.run.app/api/v1/auth/register

Body Parameters

Parameter	Type	Required	Description
email	string	✅	Business email address
password	string	✅	Password (min 8 characters)
business_name	string	✅	Legal business name
country	string	✅	2-letter country code (e.g., "US")
first_name	string	✅	Owner's first name
last_name	string	✅	Owner's last name
phone	string	❌	Phone number with country code
business_type	string	❌	e.g., "llc", "corporation"

---

Example Request

cURL

curl -X POST 'https://payments-api-dev-966260606560.europe-west2.run.app/api/v1/auth/register' \
  -H 'Content-Type: application/json' \
  -d '{
    "email": "john@acmecorp.com",
    "password": "SecurePass123!",
    "business_name": "Acme Corporation",
    "country": "US",
    "first_name": "John",
    "last_name": "Doe",
    "phone": "+1234567890",
    "business_type": "llc"
  }'

JavaScript

const response = await fetch('https://payments-api-dev-966260606560.europe-west2.run.app/api/v1/auth/register', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    email: 'john@acmecorp.com',
    password: 'SecurePass123!',
    business_name: 'Acme Corporation',
    country: 'US',
    first_name: 'John',
    last_name: 'Doe',
    phone: '+1234567890',
    business_type: 'llc'
  })
});

const data = await response.json();

Python

import requests

response = requests.post(
    'https://payments-api-dev-966260606560.europe-west2.run.app/api/v1/auth/register',
    json={
        'email': 'john@acmecorp.com',
        'password': 'SecurePass123!',
        'business_name': 'Acme Corporation',
        'country': 'US',
        'first_name': 'John',
        'last_name': 'Doe',
        'phone': '+1234567890',
        'business_type': 'llc'
    }
)

data = response.json()

---

Response

Success (201 Created)

{
  "user_uuid": "usr_abc123def456",
  "business_uuid": "biz_xyz789ghi012  "business_slug": "acme-corporation-1234",
  "message": "Registration successful. Please check your email to verify your account."
}

Error Responses

Email already exists:

{
  "error": "email already registered"
}

Invalid country code:

{
  "error": "invalid country code"
}

---

Next Steps

1. Verify Email: Check your inbox for verification link
2. Submit KYC: Submit KYC documents
3. Get API Key: After KYC approval, retrieve your API key