Flux de requêtes d'API de production

Ordre de requête recommandé pour les opérations en direct avec une portée de propriété explicite et une auditabilité des transactions.

  1. Authentifiez-vous et obtenez la clé JWT de l'utilisateur ou l'API de l'application.
  2. Créez ou mettez à jour des produits via /v1/products (POST, PUT, PATCH); voir Produits API CRUD et exemples multilingues.
  3. Commencez le paiement à partir de Payer avec votre identifiant de produit.
  4. Recevoir et valider les signatures de rappel/webhook (payment.confirmed + miroir valider).
  5. Interroger les résultats des transactions à partir de /v1/transaction/status ou /v1/transactions - voir Détails de la transaction.

En-têtes obligatoires

Authorization: Bearer <token>
Content-Type: application/json

Base de référence pour la gestion des erreurs

  • Réessayez les échecs transitoires (5xx) avec une interruption exponentielle.
  • Traiter 401/403 comme des problèmes d'authentification/permission.
  • Traiter 409 comme des conflits commerciaux (par exemple les bloqueurs de suppression de produits).
  • Enregistrez les identifiants de transaction, les identifiants d’événements webhook et les identifiants de demande pour la traçabilité.