Paiement distant : Plateforme multimarchand
Cas d'une plateforme qui agrège plusieurs commerçants (ex. une plateforme de commande). Le contrat monétique est rattaché à un compte centralisateur (séquestre). Un paiement unique est encaissé sur ce compte, puis réparti vers les marchands sous-jacents, avant que la plateforme et Mobupay ne prélèvent leurs commissions. La répartition est déclarée via l'objet platformConfig.
Requête : un marchand
On ajoute platformConfig : un tableau d'entrées, une par marchand bénéficiaire. La somme des amount doit égaler order.amount.
POST /api/v1/payments/sessions
Authorization: Bearer sk_test_CLE_PLATEFORME
{
"order": {
"reference": "CMD-100",
"amount": 3000,
"currency": "XPF"
},
"platformConfig": [
{
"merchantId": "mer_resto1",
"amount": 3000,
"items": [{ "product": "Menu", "unitPrice": 3000, "quantity": 1 }]
}
],
"redirectUrl": "https://example.com/return",
"notificationUrl": "https://example.com/webhook"
}Requête : plusieurs marchands (panier multi-vendeur)
Un même paiement peut être réparti entre plusieurs marchands d'une même plateforme.
"platformConfig": [
{ "merchantId": "mer_resto1", "amount": 1000, "items": [ ... ] },
{ "merchantId": "mer_resto2", "amount": 1500, "items": [ ... ] },
{ "merchantId": "mer_resto3", "amount": 500, "items": [ ... ] }
]
// order.amount = 3000 = 1000 + 1500 + 500Flux des fonds
- Le client paie le total sur la page hébergée Mobupay.
- Les fonds sont encaissés sur le compte centralisateur (escrow).
- Pour chaque entrée de
platformConfig:Escrow → Compte marchand(montant brut). - Commission plateforme, par marchand :
Compte marchand → Compte plateforme. - Commission Mobupay, une seule fois sur le total :
Compte plateforme → Commission Mobupay. - Invariant : après répartition, le compte centralisateur revient à zéro.
Schéma : EXT → Escrow → Marchand(s) → Plateforme → Commission Mobupay.
Qui paie les frais
En mode plateforme, c'est la plateforme qui supporte la commission Mobupay (prélevée sur son compte). La plateforme perçoit par ailleurs sa propre commission auprès de ses marchands sous-jacents.
Aller plus loin