Create (or fetch) a merchant

POST

/api/v1/marketplace-api/merchants

Creates an OpenSylo merchant for one of your customers. Idempotent on
thirdPartyCustomerId -- repeating the call with the same ID returns
the existing merchant (created: false) instead of creating a duplicate.

Emits the merchant.created outbound webhook on first creation.

Request

Authorization

API Key

Add parameter in header

X-OpenSylo-Secret-Key

Example:

X-OpenSylo-Secret-Key: ********************

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

Merchant created or already existing.

Bodyapplication/json

🟠401Unauthorized

🟠403Forbidden

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.opensylo.com/api/v1/marketplace-api/merchants' \
--header 'X-OpenSylo-Secret-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "thirdPartyCustomerId": "mkt_merchant_8421",
    "businessName": "Mama Cass Foods Ltd",
    "email": "owner@mamacass.example",
    "phoneNumber": "+2348012345678",
    "businessType": "LIMITED_LIABILITY_COMPANY",
    "industry": "FOOD"
}'

Response Example

200 - Success Example

{
    "merchantId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "connectionId": "c9d8e7f6-a5b4-3210-fedc-ba0987654321",
    "thirdPartyCustomerId": "mkt_merchant_8421",
    "created": true
}

Modified at 2026-06-10 14:59:36

funding_request.rejected

Get merchant status (KYC, credit score, funding requests)