Integration Types
Altre funzionalità
Card Payments
Mobile Wallets
Alternative Payment Methods
Resources
Una transazione della carta di credito può essere inoltrata con tre livelli di dati: livello I, livello II e livello III. Ciascun livello è definito dalla quantità di informazioni fornite per elaborare la transazione.
Se si accettano carte aziendali o di acquisto, i dati di livello II/III forniti in una transazione possono consentire alla transizione di beneficiare di tassi di commissione interbancaria migliori. L'azienda dell'esercente può inoltre sfruttare i vantaggi degli estratti conto con voci dettagliate e delle informazioni per il supporto e la semplificazione dei processi aziendali, come ad esempio l'autorizzazione per un acquisto, la riconciliazione e la creazione di report.
Tenere presente che il gateway non verifica che i dati forniti nella transazione siano sufficienti per garantire specifici tassi di commissione interbancaria come richiesto dai circuiti delle carte di credito.
Quando si crea un ordine, tutti i dati di livello II/III forniti saranno applicati a tutte le transazioni di quell'ordine.
Per le operazioni successive (Capture o Refund), è necessario fornire i dati di livello II/III solo se si desidera:
È possibile sovrascrivere i dati di livello II/III per l'ordine fornendo i dati a livello di ordine. Ciò potrebbe essere necessario per correggere le informazioni specificate durante la creazione dell'ordine. Le informazioni aggiornate saranno quindi applicate a tutte le transazioni successive sull'ordine. Ad esempio, order.customerReference
order.amount
può essere fornito in una richiesta di transazione Authorize, ma non in una richiesta di transazione Capture successiva.Vedere la colonna Campo a livello di ordine nelle tabelle Livello II/III di seguito.
È possibile fornire dati di livello II/III che si applicano solo a una specifica transazione. Ad esempio, transaction.taxAmount
Vedere la colonna Campo a livello di transazione nelle tabelle Livello II/III di seguito.
Quando il gateway invia dati di livello II/III all'acquirer, i valori forniti sulla transazione hanno la precedenza sui valori forniti a livello di ordine. Se non si forniscono valori sulla transazione, per l'invio all'acquirer il gateway utilizzerà solo i valori forniti al livello di ordine (laddove applicabile).
Per fornire i seguenti dati di livello II nella richiesta della transazione, utilizzare i corrispondenti campi di DirectAPI a livello di ordine e/o di transazione come riportato nella tabella seguente.
Dati di livello II | Campo a livello di ordine | Campo a livello di transazione |
---|---|---|
Data ordine cliente | order.customerOrderDate |
|
Importo ordine (l'importo da autorizzare, inviato durante la creazione di un ordine) | order.amount Se si forniscono gli importi subtotali ( order.itemAmount , order.shippingAndHandlingAmount , order.taxAmount , order.gratuityAmount , order.cashbackAmount ), order.discount.amount l'importo dell'ordine DEVE essere uguale alla somma degli importi subtotali meno l'importo dello sconto. |
|
Importo degli articoli | order.itemAmount Se non si fornisce questo valore ma solo i dati delle voci, allora l'importo sarà calcolato come somma degli importi totali ( order.item[n].unitPrice per order.item[n].quantity ) per tutte le voci. Se si forniscono sia questo campo sia i dati delle voci, allora il valore in questo campo DOVRÀ essere uguale al valore calcolato.Se le posizioni decimali del valore calcolato superano le unità minori della valuta del pagante, il gateway arrotonderà il totale utilizzando l'algoritmo "round half to even". Ad esempio, se moltiplicando 2,555 (quantità) per 3 (prezzo unitario) si ottiene 7,665 e la valuta del pagante (USD) ha 2 unità minori, l'importo arrotondato sarà 7,66. Assicurarsi di applicare tale arrotondamento quando si fornisce il campo relativo all'importo dell'articolo nella richiesta. |
transaction.itemAmount |
Importo di spedizione e trasporto | order.shippingAndHandlingAmount L'importo totale di spedizione e gestione della transazione, comprese eventuali imposte applicabili. |
transaction.shippingAndHandlingAmount |
Importo dell'imposta di spedizione e trasporto: | order.shippingAndHandlingTaxAmount Questo campo è supportato a partire dalla versione 67 e successive. L'importo dell'imposta applicato all'importo di spedizione e trasporto della transazione. Questo importo è incluso nell'importo di spedizione e trasporto fornito nel campo order.shippingAndHandlingTaxAmount .
|
transaction.shippingAndHandlingTaxAmount |
Aliquota imposta di spedizione e trasporto | order.shippingAndHandlingTaxRate Questo campo è supportato a partire dalla versione 67 e successive. L'aliquota dell'imposta applicata all'importo di spedizione e trasporto dell'ordine per determinare l'importo dell'imposta di spedizione e trasporto . Per un'aliquota dell'imposta del 2,5%, fornire 0,025. |
transaction.shippingAndHandlingTaxRate |
Importo dei dazi | order.dutyAmount Questo campo è supportato a partire dalla versione 67 e successive. L'importo del dazio, noto anche come imposta o tariffa doganale, per la transazione. |
transaction.dutyAmount |
Importo dell'imposta | order.taxAmount Se non si fornisce questo valore ma solo i dati delle voci, allora l'importo sarà calcolato come somma degli importi totali dell'importo dell'imposta ( order.item[n].unitTaxAmount moltiplicata order.item[n].quantity ) per tutte le voci. Se si forniscono sia questo campo sia i dati delle voci, allora il valore in questo campo DOVRÀ essere uguale al valore calcolato.Se le posizioni decimali del valore calcolato superano le unità minori della valuta del pagante, il gateway arrotonderà il totale utilizzando l'algoritmo "round half to even". Ad esempio, se moltiplicando 2,555 (quantità) per 3 (prezzo unitario) si ottiene 7,665 e la valuta del pagante (USD) ha 2 unità minori, l'importo arrotondato sarà 7,66. Assicurarsi di applicare tale arrotondamento quando si fornisce il campo relativo all'importo dell'articolo nella richiesta. |
transaction.taxAmount |
Tipo di imposta [n] | order.tax[n].type L'acquirer potrebbe richiedere l'inoltro del valore di enumerazione corretto. Contattare your payment service provider per ulteriori dettagli. |
transaction.tax[n].type L'acquirer potrebbe richiedere l'inoltro del valore di enumerazione corretto. Contattare your payment service provider per ulteriori dettagli. |
Importo dell'imposta [n] | order.tax[n].amount |
transaction.tax[n].amount |
Aliquota dell'imposta [n] | order.tax[n].rate |
transaction.tax[n].rate |
Indicatore Esente da imposta | order.taxStatus |
transaction.taxStatus |
Importo dello sconto | order.discount.amount |
transaction.discountAmount |
Riferimento acquisto esercente | order.reference Se non viene fornito, il gateway utilizzerà il valore fornito in order.id (campo obbligatorio). |
|
Numero della fattura | order.invoiceNumber |
|
Numero di riferimento cliente/titolare della carta | order.customerReference |
|
Nome richiedente | order.requestorName |
|
ID codice fiscale esercente - Locale/Nazionale | order.taxRegistrationId |
Se si è un esercente degli Stati Uniti, fornire il proprio codice di identificazione fiscale federale. Se si è un esercente del Canada, fornire il proprio identificativo HST (Harmonized Sales Tax, imposta di vendita armonizzata) presso l'agenzia delle entrate canadese. |
ID codice fiscale esercente - Stato/Provincia/Locale | order.localTaxRegistrationId |
|
Partita IVA cliente | customer.taxRegistrationId |
|
Indirizzo esercente - CAP/Codice di avviamento postale | Il valore configurato nel profilo dell'esercente viene inoltrato all'acquirer. | |
Indirizzo esercente - Stato/Provincia | Il valore configurato nel profilo dell'esercente viene inoltrato all'acquirer. | |
Spedizione da CAP/codice di avviamento postale | shipping.origin.postcodeZip Se non fornito, il valore configurato nel profilo dell'esercente potrebbe essere inoltrato all'acquirer. |
|
Via della destinazione della spedizione | shipping.address.street shipping.address.street2 |
|
Città di destinazione della spedizione | shipping.address.city |
|
Stato/provincia di destinazione della spedizione | shipping.address.stateProvince È necessario fornire il codice di suddivisione del paese ISO 3166-2 a tre caratteri. Se la destinazione è un territorio degli Stati Uniti, fornire il prefisso internazionale. Ad esempio, GUM in entrambi i campi shipping.address.country e shipping.address.stateProvince. Fornire questo campo solo se tutti gli articoli inclusi nell'ordine vengono spediti nella stessa località. |
|
Paese di destinazione della spedizione | shipping.address.country Se la destinazione è un territorio degli Stati Uniti, fornire il prefisso internazionale. Ad esempio, GUM in entrambi shipping.address.country e i campi shipping.address.stateProvince . Fornire questo campo solo se tutti gli articoli inclusi nell'ordine vengono spediti nella stessa località.
|
|
CAP/codice di avviamento postale della destinazione della spedizione | shipping.address.postcodeZip |
|
Indirizzo di fatturazione | customer.firstName customer.lastName |
|
Via indirizzo di fatturazione 1 | billing.address.street |
|
Via indirizzo di fatturazione 2 | billing.address.street2 |
|
Città dell'indirizzo di fatturazione | billing.address.city |
|
Stato indirizzo di fatturazione | billing.address.stateProvince |
|
CAP/codice avviamento postale dell'indirizzo di fatturazione | billing.address.postcodeZip |
|
Paese dell'indirizzo di fatturazione | billing.address.country |
I dati di livello III includono i dati del livello II più i dati delle voci. Per fornire i seguenti dati di livello III nella richiesta della transazione, utilizzare i corrispondenti campi a livello di ordine (dal gruppo di parametri order.item[n]
) e/o a livello di transazione (dal gruppo di parametri transaction.item[n]
) DirectAPI come riportato nella tabella di seguito.
Dati di livello III | Campo a livello di ordine | Campo a livello di transazione |
---|---|---|
ID fiscale dell'esercente dell'articolo | Impossibile fornire il valore a livello di articolo. Per tutti gli articoli, il valore fornito a livello di ordine nel campo order.taxRegistrationId sarà presentato all'acquirer. |
|
Totale articoli | Se necessario nel messaggio dell'acquirer, allora questo importo viene calcolato come somma degli importi totali (order.item[n].unitPrice moltiplicata order.item[n].quantity ) per tutte le voci. |
|
Unità di misura dell'articolo | order.item[n].unitOfMeasure L'acquirer potrebbe richiedere l'inoltro del valore di enumerazione corretto. Contattare your payment service provider per ulteriori dettagli. |
transaction.item[n].unitOfMeasure L'acquirer potrebbe richiedere l'inoltro del valore di enumerazione corretto. Contattare your payment service provider per ulteriori dettagli. |
Descrizione articolo | order.item[n].description |
transaction.item[n].description |
Marchio articolo | order.item[n].brand |
transaction.item[n].brand |
Categoria articolo | order.item[n].category |
transaction.item[n].category |
Categoria settore articolo | order.item[n].industryCategory |
transaction.item[n].industryCategory |
Nome articolo | order.item[n].name |
transaction.item[n].name |
SKU articolo | order.item[n].sku |
transaction.item[n].sku |
Codice articolo UNSPSC (United Nations Standard Products and Services Code) | order.item[n].detail.unspsc |
transaction.item[n].detail.unspsc |
Codice articolo UPC (Universal Product Code) | order.item[n].detail.upc |
transaction.item[n].detail.upc |
Codice prodotto dell'articolo | order.item[n].detail.commodityCode |
transaction.item[n].detail.commodityCode |
Quantità articolo | order.item[n].quantity Quando una quantità decimale viene moltiplicata per un importo order.item[n].unitPrice , order.item[n].unitTaxAmount , o order.item[n].unitDiscountAmount e le posizioni decimali del valore calcolato superano le unità minori della valuta del pagante, il gateway arrotonderà il totale utilizzando l'algoritmo "round half to even". Ad esempio, se moltiplicando 2,555 (quantità) per 3 (prezzo unitario) si ottiene 7,665 e la valuta del pagante (USD) ha 2 unità minori, l'importo arrotondato sarà 7,66. |
transaction.item[n].quantity |
Prezzo per unità | order.item[n].unitPrice Tale importo viene moltiplicato per order.item[n].quantity per stabilire l'importo totale delle voci per la specifica voce. Se si fornisce un order.itemAmount , allora la somma dell'importo voci totale per tutte le voci DEVE essere uguale al valore in order.itemAmount
|
transaction.item[n].unitPrice |
Importo dell'imposta per unità | \order.item[n].unitTaxAmount Tale importo viene moltiplicato per order.item[n].quantity per stabilire l'importo totale delle imposte per la voce. Se si fornisce un order.taxAmount , allora la somma dell'importo delle imposte totale per tutte le voci DEVE essere uguale al valore in order.taxAmount .
|
transaction.item[n].unitTaxAmount |
Tipo di imposta dell'articolo | order.item[n].detail.unitTaxType Utilizzare questo campo per fornire il tipo di imposta addebitato per questa voce, se si tratta di un solo tipo di imposta. |
transaction.item[n].detail.unitTaxType |
Aliquota dell'imposta per l'articolo (in percentuale) | order.item[n].detail.unitTaxRate Utilizzare questo campo per fornire il tipo di aliquota dell'imposta addebitato per questa voce, se si tratta di un solo tipo di aliquota dell'imposta. |
transaction.item[n].detail.unitTaxRate |
Tipo di imposta dell'articolo [n] | order.item[n].detail.tax[m].type order.item[n].detail.tax[m].amount order.item[n].detail.tax[m].rate Utilizzare questi campi per fornire una ripartizione dell'importo dell'imposta sull'ordine per l'articolo per tipo di imposta. Questo è applicabile se ci sono più tipi di imposta addebitati per questa voce. Se esiste un solo tipo di imposta, utilizzare order.item[n].detail.unitTaxType |
transaction.item[n].detail.tax[m].type transaction.item[n].detail.tax[m].amount transaction.item[n].detail.tax[m].rate Utilizzare questi campi per fornire una ripartizione dell'importo dell'imposta sulla transazione per la voce per tipo di imposta. Questo è applicabile se ci sono più tipi di imposta addebitati per questa voce. Se esiste un solo tipo di imposta, utilizzare transaction.item[n].detail.unitTaxType |
Importo dell'imposta per articolo [n] | ||
Aliquota imposta per l'articolo [n] (in percentuale) | ||
Importo dello sconto sull'articolo | order.item[n].unitDiscountAmount Tale importo viene moltiplicato per order.item[n].quantity per stabilire l'importo dello sconto totale per la voce. Se si fornisce un order.discount.amount , allora il valore in questo campo DEVE essere uguale alla somma dell'importo totale per tutte le voci. |
transaction.item[n].unitDiscountAmount |
Aliquota di sconto per l'articolo (in percentuale) | order.item[n].detail.unitDiscountRate |
transaction.item[n].detail.unitDiscountRate |