Create a Merchant

post

https://api.tap.company/v2/merchant/

This endpoint creates a merchant linked to your business.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

To create merchants for your business, you must provide information about the linked entity, brand, and branch. If the wallet belongs to the same business and entity, the merchant can be linked to an existing wallet. Otherwise, you can create a new wallet for each merchant and link it with a bank account.

Related Guide: Getting Started

Body Params

display_name

string

required

Defaults to Flexwares

Merchant display name

business_id

string

required

Defaults to bus_uITwK4822102a8ye23cB9g556

Business ID

business_entity_id

string

required

Defaults to ent_iDTwK4822102vRLG239U9h562

Business entity ID linked to the business

brand_id

string

required

Defaults to brd_p0TwK322103Il27234M9h207

Brand ID linked to business

branch_id

string

Defaults to brc_oETwK322103Om1s23Oa9R301

Branch ID linked to business

wallet_id

string

Defaults to wal_vlTwK4822102vK0s23Up9M562

Wallet ID linked to business.

charge_currenices

array of strings

Defaults to KWD

List of ISO currencies code

charge_currenices

bank_account

object

IBAN for payouts

settlement_by

string

Defaults to Bank

Whether settled by acquirer, provider or bank

payment_provider

object

Merchant payment provider IDs

platforms

array of objects

For creating merchants under platforms, the sub platform ID should be passed here.

platforms

Responses

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200200

400400