Skip to main content
POST
/
v1
/
register
Self-register a new merchant
curl --request POST \
  --url http://localhost:8080/v1/register \
  --header 'Content-Type: application/json' \
  --data '
{
  "legal_name": "Acme Corp",
  "country": "US",
  "email": "[email protected]",
  "trading_name": "<string>",
  "contact_name": "<string>",
  "contact_phone": "<string>"
}
'
{
  "data": {
    "merchant": {
      "id": "mer_cq1234567890abcdef",
      "legal_name": "<string>",
      "trading_name": "<string>",
      "registration_no": "<string>",
      "country": "<string>",
      "status": "pending",
      "risk_rating": "low",
      "primary_email": "[email protected]",
      "primary_phone": "<string>",
      "kyb_completed_at": "2023-11-07T05:31:56Z",
      "webhook_url": "<string>",
      "daily_payout_limit": "<string>",
      "monthly_payout_limit": "<string>",
      "metadata": {},
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z"
    },
    "application": {
      "id": "<string>",
      "merchant_id": "<string>",
      "status": "draft",
      "legal_name": "<string>",
      "trading_name": "<string>",
      "registration_no": "<string>",
      "business_type": "<string>",
      "industry": "<string>",
      "website": "<string>",
      "reg_country": "<string>",
      "primary_contact_name": "<string>",
      "primary_contact_email": "[email protected]",
      "expected_monthly_volume": "<string>",
      "destination_countries": [
        "<string>"
      ],
      "source_currencies": [
        "<string>"
      ],
      "beneficial_owners": [
        {
          "full_name": "<string>",
          "date_of_birth": "<string>",
          "nationality": "<string>",
          "country": "<string>",
          "ownership_pct": 123,
          "role": "<string>"
        }
      ],
      "risk_tier": "low",
      "assigned_to": "<string>",
      "rejection_reason": "<string>",
      "submitted_at": "2023-11-07T05:31:56Z",
      "decided_at": "2023-11-07T05:31:56Z",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z"
    },
    "api_key": "ak_test_xxxxxxxxxxxxxxxxxxxx"
  }
}

Body

application/json
Required string length: 2 - 255
Example:

"Acme Corp"

country
string
required

ISO 3166-1 alpha-2 country code

Example:

"US"

email
string<email>
required
trading_name
string
Maximum string length: 255
contact_name
string
contact_phone
string

Response

Merchant registered successfully

data
object