ForHosting KIT · Strumenti per sviluppatori

Calcolatore per buono regalo e contanti

Questo calcolatore per buono regalo e contanti mostra con precisione come viene suddiviso un acquisto quando il buono copre una parte, l’intero totale o più del totale.

● BetaGratis · nel tuo browser
Usalo da WebAPIEmailTelegramApp presto

Inserisca l’importo dell’acquisto e il saldo attualmente disponibile. Il calcolatore applica la massima quota possibile del saldo, indica quanto resta da pagare in contanti e mostra il valore residuo del buono. È utile alla cassa, per pianificare una spesa o per spiegare a un’altra persona un pagamento suddiviso.

Inserisca l’acquisto e il saldo disponibile

Parta dall’importo completo dell’acquisto prima che venga applicato il buono regalo. Inserisca quindi il saldo realmente disponibile per la transazione. Entrambi i valori devono essere espressi nella stessa valuta, perché il calcolatore suddivide gli importi ma non converte il denaro. Utilizzi normali valori monetari con non più di due cifre decimali, come 42, 42.50 o 19.99. L’acquisto deve essere maggiore di zero, mentre un saldo del buono pari a zero è valido e significa semplicemente che l’intero acquisto sarà pagato in contanti. Se il buono è già stato usato, indichi il saldo disponibile corrente e non il valore nominale originario. Imposte, spese di consegna, sconti e mance devono essere già compresi nell’importo dell’acquisto quando fanno parte del totale alla cassa. Il calcolo non stabilisce se un esercente accetta pagamenti combinati né se una determinata commissione può essere pagata con un buono regalo. Risolve la questione aritmetica dopo che il totale dovuto e il saldo utilizzabile sono noti.

Comprenda come viene calcolata la suddivisione

Il calcolatore applica prima il buono regalo, fino al valore minore tra l’importo dell’acquisto e il saldo disponibile. Se un acquisto costa 80 e il buono contiene 30, la quota del buono è 30 e quella in contanti è 50. Se lo stesso acquisto è abbinato a un saldo di 100, il buono copre tutti gli 80, non occorrono contanti e sul buono restano 20. Questa regola impedisce che l’utilizzo del buono o il pagamento residuo diventino negativi. I risultati vengono calcolati in centesimi interi per evitare noti artefatti della virgola mobile, come la visualizzazione di 0.30000000000000004. Anche l’importo dell’acquisto restituito costituisce un riferimento accanto ai tre valori derivati. Come verifica, la somma tra buono usato e contanti coincide sempre con l’importo dell’acquisto. La somma tra importo usato e saldo residuo del buono coincide sempre con il saldo iniziale. Queste due relazioni rendono semplice controllare il risultato o inserirlo in un’anteprima di pagamento.

Utilizzi il risultato alla cassa o in un flusso di lavoro

Consideri il risultato un piano di pagamento, non un’autorizzazione del negoziante. Il valore del buono utilizzato è l’importo da richiedere al buono. Il valore in contanti è la somma che dovrà provenire da contanti, carta di debito, carta di credito o altro metodo accettato. Il saldo residuo è ciò che dovrebbe rimanere disponibile dopo una transazione riuscita, purché non vi siano blocchi, commissioni o limitazioni specifiche dell’esercente. Prima di pagare, verifichi che il negozio consenta di combinare un buono regalo con un altro metodo e che la procedura di cassa applichi il buono nell’ordine previsto. Per automatizzare, invii gli stessi due campi numerici all’API e conservi i quattro importi restituiti insieme a un preventivo, carrello o risposta di assistenza. Ogni richiesta costa $0.002; la versione nel browser è utilizzabile gratuitamente. Poiché il calcolo è deterministico e non usa servizi di rete, input identici producono risultati identici, un vantaggio per la pianificazione degli acquisti e per casi di test ripetibili.

Pianificare un acquisto prima della cassa

Verifichi quanti contanti o quanto pagamento con carta serviranno ancora dopo avere utilizzato il saldo disponibile del buono regalo.

Spiegare un pagamento suddiviso

Fornisca a un cliente o familiare una ripartizione chiara tra buono regalo, contanti e saldo residuo.

Visualizzare in anteprima la logica di cassa

Usi il risultato dell’API per collaudare un carrello, preventivo, strumento di rimborso o flusso di assistenza che applica prima i buoni.

Come decide il calcolatore quanto buono utilizzare?

Utilizza il valore minore tra l’importo dell’acquisto e il saldo disponibile, senza applicare più del costo né più del contenuto del buono.

Cosa accade se il saldo supera l’importo dell’acquisto?

Il buono regalo copre tutto l’acquisto, l’importo in contanti è zero e il valore non utilizzato compare come saldo residuo.

Cosa accade se il buono regalo non ha saldo?

Un saldo pari a zero è accettato. L’importo usato dal buono è zero e l’intero acquisto viene assegnato ai contanti.

Posso inserire valute diverse per i due importi?

No. Entrambi gli importi devono essere nella stessa valuta. Questo calcolatore suddivide un pagamento e non converte valute.

Il negozio accetterà sicuramente il pagamento suddiviso?

No. Le regole variano. Verifichi che il negozio consenta di combinare un buono regalo con contanti o un altro metodo di pagamento.

Quanto costa utilizzare l’API?

Ogni richiesta API costa $0.002. Il calcolatore può inoltre essere usato gratuitamente nel browser.

Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.

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

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

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 è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.

per richiesta$0.002

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

HTTPCodiceSignificato
401unauthorizedChiave API mancante o non valida: controlla l'header Authorization.
402insufficient_balanceCredito esaurito: ricarica per continuare a eseguire attività.
404unknown_typeTipo di attività sconosciuto: controlla il campo type della richiesta.
429rate_limitedTroppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Leggi la documentazione completa del KIT →