ForHosting KIT · Outils pour développeurs

Calculateur de paiement par carte cadeau et espèces

Ce calculateur de paiement par carte cadeau et espèces indique précisément comment répartir un achat lorsque la carte couvre une partie, la totalité ou davantage que le total.

● BetaGratuit · dans votre navigateur
Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Saisissez le montant de l’achat et le solde actuellement disponible. Le calculateur utilise autant de ce solde que possible, affiche la somme restant à payer en espèces et indique la valeur encore disponible sur la carte. Il est pratique au moment du règlement, pour préparer un achat ou pour expliquer un paiement partagé à une autre personne.

Saisissez le montant de l’achat et le solde disponible

Commencez par le montant total de l’achat avant toute utilisation de la carte cadeau. Indiquez ensuite le solde réellement disponible pour cette opération. Les deux valeurs doivent être exprimées dans la même devise, car le calculateur répartit les sommes sans effectuer de conversion monétaire. Saisissez des montants usuels comportant au maximum deux décimales, par exemple 42, 42.50 ou 19.99. Le montant de l’achat doit être supérieur à zéro, tandis qu’un solde de carte égal à zéro est accepté et signifie simplement que la totalité sera payée en espèces. Si la carte a déjà servi, utilisez son solde actuel et non sa valeur faciale d’origine. Les taxes, frais de livraison, remises et pourboires doivent déjà être inclus dans le montant de l’achat lorsqu’ils font partie du total à régler. Le calculateur ne détermine pas si un commerçant accepte plusieurs moyens de paiement ni si certains frais peuvent être réglés par carte cadeau. Il résout le calcul une fois connus le total dû et le solde utilisable.

Comprenez le calcul de la répartition

Le calculateur utilise d’abord la carte cadeau, dans la limite de la plus petite valeur entre le montant de l’achat et le solde disponible. Si un achat coûte 80 et que la carte contient 30, la carte règle 30 et les espèces 50. Si le même achat est associé à un solde de 100, la carte couvre les 80, aucune somme en espèces n’est nécessaire et il reste 20 sur la carte. Cette règle empêche le montant utilisé ou le paiement restant de devenir négatif. Les résultats sont calculés en centimes entiers afin d’éviter les artefacts courants des nombres à virgule flottante, tels que l’affichage de 0.30000000000000004. Le montant d’achat renvoyé sert également de repère à côté des trois valeurs calculées. Pour vérifier le résultat, la part de la carte ajoutée à la part en espèces correspond toujours au prix d’achat. La somme utilisée sur la carte ajoutée à son solde restant correspond toujours au solde initial. Ces deux égalités simplifient la vérification et l’intégration dans un aperçu du règlement.

Exploitez le résultat au règlement ou dans un processus

Considérez le résultat comme un plan de paiement et non comme une autorisation du commerçant. Le montant utilisé sur la carte cadeau est la somme à débiter de celle-ci. Le montant en espèces est la somme qui doit provenir d’espèces, d’une carte de débit, d’une carte de crédit ou d’un autre moyen accepté. Le solde restant correspond à la valeur qui devrait demeurer disponible après une opération réussie, en l’absence de blocage, de frais ou de restrictions propres au vendeur. Avant de payer, vérifiez que le magasin permet d’associer une carte cadeau à un autre moyen et que son système utilise la carte dans l’ordre prévu. Pour un usage automatisé, transmettez les deux mêmes champs numériques à l’API et conservez les quatre montants retournés avec un devis, un panier ou une réponse d’assistance. Chaque requête coûte $0.002 ; la version dans le navigateur reste gratuite. Le calcul étant déterministe et sans service réseau, des entrées identiques donnent des résultats identiques, ce qui facilite la planification et les scénarios de test reproductibles.

Préparer un achat avant le règlement

Découvrez la somme qu’il faudra encore régler en espèces ou par carte après utilisation du solde de la carte cadeau.

Expliquer un paiement partagé

Présentez à un client ou à un proche une répartition claire entre carte cadeau, espèces et solde restant.

Prévisualiser la logique de règlement

Utilisez le résultat de l’API pour tester un panier, un devis, un outil de remboursement ou un processus d’assistance qui applique d’abord les cartes cadeaux.

Comment le calculateur détermine-t-il le montant à utiliser ?

Il retient la plus petite valeur entre le prix d’achat et le solde disponible, sans jamais dépasser le prix ni le contenu de la carte.

Que se passe-t-il si le solde dépasse le prix de l’achat ?

La carte cadeau couvre tout l’achat, le montant en espèces est nul et la valeur inutilisée apparaît comme solde restant.

Que se passe-t-il si la carte cadeau ne contient plus rien ?

Un solde nul est accepté. Aucun montant n’est prélevé sur la carte et la totalité de l’achat est affectée aux espèces.

Puis-je saisir deux devises différentes ?

Non. Les deux montants doivent utiliser la même devise. Ce calculateur répartit un paiement sans convertir les monnaies.

Le magasin acceptera-t-il forcément ce paiement partagé ?

Non. Les règles varient selon le commerçant. Vérifiez qu’il autorise l’association d’une carte cadeau avec des espèces ou un autre moyen.

Combien coûte l’utilisation de l’API ?

Chaque requête API coûte $0.002. Le calculateur est également utilisable gratuitement dans votre navigateur.

Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.

POSThttps://api.kit.forhosting.com/life/gift-card-split

Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.

curl -X POST https://api.kit.forhosting.com/life/gift-card-split \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"purchase_amount":86.4,"gift_card_balance":50}'
{
  "purchase_amount": 86.4,
  "gift_card_balance": 50
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "life.gift_card_split",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

HTTPCodeSignification
401unauthorizedClé API absente ou invalide : vérifiez l’en-tête Authorization.
402insufficient_balanceSolde insuffisant : rechargez votre compte pour lancer cette tâche.
404unknown_typeType de tâche inconnu : vérifiez le champ type de votre requête.
429rate_limitedTrop de requêtes : ralentissez la cadence, puis réessayez.

Consulter la documentation complète du KIT →