POST /auth/register — Create a merchant account

Use this endpoint to create a new merchant account on Dubu Pay. You provide your business name, email address, and a password. The API creates the account, generates a six-digit OTP, and sends a verification email to the address you supplied. Your account is not usable until you verify your email using POST /auth/verify-email. This endpoint applies a strict rate limit to prevent abuse.

Endpoint

POST https://api.dubupay.com/api/v1/auth/register

No authentication is required.

Request body

string

required

The registered name of your business. Must be at least 2 characters.

string

required

The email address for your merchant account. Must be a valid email. This address is used for verification, notifications, and login — it must be unique across all Dubu Pay accounts.

string

required

A password for your account. Must be at least 8 characters. Passwords are stored securely and are never returned in any API response.

Response

HTTP 201 Created on success.

boolean

true when the account was created successfully.

object

Show data

string

A confirmation message, e.g. "Verification email sent. Please check your inbox.".

string

The email address the verification OTP was sent to.

Example

curl -X POST https://api.dubupay.com/api/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{
    "business_name": "Acme Trading Ltd",
    "email": "owner@acmetrading.com",
    "password": "SuperSecret123"
  }'

Response

{
  "success": true,
  "data": {
    "message": "Verification email sent. Please check your inbox.",
    "email": "owner@acmetrading.com"
  }
}

Verify your email

After registering, check your inbox for an email containing a 6-digit OTP. Pass that code to POST /auth/verify-email along with your email address. Until you do, any attempt to log in will be rejected. If the email doesn’t arrive within a few minutes, use POST /auth/resend-otp to request a new code.

Error responses

Status	Code	Description
`400`	Validation error	`business_name`, `email`, or `password` failed validation. Check the `errors` array.
`409`	`EMAIL_IN_USE`	An account with that email address already exists.
`429`	Rate limit	Too many registration attempts from this IP. Wait before retrying.

Overview

Auth

Payments

Trading

Commerce

Webhooks

POST /auth/register — Create a merchant account

Endpoint

Request body

Response

Example

Verify your email

Error responses