PaymentsView as markdown
Cashback
Every product line carries a cashback rate you set (cashback_rate in basis points). The pot for a line is:
pot = unit_price x qty x cashback_rate / 10000Cashback is funded by the merchant — it comes out of your side of the transaction, and the MDR is computed on the total minus tax and cashback.
Who earns what
- Recommender — at capture. When a line matches a shopper's buy-list entry, the recommender earns their share the moment you capture.
- Buyer — when they recommend. The buyer's share is deferred. It is paid when the buyer recommends the product they bought:
- purchase was attributed: they earn their share of the pot (the rest of the split),
- purchase had no recommendation: they earn 100% of the pot.
The split is a platform default (50/50 recommender/buyer) with per-country bounds, overridable per merchant by the platform team.
Cashback lifecycle
- Cashback stays pending for 30 days, then lands in the user's wallet.
- Refunds reduce pending cashback; cashback that has already landed is never clawed back.
Summary
GET /orgs/{id}/cashback/summary (session or API key) returns one entry per currency — never summed across currencies.
{
"currencies": [
{
"currency": "USD",
"captured_count": 128,
"captured_minor": 1240000,
"funded_minor": 62000,
"social_count": 41,
"to_buyers_minor": 21000,
"to_recommenders_minor": 10000
}
]
}| Field | Meaning |
|---|---|
captured_minor |
Gross volume captured |
funded_minor |
Cashback funded by the merchant |
social_count |
Captures with at least one recommender |
to_buyers_minor |
Cashback earned by buyers (recommendation bounties) |
to_recommenders_minor |
Cashback earned by recommenders |