Aller au contenu principal

Paiements

Stripe Integration​

L'API utilise Stripe pour les paiements sécurisés.

Créer un paiement​

Le paiement est créé automatiquement lors de la réservation. L'URL de paiement Stripe est retournée dans la réponse.

{
  "success": true,
  "data": {
    "reservation_id": 123,
    "payment_url": "https://checkout.stripe.com/pay/cs_xxx"
  }
}

Vérifier un paiement​

Après redirection Stripe :

GET /quotes/payment/verify?session_id=cs_xxx

Réponse​

{
  "success": true,
  "data": {
    "status": "paid",
    "reservation_id": 123,
    "amount": 834.10,
    "currency": "EUR"
  }
}

Paiement de supplément​

Quand une modification de réservation génère un supplément :

POST /reservations/{id}/invoice?is_supplement=true
Authorization: Bearer <token>

Réponse​

{
  "success": true,
  "data": {
    "invoice_url": "https://checkout.stripe.com/pay/cs_xxx",
    "amount": 120.00,
    "currency": "EUR"
  }
}

Remboursements​

Initier un remboursement (Support)​

POST /payments/{id}/refund
Authorization: Bearer <token>

Body​

{
  "amount": 100.00,
  "reason": "Annulation partielle"
}

Webhook Stripe​

Les événements Stripe sont reçus sur :

POST /stripe/webhook

Événements gérés​

ÉvénementAction
checkout.session.completedConfirme la réservation
payment_intent.succeededMet à jour le statut
payment_intent.payment_failedMarque comme échoué
charge.refundedMet à jour le remboursement

Méthodes de paiement utilisateur​

Liste des méthodes​

GET /user-payment-methods
Authorization: Bearer <token>

Ajouter une méthode​

POST /user-payment-methods
Authorization: Bearer <token>
{
  "payment_method_id": "pm_xxx",
  "is_default": true
}

Supprimer une méthode​

DELETE /user-payment-methods/{id}
Authorization: Bearer <token>