Skip to main content
POST
Create a submerchant

Authorizations

Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Body

application/json
smApplicationId
string
required

Must be exactly 24 characters

Example:

"507f1f77bcf86cd799439012"

identity
object
required

Identity details for the business and its owners.

payoutBankAccounts
object[]
required

Bank accounts where the merchant receives payouts.

Minimum array length: 1
spProductId
string

Service provider product ID

Maximum string length: 4
Example:

"SP01"

feesTemplateId
string<uuid> | null

UUID of a fees template with predefined pricing. If omitted, the default template is used.

Example:

"550e8400-e29b-41d4-a716-446655440000"

Response

201 - application/json

Submerchant created successfully

code
string

Machine-readable result code. See the Error Codes reference.

success
boolean

Whether the request was processed successfully. Declines return HTTP 200 with success: false.

message
string

Human-readable result message.

data
object

The response payload.

Last modified on July 14, 2026