Overview

Tap Marketplace solution allows you to accept and split payments instantly with multiple businesses operating under a Marketplace in a seamless and automated way, as well as managing payouts to the Business's bank accounts.

📘

Business: Vendor/service provider registered under a Marketplace. Each Business under a Marketplace will be issued a unique destination_id.

With Tap Marketplace solution you can:

• Onboard businesses: Onboard your businesses and create Tap's accounts for them seamlessly using our APIs.
• Process payments: Split funds between multiple Businesses, and specify your marketplace fees on each transaction.
• Transfer funds: Transfer funds between your marketplace and Businesses.
• Payout: Payout Businesses quickly and reduce operational costs with Tap’s payout engine.
• Reconcile: Simplify reconciliation by using our reconciliation dashboards, APIs, and customized reporting tools.

The Actors of the Marketplace Setup

• Customer: Shopper who browses the marketplace and completes checkout.
• Marketplace: Website or the app that presents the products of the destinations/vendors and handle the API calls.
• Tap Payments: The payment service provider (PSP) that create destinations,process the payment, split the payment and manage the payouts
• Destination: Merchant selling products through the marketplace.

End-to-End Flow

1. Browse & Select
   • Customer visits the marketplace and selects a vendor's product.
2. Initiate Purchase
   • Customer clicks Buy, triggering the frontend to move to checkout with the selected item and vendor info.
3. Enter Payment Details
   • On the checkout page, the customer provides card data and confirms the purchase.
4. Create Tap Charge
   • Frontend calls the marketplace backend, sending order details, amounts (total and vendor share), and customer information.
   • Backend prepares the Tap charge request, including the amount, destination share, redirect URL and customer details.
5. Tap Authorization & 3DS
   • Tap responds with the transaction details and the 3DS URL in transaction.url if the transaction is 3DS
   • Backend relays the 3DS URL to the frontend, which redirects the customer to complete OTP/3DS verification with their bank.
6. Post-3DS Redirect
   • After successful 3DS, Tap redirects the customer back to the configured redirect URL, appending tap_id as a query parameter.
7. Finalize Charge & Confirm Order
   • Frontend captures the tap_id and calls the backend to finalize the payment.
   • Backend queries Tap to fetch the latest transaction status and details.
   • Backend updates internal order records and sends success/failure response to the frontend.
8. Display Result
   • Frontend shows confirmation or error messaging to the customer.
9. Settlement & Payout
   • For successful charges, Tap automatically splits funds: vendor receives the net amount; marketplace receives its commission.
   • Tap's Fees and VAT are deducted from the marketplace acccount, and both marketplace and vendor wallets in Tap are credited.
   • Tap later disburses wallet balances to linked bank accounts per payout schedule.

Settlement Notes

• Tap splits funds automatically per the configuration provided in the charge request.
• Marketplace wallet holds commissions; vendor wallet receives net proceeds.
• Tap deducts processing fees and VAT of the total amount from the marketplace account.
• Payouts from wallets to bank accounts follow Tap's payouts cycles.