MobupayMobupay
Tous les endpoints
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"
}

Rattacher l'encaissement à une boutique

Un compte peut porter plusieurs boutiques : deux sites, un site et une enseigne, une marque par activité. La voie recommandée est une clé API par site, rattachée à sa boutique : la clé fait autorité et l'appel n'a rien à transmettre. Quand une même clé dessert plusieurs boutiques, ajoutez storeId au corps.

{
  "storeId": "PAITA",
  "order": { "reference": "CMD-001", "amount": 5000, "currency": "XPF" },
  "redirectUrl": "https://example.com/return",
  "notificationUrl": "https://example.com/webhook"
}

Le champ est de premier niveau, jamais à l'intérieur de order, qui écarte sans rien dire les clés qu'il ne connaît pas. Il accepte le code de la boutique ou son identifiant sto_…, et une boutique inconnue fait échouer l'appel plutôt que d'être ignorée. La réponse restitue la boutique retenue dans store. Détail complet dans le guide « Plusieurs boutiques » (/docs/guides/boutiques).

Attention à une confusion fréquente : le libellé que votre client lit sur son relevé bancaire vient de la plaque portée par le contrat d'encaissement, pas du nom de la boutique. Deux boutiques sur un même contrat produisent le même libellé.

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.