FlowAlp

Préautorisation : réserver puis débiter des fonds

July 30, 2026

Préautorisation avec FlowAlp Pay : réservez un montant au checkout, débitez-le plus tard via l'endpoint Transaction — hôtels, locations, cautions.

Une préautorisation réserve un montant sur le moyen de paiement du client au moment du checkout, sans le débiter. Vous encaissez les fonds plus tard — par exemple à la fin du séjour à l'hôtel ou au retour de la location — ou vous laissez simplement la réservation expirer. Sur FlowAlp Pay, vous l'activez avec un seul paramètre du Gateway et vous encaissez via l'endpoint Transaction.

Comment fonctionne la préautorisation

  1. Créez un Gateway avec "reservation": true et le montant à bloquer.
  2. Le client autorise le paiement sur le checkout hébergé — rien n'est encore débité.
  3. La transaction reçoit le statut reserved ; vous l'apprenez via webhook ou en récupérant le Gateway.
  4. Vous débitez la transaction réservée, ou vous laissez la réservation expirer.

Trois propriétés définissent le modèle : le montant encaissé peut être inférieur mais jamais supérieur à la réservation, le débit d'une réservation est fiable parce que les fonds sont bloqués, et exactement un seul débit par réservation est possible. Pour débiter un client de façon répétée, utilisez plutôt la tokenisation.

Tous les payment providers ne prennent pas en charge la préautorisation. La disponibilité de l'option dépend de la configuration de votre compte.

Créer une réservation au checkout

La requête est une création de Gateway normale avec le flag supplémentaire reservation. Le montant est exprimé en unité minimale (CHF 500.00 → 50000).

Créer un Gateway de préautorisationbash
curl -X POST "https://api.pay.flowalp.com/v1.16/Gateway/?instance=demo-shop" \
  -H "x-api-key: $FLOWALP_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 50000,
    "currency": "CHF",
    "purpose": "Security deposit apartment 12",
    "referenceId": "BOOKING-2026-0788",
    "reservation": true,
    "successRedirectUrl": "https://rentals.example.com/deposit/success",
    "failedRedirectUrl": "https://rentals.example.com/deposit/failed",
    "cancelRedirectUrl": "https://rentals.example.com/deposit/cancel"
  }'

Attention aux noms des paramètres : reservation crée une préautorisation, tandis que preAuthorization lance une tokenisation (un token réutilisable). Le mauvais flag change le type de paiement.

Encaisser le montant réservé

Pour encaisser, vous débitez la transaction réservée. Récupérez l'ID de la transaction au statut reserved dans le payload du webhook, ou lisez-le dans les invoices et transactions du Gateway récupéré. Envoyez ensuite une requête POST à l'endpoint Transaction — avec le montant réservé complet ou un montant inférieur :

Encaisser (débiter) une transaction réservéebash
curl -X POST "https://api.pay.flowalp.com/v1.16/Transaction/4711/?instance=demo-shop" \
  -H "x-api-key: $FLOWALP_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 38000,
    "purpose": "Final amount after check-out",
    "referenceId": "BOOKING-2026-0788-FINAL"
  }'

Un débit réussi produit une transaction au statut confirmed — traitez-la comme n'importe quel autre paiement, vérification du webhook comprise. Les paramètres de l'endpoint, les remboursements et les annulations sont documentés dans Débiter, encaisser, rembourser et annuler des Transactions.

Validité d'une réservation

Les fonds réservés ne restent pas bloqués indéfiniment : une préautorisation reste valable en général environ cinq jours. Passé ce délai, la réservation expire et le montant bloqué est automatiquement libéré pour le client — aucun appel API n'est nécessaire pour la laisser expirer.

La fenêtre de validité exacte n'est pas garantie : elle dépend de l'émetteur de la carte et du moyen de paiement. Encaissez aussi tôt que votre processus le permet et, si votre cas d'usage exige une durée contraignante, vérifiez-la pour les moyens de paiement que vous proposez avant de vous y fier.

Cas d'usage typiques

  • Hôtels et hébergement — couvrir les no-shows et les extras, puis encaisser la facture finale au départ.
  • Locations et partage — bloquer une caution à la remise ; la libérer, ou en encaisser une partie, au retour.
  • Acomptes pour services et commandes sur mesure — vérifier que les fonds existent avant de commencer le travail, débiter seulement à la livraison.
  • Montants finaux connus plus tard — réserver un plafond et encaisser le total exact (carburant, extras, prix au poids) une fois connu.

Besoin de débiter le même client plusieurs fois ? C'est le rôle de la tokenisation. Pour tous les paramètres d'encaissement, poursuivez avec la référence des Transactions.