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.
Lancer gratuitement
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.
Cas d’usage
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.
Questions fréquentes
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.
Pour les développeurs — accès API
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.
Endpoint
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é.
Appeler depuis votre stack
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}'const res = await fetch("https://api.kit.forhosting.com/life/gift-card-split", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"purchase_amount": 86.4,
"gift_card_balance": 50
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/life/gift-card-split",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"purchase_amount": 86.4,
"gift_card_balance": 50
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/life/gift-card-split", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"purchase_amount":86.4,"gift_card_balance":50}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"purchase_amount":86.4,"gift_card_balance":50}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/life/gift-card-split", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Exemple de requête
{
"purchase_amount": 86.4,
"gift_card_balance": 50
}Exemple de réponse
{
"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.
Tarifs
Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.
Erreurs
| HTTP | Code | Signification |
|---|---|---|
401 | unauthorized | Clé API absente ou invalide : vérifiez l’en-tête Authorization. |
402 | insufficient_balance | Solde insuffisant : rechargez votre compte pour lancer cette tâche. |
404 | unknown_type | Type de tâche inconnu : vérifiez le champ type de votre requête. |
429 | rate_limited | Trop de requêtes : ralentissez la cadence, puis réessayez. |