Skip to main content
Yabetoo Connect lets a marketplace collect payments on behalf of the vendors it has connected, take its commission along the way, and pay those vendors out to their payout destination. You keep a single integration, a single API key and a single cash flow. Yabetoo keeps the ledger for each vendor.
Environments. Connect runs on the same hosts as the rest of the Yabetoo API: https://pay.sandbox.yabetoopay.com with an sk_test_ key, and https://pay.api.yabetoopay.com with an sk_live_ key. Both serve the same endpoints.

​
The three actors

Connect brings three parties together. The vocabulary is fixed throughout this documentation and in the API. Confusing it is the number one source of integration errors.

​
How the money moves

Money always lands on Yabetoo’s operator identity, then Connect splits it in the ledger. There is no routing to a third-party operator account: the split is a book entry, so it is atomic.
1

You create a vendor

One API call creates their account, their organization and their wallet. See Create a connected account.
2

The vendor passes verification

You send them an onboarding link hosted by Yabetoo. There they submit their identity documents and their payout destination. See Onboarding and verification.
3

You collect

Either you name the vendor at capture time and the split happens immediately (direct mode), or you collect on your own account and distribute later (deferred mode).
4

The funds mature

Every vendor credit lands as a pending balance and becomes available after a configurable delay. See Balances and availability.
5

You pay the vendor

You order the withdrawal of their available balance to their payout destination, on demand or on an automatic schedule.

​
The two commission modes

Connect supports two economic setups, chosen once and for all when you activate your account. This is the fee_payer setting, and it decides who bears the Yabetoo fees.

Marketplace mode

fee_payer = controllerYou take a commission on the sale, and the Yabetoo fees come out of your commission. The vendor sees a single deduction: yours.

Platform mode

fee_payer = accountThe vendor is billed by Yabetoo like an ordinary merchant, and your commission is added on top. You keep your commission in full.
The same rate does not earn the same amount in both modes. A controller declaring 5% keeps 50 on a 10,000 XAF sale in marketplace mode, and 500 in platform mode. Read Commissions and pricing before choosing.

​
What Connect does, and does not do

The control link is set at creation and it is immutable. There is no endpoint to unlink a vendor, nor to transfer them to another marketplace. Multi-attachment is not supported.
Control depth is limited to 1. A connected account cannot become a marketplace.
A vendor’s wallet cannot be debited after the fact. Yabetoo therefore never advances funds: a refund not covered by the available balances is refused, it does not create a debt. See Refunds.
A vendor is created in the currency of its marketplace. Multi-currency is not supported in v1: a different currency is refused at creation.
By default a connected account has no login, no API key and no dashboard. They submit their documents through the onboarding link, and you are the one who orders their withdrawals.

​
Next step

Quickstart

A full walkthrough, from activation to the first payout.

Activate Connect

Choose your mode and turn Connect on for your account.