Date comandă și articol de linie
Datele comenzii și articolelor-rând includ informații despre comandă și articolele conținute în comandă, pe care le puteți furniza în solicitare și puteți opta pentru a fi afișate pentru plătitor (prin Hosted Checkout sau plățile în browser) înaintea confirmării plății. Anumite date privind comenzile și articolele-rând, dacă sunt furnizate într-o tranzacție, pot face ca aceasta să fie eligibilă pentru comisioane de procesare mai scăzute în cazul posesorilor de carduri corporative, de afaceri sau de achiziții. Pentru mai multe informații, consultați Datele de nivel II și de nivel III.
order.item[n].brandorder.item[n].categoryorder.item[n].descriptionorder.item[n].nameorder.item[n].quantityAtunci când o valoare zecimală este înmulțită cu anumite sume (order.item[n].unitPrice,order.item[n].unitTaxAmountsauorder.item[n].unitDiscountAmount) și dacă zecimalele din valoarea calculată depășesc unitățile secundare ale monedei plătitorului, gateway-ul va rotunji totalul folosind algoritmul de rotunjire a jumătății la un număr par. De exemplu, dacă avem valoarea 2,555 (cantitatea) înmulțită cu 3 (prețul unitar), ceea ce are ca rezultat produsul 7,665, iar moneda plătitorului (USD) are 2 unități secundare, valoarea rotunjită a articolului va fi de 7,66.
Asigurați-vă că aplicați această rotunjire atunci când introduceți aceste câmpuri cu valori în solicitare.order.item[n].skuorder.item[n].unitPrice
Această sumă este înmulțită cu
order.item[n].quantitypentru a calcula suma totală pentru articolul-rând. Dacă furnizațiorder.itemAmount, suma totală a valorilor tuturor articolelor-rând TREBUIE să fie egală cu valoarea dinorder.itemAmount.order.item[n].unitTaxAmount
Această sumă este înmulțită cu
order.item[n].quantitypentru a calcula valoarea totală a taxelor pentru articolul-rând. Dacă furnizațiorder.taxAmount, suma totală a valorilor taxelor pentru toate articolele-rând TREBUIE să fie egală cu valoarea dinorder.taxAmount.order.item[n].unitDiscountAmount
Această sumă este înmulțită cu
order.item[n].quantitypentru a calcula valoarea totală a reducerii pentru articolul-rând. Dacă furnizațiorder.discount.amount, valoarea totală a reducerilor pentru toate articolele-rând TREBUIE să fie egală cu valoarea dinorder.discount.amount.
order.item[n].name, order.item[n].quantity și order.item[n].unitPrice pentru articolul respectiv.order.currency(obligatoriu)order.idorder.descriptionorder.shippingAndHandlingAmountorder.amount(obligatoriu)
Dacă nu furnizați acest câmp, însă furnizați oricare dintre valorile sub-totalurilor (
order.itemAmount,order.shippingAndHandlingAmount,order.taxAmount,order.gratuityAmount,order.cashbackAmount) șiorder.discount.amount, această valoare este calculată ca sumă a valorilor sub-totalurilor, minus valoarea reducerii. Dacă furnizați atât acest câmp, cât și valorile oricăror sub-totaluri, valoarea din acest câmp TREBUIE să fie egală cu valoarea calculată.order.itemAmount
Dacă nu furnizați acest câmp, dar furnizați orice date privind articolele-rând, această valoare este calculată ca sumă a valorilor totale ale articolelor (
order.item[n].unitPricexorder.item[n].quantity) pentru toate articolele-rând. Dacă furnizați atât acest câmp, cât și valorile oricăror articole-rând, valoarea din acest câmp TREBUIE să fie egală cu valoarea calculată.order.taxAmount
Dacă nu furnizați acest câmp, dar furnizați orice date privind articolele-rând, această valoare este calculată ca sumă a valorilor totale ale taxelor (
order.item[n].unitTaxAmountxorder.item[n].quantity) pentru toate articolele-rând. Dacă furnizați atât acest câmp, cât și valorile oricăror articole-rând, valoarea din acest câmp TREBUIE să fie egală cu valoarea calculată.order.discount.amountDacă nu furnizați acest câmp, dar furnizați orice date privind articolele-rând, această valoare este calculată ca sumă a valorilor totale ale reducerilor (
order.item[n].unitDiscountAmountxorder.item[n].quantity) pentru toate articolele-rând. Dacă furnizați atât acest câmp, cât și valorile oricăror articole-rând, valoarea din acest câmp TREBUIE să fie egală cu valoarea calculată.order.gratuityAmount: Suma pe care plătitorul a ales să o plătească cu titlu de gratuitate sau recompensă în plus față de suma plătită pentru bunurile sau serviciile achiziționate de la dvs. Valoarea gratuității este inclusă în valoarea totală a comenzii, indicată înorder.amount.order.cashbackAmount: Suma pe care plătitorul a ales să o primească în numerar, în plus față de suma plătită pentru bunurile sau serviciile achiziționate de la dvs. Valoarea sumei primite în numerar este inclusă în valoarea totală a comenzii, indicată înorder.amount.
Datele comenzii și articolelor-rând sunt aplicabile pentru solicitările Authorize, Pay, Initiate Browser Payment, Confirm Browser Payment, Open Wallet și Hosted Checkout.
order.cashbackAmount și order.gratuityAmount se aplică numai solicitărilor Authorize și Pay.