Integration Types
Altre funzionalità
Card Payments
Mobile Wallets
Alternative Payment Methods
Resources
Un'addizionale è un importo aggiuntivo addebitato dall'esercente per coprire i costi relativi all'accettazione del pagamento tramite carta di credito. La funzionalità per l'applicazione dell'addizionale del Mastercard Gateway consente di applicare un'addizionale su una transazione in base ai parametri riportati di seguito:
Per consentire al gateway di calcolare un'addizionale per una transazione, è necessario configurare le regole per l'addizionale in Merchant Administration. In alternativa, è possibile fornire un'addizionale pre-calcolata sull'ordine, se si esegue l'integrazione mediante DirectAPI/Batch.
Il gateway supporta l'applicazione di un'addizionale sulle transazioni utilizzando i metodi di integrazione indicati di seguito:
È possibile applicare un'addizionale su un ordine utilizzando una delle seguenti opzioni:
Per consentire al gateway di calcolare l'addizionale, fornire il campo indicato di seguito in una richiesta Authorize
/Pay
o Update Session
:
order.netAmount
: questo è l'importo esigibile per l'ordine prima dell'applicazione dell'addizionale.order.amount
nella richiesta. Vedere le Domande frequenti di seguito.È possibile inviare una richiesta Retrieve Transaction
/Retrieve Order
per recuperare i dettagli dell'addizionale indicato di seguito:
order.surchargeAmount
: L'addizionale calcolata dal gateway in base alle regole sull'addizionale.order.amount
: L'importo totale dell'ordine, che comprende l'importo dell'addizionale. Payment Options Inquiry
per richiedere l'importo dell'addizionale calcolata fornendo i campi indicati di seguito: order.netAmount
, order.currency
, gatewayEntryPoint
e sourceOfFunds.provided.card.prefix
Specificare i seguenti campi in una richiesta Authorize
/Pay
/Standalone Capture
o Update Session
:
order.amount
: L'importo totale dell'ordine, che comprende l'importo dell'addizionale.order.surchargeAmount
: L'addizionale, se presente, applicabile al'ordine. Questo importo deve essere incluso nell'importo totale dell'ordine fornito nel campo order.amount
.L'invio di una richiesta Retrieve Transaction
/Retrieve Order
restituirà i dettagli relativi all'addizionale nella richiesta di transazione oltre a order.netAmount
(l'importo netto calcolato sottraendo l'importo dell'addizionale dall'importo dell'ordine).
Payment Options Inquiry
per richiedere i dettagli del circuito della carta di credito/del finanziamento, utili per consentire la valutazione e applicazione dell'addizionale corretta per una carta di credito. Per ulteriori informazioni, vedere le Domande frequenti riportate di seguito.Riferimento API per Authorize [REST][NVP]
Per applicare un'addizionale su un pagamento Hosted Checkout, fornire il campo indicato di seguito nella richiesta Hosted Checkout (funzione Checkout.configure()
o operazione Create Checkout Session
in base al flusso del checkout):
order.netAmount
: L'importo esigibile per l'ordine prima dell'applicazione dell'addizionale. order.amount
nella richiesta. Vedere le Domande frequenti di seguito.È possibile inviare una richiesta Retrieve Transaction
/Retrieve Order
per recuperare i dettagli dell'addizionale.
order.surchargeAmount
: L'addizionale calcolata dal gateway in base alle regole sull'addizionale.order.amount
: Questo è l'importo netto più l'addizionale. Il pagante potrà visualizzare l'addizionale applicabile per la carta di credito che ha immesso e potrà scegliere se procedere con un nuovo importo complessivo, utilizzare un'altra carta di credito o annullare l'ordine. La ricevuta di pagamento presentata al pagante mostrerà l'importo dell'addizionale applicato.
order.netAmount
sia il campo order.amount
nella mia richiesta?La specifica dei campi order.netAmount
e order.amount
senza order.surchargeAmount
restituirà un errore in quanto il gateway non dispone di informazioni sufficienti per calcolare l'addizionale. Il gateway richiede di fornire il campo order.netAmount
OPPURE il campo order.amount
.
Se si forniscono tutti e tre i campi, il gateway non calcolerà l'addizionale, ma utilizzerà l'importo dell'addizionale fornito dall'utente.
Sì. Per scegliere di non applicare un'addizionale, fornire il campo order.amount
nella richiesta di transazione per indicare l'importo totale dell'ordine — non fornire i campi order.netAmount
o order.surchargeAmount
.
Sì. Poiché l'addizionale è inclusa nel campo order.amount
, e questo è l'importo rimborsato al pagante, anche l'addizionale verrà rimborsata. In caso di rimborsi parziali, l'importo dell'addizionale verrà rimborsato su base proporzionale?
Sì, il gateway includerà l'addizionale applicabile nell'importo dell'ordine, che sarà restituito come paymentTypes.card.currencyConversion.payerAmount
nella valuta di fatturazione del pagante e come campo order.amount
nella valuta preferita dell'utente (nella risposta dell'operazione Payment Options Inquiry
).
È possibile fornire il campo sourceOfFunds.provided.card.prefix
nella richiesta Payment Options Inquiry
per recuperare i dettagli del circuito della carta di credito/del finanziamento relativi alla carta utilizzata per il pagamento indicati di seguito, che possono agevolare l'utente nelle decisioni che riguardano l'addizionale:
paymentTypes.card.scheme
: l'organizzazione proprietaria di un marchio della carta di credito definisce la normativa che ne regola l'utilizzo.paymentTypes.card.brand
: Il nome del marchio utilizzato per descrivere la carta, riconosciuto e accettato a livello globale. Per molti tipi di carte principali, questo campo corrisponderà al nome del circuito. In alcuni mercati, una carta può anche presentare un marchio comune locale riconosciuto e accettato nel paese o nell'area di origine (vedere Marchio locale).paymentTypes.card.localBrand
: il nome del marchio utilizzato per descrivere una carta riconosciuta e accettata nel relativo paese o nella relativa area di origine. La carta potrebbe anche presentare un marchio comune riconosciuto e accettato a livello globale.paymentTypes.card.fundingMethod
: il metodo utilizzato dal pagante per fornire i fondi per il pagamento.È possibile utilizzare tali dettagli per calcolare un'addizionale in base alla carta fornita dal pagante.