Créer un paiement direct

Boutique à laquelle rattacher cet encaissement. Accepte l'identifiant (`sto_*`) **ou le code** de la boutique, celui que vos propres systèmes connaissent déjà. **Champ de premier niveau** : à côté de `externalId`, jamais à l'intérieur de `order`. Une clé inconnue placée dans `order` est écartée en silence, et le paiement partirait alors sur le contrat par défaut sans qu'aucune erreur ne vous prévienne. Facultatif. Si votre clé API est déjà rattachée à une boutique, elle fait autorité et vous n'avez rien à transmettre : le corps peut la répéter, jamais la contredire (`STORE_KEY_MISMATCH`). Une boutique inconnue (`UNKNOWN_STORE`), désactivée (`STORE_INACTIVE`) ou déclarée point de vente physique (`STORE_KIND_MISMATCH`) fait échouer l'appel : elle n'est jamais ignorée. Vos boutiques se créent depuis votre espace marchand, Paramètres puis « Mes offres ». Voir le guide « Plusieurs boutiques » (/docs/guides/boutiques).

**Usage avancé.** Contrat d'encaissement à employer (`mcf_*`), désigné directement. Ce champ reste accepté, mais la voie normale est la boutique : `storeId`, ou une clé API rattachée à une boutique, désigne le contrat sans que vous ayez à le nommer. Facultatif : absent, le contrat actif par défaut s'applique. Si l'appel et la boutique désignent deux contrats différents, l'appel est refusé (`STORE_CONTRACT_CONFLICT`) : Mobupay n'arbitre jamais en silence entre deux contrats, puisque le choix décide du libellé porté au relevé du client et de la ventilation des fonds.

Détail de la commande à payer. Voir sous-objets `items`, `taxDetail`, `platformConfig`, `delivery`.

Qui déclenche ce prélèvement. `customer` (défaut) : le porteur est devant l'écran et l'a demandé. `merchant` : vous prélevez sans lui, depuis une tâche de fond — une échéance d'abonnement, un solde de fin de mois. Le débit part alors en transaction initiée par le marchand et cite la transaction qui a enrôlé la carte. Déclarer `customer` pour un débit que le porteur n'a pas demandé est une déclaration inexacte, et elle se paie sur les taux d'acceptation. **Le transfert de responsabilité s'applique** dès lors que la carte a été enrôlée chez nous avec authentification : Mobupay rejoue cette authentification sur chaque prélèvement, et la transaction porte alors `liabilityShift`. Une carte enrôlée avant septembre 2026 n'en a pas : le prélèvement aboutit, mais le risque de contestation reste chez vous.

AUTO (défaut) = autorisation et capture dans le même appel : la réponse rend directement `status: "captured"` avec `capturedAt` renseigné, et vous recevez `payment.authorized` puis `payment.captured`. MANUAL = autorisation seule : `status: "authorized"`, `capturedAt` nul, capture à demander via `POST /payments/{id}/capture`. En MANUAL, l'autorisation a une durée de validité limitée (moins de 7 jours côté réseau carte) : sans capture dans ce délai, le client n'est jamais débité.

Identifie la carte tokenisée à débiter.

Identifiant externe du paiement côté marchand (sert d'idempotence sur les doublons). Max 255 caractères.

Le montant `order.amount` inclut les taxes (TTC). Défaut `true`.

Code langue (2 a 5 caractères). Défaut `fr`.

URL HTTPS de votre webhook (optionnel) : Mobupay y envoie (POST signé) `payment.authorized`, puis `payment.captured` si `captureMode` valait AUTO. Livrée en complément des endpoints webhook enregistrés. Si absent et aucun endpoint enregistré, seule la réponse HTTP indique le résultat (201 succès, 402 refus).

Données privees libres conservées côté Mobupay.