Δεδομένα παραγγελίας και στοιχείου γραμμής
Τα στοιχεία παραγγελίας και στοιχείων γραμμής περιλαμβάνουν πληροφορίες σχετικά με την παραγγελία και τα στοιχεία που περιέχονται στην παραγγελία, τα οποία μπορείτε να συμπληρώσετε στο αίτημα και να επιλέξετε να εμφανιστούν στον πληρωτή (μέσω Hosted Checkout ή πληρωμών μέσω browser) πριν από την επιβεβαίωση της πληρωμής. Ορισμένα δεδομένα παραγγελιών και στοιχείων γραμμής, όταν παρέχονται σε μια συναλλαγή, μπορούν να καθιστούν τη συναλλαγή κατάλληλη για καλύτερες διατραπεζικές προμήθειες με τους κατόχους επαγγελματικών καρτών, εταιρικών καρτών ή καρτών αγορών. Για περισσότερες πληροφορίες, βλ. την ενότητα Δεδομένα επιπέδου II και III.
order.item[n].brandorder.item[n].categoryorder.item[n].descriptionorder.item[n].nameorder.item[n].quantityΌταν μια δεκαδική ποσότητα πολλαπλασιάζεται με τα ποσά (order.item[n].unitPrice,order.item[n].unitTaxAmount, ήorder.item[n].unitDiscountAmount), και αν τα δεκαδικά ψηφία στην υπολογιζόμενη τιμή υπερβαίνουν τις μικρές μονάδες του νομίσματος του πληρωτή, η πύλη θα στρογγυλοποιεί το σύνολο χρησιμοποιώντας τον αλγόριθμο "στρογγυλοποίηση μισού σε άρτιο". Για παράδειγμα, αν 2,555 (ποσότητα) επί 3 (τιμή μονάδας) ανέρχεται σε 7,665 και αν το νόμισμα του πληρωτή (USD) έχει 2 μικρές μονάδες, τότε το στρογγυλοποιημένο ποσό είδους θα είναι 7,66.
Βεβαιωθείτε ότι εφαρμόζετε αυτήν τη στρογγυλοποίηση όταν παρέχετε αυτά τα πεδία ποσών στο αίτημα.order.item[n].skuorder.item[n].unitPrice
Αυτό το ποσό πολλαπλασιάζεται με
order.item[n].quantityγια να υπολογιστεί το συνολικό ποσό είδους για το είδος γραμμής. Αν έχει δοθεί τοorder.itemAmount, τότε το άθροισμα του συνολικού ποσού είδους για όλα τα είδη γραμμής ΠΡΕΠΕΙ να ισούται με την τιμή στοorder.itemAmount.order.item[n].unitTaxAmount
Αυτό το ποσό πολλαπλασιάζεται με
order.item[n].quantityγια να υπολογιστεί το συνολικό ποσό φόρου για το είδος γραμμής. Αν έχει δοθεί τοorder.taxAmount, τότε το άθροισμα του συνολικού ποσού φόρου για όλα τα είδη γραμμής ΠΡΕΠΕΙ να ισούται με την τιμή στοorder.taxAmountorder.item[n].unitDiscountAmount
Αυτό το ποσό πολλαπλασιάζεται με το
order.item[n].quantityγια να υπολογιστεί το συνολικό ποσό έκπτωσης για το είδος γραμμής. Αν έχει δοθεί τοorder.discount.amount, τότε το άθροισμα του συνολικού ποσού έκπτωσης για όλα τα είδη γραμμής ΠΡΕΠΕΙ να ισούται με την τιμή στοorder.discount.amount.
order.item[n].name, order.item[n].quantity και order.item[n].unitPrice για αυτό το στοιχείο.order.currency(υποχρεωτικό)order.idorder.descriptionorder.shippingAndHandlingAmountorder.amount(υποχρεωτικό)
Αν δεν παρέχετε αυτό το πεδίο, αλλά παρέχετε οποιαδήποτε από τα μερικά ποσά (
order.itemAmount,order.shippingAndHandlingAmount,order.taxAmount,order.gratuityAmount,order.cashbackAmount) καιorder.discount.amountτότε αυτό το ποσό υπολογίζεται ως το άθροισμα των μερικών ποσών μείον το ποσό έκπτωσης. Αν παρέχετε τόσο αυτό το πεδίο όσο και τα μερικά ποσά, τότε η τιμή σε αυτό το πεδίο ΠΡΕΠΕΙ να ισούται με την υπολογισμένη τιμή.order.itemAmount
Αν δεν παρέχετε αυτό το πεδίο, αλλά παρέχετε οποιαδήποτε δεδομένα είδους γραμμής, τότε αυτό το ποσό υπολογίζεται ως το άθροισμα του συνολικού ποσού του είδους (
order.item[n].unitPricexorder.item[n].quantity) για όλα τα είδη γραμμής. Αν παρέχετε τόσο αυτό το πεδίο όσο και δεδομένα είδους γραμμής, τότε η τιμή σε αυτό το πεδίο ΠΡΕΠΕΙ να ισούται με την υπολογισμένη τιμή.order.taxAmount
Αν δεν παρέχετε αυτό το πεδίο, αλλά παρέχετε οποιαδήποτε δεδομένα είδους γραμμής, τότε αυτό το ποσό υπολογίζεται ως το άθροισμα του συνολικού ποσού φόρου (
order.item[n].unitTaxAmountxorder.item[n].quantity) για όλα τα είδη γραμμής. Αν παρέχετε τόσο αυτό το πεδίο όσο και δεδομένα είδους γραμμής, τότε η τιμή σε αυτό το πεδίο ΠΡΕΠΕΙ να ισούται με την υπολογισμένη τιμή.order.discount.amountΑν δεν παρέχετε αυτό το πεδίο, αλλά παρέχετε οποιαδήποτε δεδομένα είδους γραμμής, τότε αυτό το ποσό υπολογίζεται ως το άθροισμα του συνολικού ποσού έκπτωσης (
order.item[n].unitDiscountAmountxorder.item[n].quantity) για όλα τα είδη γραμμής. Αν παρέχετε τόσο αυτό το πεδίο όσο και δεδομένα είδους γραμμής, τότε η τιμή σε αυτό το πεδίο ΠΡΕΠΕΙ να ισούται με την υπολογισμένη τιμή.order.gratuityAmount: Το ποσό που επέλεξε να προσφέρει ο πληρωτής ως φιλοδώρημα επιπλέον του ποσού που πληρώνει για τα αγαθά ή τις υπηρεσίες που αγοράζει από εσάς. Το ποσό φιλοδωρήματος συμπεριλαμβάνεται στο συνολικό ποσό της παραγγελίας που παρέχετε σεorder.amount.order.cashbackAmount: Το ποσό που επέλεξε να λάβει ο πληρωτής με τη μορφή μετρητών επιπλέον του ποσού που πληρώνει για τα αγαθά ή τις υπηρεσίες που αγοράζει από εσάς. Το ποσό μετρητών συμπεριλαμβάνεται στο συνολικό ποσό της παραγγελίας που παρέχετε σεorder.amount.
Τα δεδομένα παραγγελίας και στοιχείου γραμμής ισχύουν για τα αιτήματα Authorize, Pay, Initiate Browser Payment, Confirm Browser Payment, Open Wallet, και Hosted Checkout.
Οι επιλογές order.cashbackAmount και order.gratuityAmount ισχύουν μόνο για τα αιτήματα Authorize και Pay.