MobupayMobupayDocumentation
Chargement de vos clés API…

Paiement distant : Direct

Cas du marchand standard, sans plateforme. Le contrat monétique (MID) est rattaché directement au compte de paiement du marchand : les fonds encaissés arrivent sur son compte, et Mobupay y prélève sa commission. Aucune répartition, pas de platformConfig.

Requête minimale

Une commande, une URL de redirection et une URL de notification suffisent. Les montants sont exprimés dans la devise d'origine (XPF ou EUR).

POST /api/v1/payments/sessions
Authorization: Bearer sk_test_VOTRE_CLE
Content-Type: application/json

{
  "order": {
    "reference": "CMD-001",
    "amount": 5000,
    "currency": "XPF",
    "items": [
      { "product": "Pizza Margherita", "unitPrice": 1500, "quantity": 2 },
      { "product": "Coca 33cl", "unitPrice": 500, "quantity": 4 }
    ]
  },
  "redirectUrl": "https://example.com/return",
  "notificationUrl": "https://example.com/webhook"
}

Flux des fonds

  1. Le client paie par carte sur la page hébergée Mobupay (3DS si requis).
  2. Les fonds sont encaissés directement sur le compte du marchand.
  3. Mobupay prélève sa commission : Compte marchand → Compte commission Mobupay.
  4. Vous recevez le webhook payment.captured (ou payment.authorized en capture manuelle).

Schéma : EXT → Compte marchand → Commission Mobupay.

Qui paie les frais

En Direct, le marchand supporte la commission Mobupay (prélevée sur son compte après encaissement). Le détail figure dans orderPaymentFees du paiement (cf. la page Cas particuliers pour la composition de la commission Mobupay).

Capture manuelle

Avec captureMode: "MANUAL", le paiement reste authorized jusqu'à votre appel POST /payments/{id}/capture. La commission Mobupay est calculée à la capture, jamais sur une simple autorisation.