Getting Started

Before you begin

1. Contact Tap team to confirm if you are eligible to use Tap’s Marketplace solution.
2. Follow our Get started guide to set up your test account and get your API keys.
3. When confirmed that Tap’s Marketplace solution is a good fit for your use case, we will provide you with Marketplace keys to be used for onboarding.

📘

You will receive two sets of keys:

1. Marketplace Keys: to be used for onboarding Businesses.
2. Merchant Keys: to be used for payment processing.

Step 1: Onboarding Businesses

Each Business has to be onboarded on Tap. An account will be created, and Tap will carry out the KYC verification process before the final account approval.

Onboarding your Businesses requires two steps:

1. Uploading the Business KYC documents.
2. Creating a destination_id for the Business using Business API.

Step 2: Accepting payments

Once Business have been onboarded, you can instantly start accepting payments for the newly created Business.

👍

You can accept payments for your Businesses immediately after onboarding, but payouts will not be available while the Business's account is pending approval.
It is recommended to wait until the KYC process is completed, and the account is approved by Tap.

You can split the payment's amount between multiple Businesses, simply by adding the destinations object in the transaction request. For example, when a payment is done on your Marketplace, you can split the amount so that a portion goes to your Marketplace account as a fee or commission, and the remaining of the payment amount goes to the Business's account.

"destinations": {
    "destination": [
      {
        "id": "480593",
        "amount": 2,
        "currency": "KWD"
      },
      {
        "id": "486374",
        "amount": 3,
        "currency": "KWD"
      }
    ]
  }

Step 3: Transferring funds between accounts

You can transfer funds from your Marketplace account to destination accounts. This gives you the flexibility on how to handle your funds' movements between the Marketplace and Businesses.

For example, you can accept all payments into your Marketplace account directly and transfer funds to each Business on a weekly basis or any interval based on your business model.

To make a \charges request, you need to specify:

• Set the amount and currency of the transfer.
• Specify source: set it to your Marketplace MID, or the Business destination_id if you're transferring from a Business to the Marketplace account.
• Specify destination: the account which will receive the funds, your Marketplace MID or a Business's destination_id.

{
   "currency":"KWD",
   "amount":20.0,
   "source":"599424",
   "destination":"1014",
   "source_transaction":"",
   "description":"Vendor Payout",
   "reference":"1227"
}

Step 4: Payouts

After a Business account successfully passes required KYC checks, payouts will be available. Payouts can be initiated automatically by Tap to the Business's bank account, or you can initiate manually from Tap's dashboard.

📘

If you want to initiate the payouts manually, contact our team to disable the auto settlement for the Business's account. Once disabled, you'll have the option to initiate the payout from the dashboard.

Step 5: Reconciliation

See also