Partner fee and commission
You can earn a commission on every order your marketplace runs through RekberPay. You set it per order with partner_fee_bp when you create the deal. Your buyers and sellers never see it as a separate line: they see one Biaya layanan, which is the RekberPay fee and your commission together.
Turn it on
The commission is off until RekberPay sets a limit for your workspace. The limit is a number of basis points (100 is 1%) and it is the same in Sandbox and Live. Ask your RekberPay contact for the rate you agreed. Until then, every deal with a partner_fee_bp above 0 answers 422 PARTNER_FEE_NOT_ALLOWED.
Set it on a deal
Send partner_fee_bp when you create a deal:
| Field | Type | Meaning |
|---|---|---|
partner_fee_bp | integer | 0 to 1000, default 0. 100 is 1% of each milestone amount, rounded down, with no minimum |
- A value above your limit answers
422 PARTNER_FEE_NOT_ALLOWED. - The rate is fixed when the deal is created. You cannot change it on an existing deal.
- The commission uses the same
fee_bearerandfee_split_buyer_pctas the RekberPay fee, and is split between buyer and seller on its own for each milestone. - A milestone must still be large enough for the seller's share of the whole service fee, commission included. If not, the deal answers
422 FEE_EXCEEDS_AMOUNT.
Example: a Rp1.000.000 milestone, a RekberPay fee of Rp15.000 and partner_fee_bp 100 (Rp10.000). The service fee is Rp25.000. With fee_bearer split and 70% for the buyer, the buyer pays Rp1.017.500 and the seller receives Rp992.500.
What you read back
platform_fee, buyer_fee and seller_fee keep their meaning: they are the whole service fee. An integration that ignores the commission stays correct.
The deal and each milestone also carry a fees block that only you and RekberPay staff can read:
{
"fees": {
"service_fee": { "total": 25000, "buyer": 17500, "seller": 7500 },
"rekberpay_fee": { "total": 15000, "buyer": 10500, "seller": 4500 },
"partner_fee": { "bp": 100, "total": 10000, "buyer": 7000, "seller": 3000 }
}
}| Block | Meaning |
|---|---|
service_fee | What users see as Biaya layanan: the RekberPay fee plus your commission |
rekberpay_fee | The part RekberPay keeps |
partner_fee | Your commission. bp is the rate of the deal, and every number is 0 on a deal without one |
The pages and messages your users see (checkout, the invoice, emails, the Android and iOS apps) show only the service fee, the total the buyer pays and what the seller receives. They never show who gets which part.
Events that carry the breakdown, only when the deal has a commission: deal.created, milestone.paid, milestone.released and milestone.auto_released. See Platform webhook events.
When the commission is credited
The commission is credited only when the fee is settled, never when the buyer pays:
| Outcome | Your commission |
|---|---|
| Release (by the buyer, by you, or automatic) | The whole commission of that milestone |
| Split in a dispute | Your share of the fee that was kept, in proportion and rounded down. RekberPay keeps any rounding rupiah |
| Refund (a dispute decision, or the seller did not ship) | 0. The buyer gets the whole buyer fee back, so there is nothing to share |
| Cancelled before payment | 0, nothing was charged |
milestone.released, milestone.auto_released and a split in dispute.resolved carry partner_commission, the amount credited. In a split, fee_revenue is the part of the fee RekberPay kept, not counting your commission.
If a buyer's payment is later taken back (a chargeback), your workspace owes the full amount reversed, as it does today, and that includes the commission you received. See Chargebacks after release.
There are no commission webhook events in this version. Read the balance in the dashboard.
The commission balance and payouts
The credited commission builds up in a commission balance on the Payouts page, on the Commission tab. Live and Sandbox are kept apart: a Sandbox commission is test money, it can never be paid out and it never changes your Live balance.
- Payout. RekberPay transfers the balance to your verified payout account and records it on the same tab. The bank transfer fee comes out of the amount paid out. A payout has to be larger than the transfer fee, unless it takes the whole balance. Contact RekberPay through Help when you want to be paid.
- Chargeback receivables. If a chargeback receivable is past its due date and still open, RekberPay can use your commission balance to settle it. Each use is listed on the Commission tab. A receivable that is not yet due is never paid this way.
- A commission payout waits while a Live chargeback receivable is open, the same way a chargeback deposit return does.