Créer un lien de paiement

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). La boutique suit le lien jusqu'au paiement qu'il produit : elle est restituée dans la réponse, portée par les webhooks de ce paiement, et lisible à tout moment sur `GET /payments/{id}`.

**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`.

AUTO (défaut) ou MANUAL. Voir `POST /payments/sessions`.

Identifiant du client à associer au lien (`cus_*`). Optionnel.

Identifie le customer par son identifiant externe (unique par marchand). Max 255 caractères.

Drapeau de la COMMANDE : ses prix (`items[].unitPrice`) et `order.amount` sont taxes comprises (`true`, défaut), et la taxe en est extraite ; ou hors taxes (`false`), et la taxe est calculée en plus des prix et portée dans `order.taxAmount`, sans être ajoutée au montant débité, qui reste `order.amount` (plus le pourboire). Une commission ne lit pas ce champ : ses taxes (`taxDetail`) s'ajoutent toujours à son montant.

Code langue de la page de paiement (`fr`, `en`...). 2 a 5 caractères. Défaut `fr`.

URL de redirection après paiement (succès ou échec). Le client y revient avec `status`, `paymentId` et `reference` en query string. Ces trois noms sont réservés : Mobupay remplace un paramètre du même nom déjà présent dans votre adresse ; vos autres paramètres sont conservés.

URL de retour dédiée en cas de refus (défaut : `redirectUrl`). Voir `POST /payments/sessions`.

`show` (défaut) : page d'échec Mobupay. `redirect` : redirection immédiate vers `failureRedirectUrl`. Voir `POST /payments/sessions`.

Comportement de la page de succès (`auto` par défaut). Voir `POST /payments/sessions`.

URL HTTPS de votre webhook : Mobupay y envoie (POST signé) les events du paiement (`payment.authorized`, `payment.captured`, `payment.failed`...). Livrée en complément des endpoints webhook enregistrés.

Données privees libres (JSON) conservées côté Mobupay et retournées dans les webhooks.

Durée de validité du LIEN en SECONDES (entier strictement positif), sans plafond. Défaut 86400 (24h) pour un lien `single`, aucune échéance pour un lien `fixed`. `null` : aucune échéance. Une durée qui porterait l'échéance au-delà du 31 décembre 9999 est refusée en 400 : c'est le symptôme d'une durée transmise en millisecondes. Chaque session ouverte par le lien a sa propre durée, courte, bornée par l'échéance du lien.

`single` (défaut) : lien à usage unique, validé au premier paiement abouti. `fixed` : lien permanent, un paiement par client, jusqu'à sa désactivation ou son échéance. Un lien `fixed` ne peut pas désigner de client (`customerId`).