Skip to main content
POST
/
api
/
v1
/
merchant
Create a merchant account
curl --request POST \
  --url https://payments.oaknetwork.org/api/v1/merchant \
  --header 'Content-Type: application/json' \
  --header 'x-access-token: <api-key>' \
  --data '
{
  "legal_name": "Acme Corp",
  "address": "123 Business St, Suite 100",
  "website": "https://acme.example.com",
  "tax_number": "12345678901"
}
'
{
  "msg": "<string>",
  "data": {
    "id": 123,
    "legalName": "<string>",
    "address": "<string>",
    "website": "<string>",
    "taxNumber": "<string>",
    "appId": "<string>",
    "isApproved": true,
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z"
  }
}

Authorizations

x-access-token
string
header
required

User JWT access token for user-level authentication. Used primarily for admin and internal operations.

Body

application/json

Legal business name

address
string
required

Business address

website
string
required

Official website URL

tax_number
string
required

Tax identification number

Response

Merchant created successfully

msg
string
required

Human-readable message describing the result

data
object
required

Response payload (null on error)