- Κατευθυντήριες οδηγίες ενοποίησης
- Υποστηριζόμενες δυνατότητες (Επιλογές πληρωμής)
- Πλάνα πληρωμής
- Paylater Installments
Paylater Installments
Τα Paylater Installments επιτρέπουν στους πληρωτές να πληρώνουν για τις αγορές τους και να κάνουν μηνιαίες δόσεις έως ότου το ποσό εξοφληθεί πλήρως.
Τα Paylater Installments παρέχουν:
- Γενικές προσφορές: Τα πλάνα πληρωμής που θέλετε να προσφέρετε, τα οποία δεν είναι συγκεκριμένα για τα είδη, τα προϊόντα ή το καλάθι.
- Προσφορές ειδών: Τα πλάνα πληρωμής που θέλετε να προσφέρετε για ένα συγκεκριμένο είδος ή ένα προϊόν.
- Προσφορές καλαθιού: Τα πλάνα πληρωμής που θέλετε να προσφέρετε για ένα καλάθι με ένα ή περισσότερα είδη ή προϊόντα.
Οι όροι του πλάνου πληρωμής Paylater Installments ενδέχεται να περιλαμβάνουν τα ακόλουθα:
- Περίοδος μεταχρονολογημένης πληρωμής κατά την οποία ένας πληρωτής μπορεί να επιλέξει να αναβάλει την πρώτη του πληρωμή.
- Στοιχεία επιτοκίου ή πλάνα άτοκων πληρωμών από την εκδότρια τράπεζα.
- Χρηματικές παροχές για την επιλογή ορισμένων πλάνων πληρωμής.
Βήματα ενοποίησης
| Όνομα πλάνου | Αναγνωριστικό πλάνου | Περιγραφή | API για χρήση |
|---|---|---|---|
1 |
Επισκέψεις πληρωτή στον ιστότοπό σας |
Θέλετε να μάθετε αν υπάρχουν γενικές προσφορές πλάνου πληρωμής που μπορούν να παρουσιαστούν. |
Shopping Options Inquiry Πρέπει να υποβάλετε ένα αίτημα Η απόκριση περιέχει μια λίστα με προσφορές πλάνου πληρωμής για τον έμπορο. |
2 |
Ο πληρωτής περιηγείται σε μια κατηγορία ή πραγματοποιεί αναζήτηση προϊόντος |
Θέλετε να εμφανίσετε τις προσφορές πλάνου πληρωμής που είναι διαθέσιμες για κάθε είδος στη λίστα. |
Item Payment Plan Offers Πρέπει να υποβάλετε ένα αίτημα Η απόκριση περιέχει μια λίστα με προσφορές πλάνου πληρωμής για το είδος. |
3 |
Ο πληρωτής προβάλλει μια σελίδα λεπτομερειών προϊόντος |
Θέλετε να εμφανίσετε τις προσφορές πλάνου πληρωμής για αυτό το είδος |
Item Payment Plan Offers Πρέπει να υποβάλετε ένα αίτημα WS API ITEM_PAYMENT_PLAN_OFFERS για να ρωτήσετε σχετικά με τις προσφορές πλάνου πληρωμής για ένα μεμονωμένο είδος (δηλαδή, η λίστα περιέχει μόνο ένα είδος). Η απόκριση περιέχει μια λίστα με προσφορές πλάνου πληρωμής για το είδος. |
4 |
Ο πληρωτής βλέπει το καλάθι και υποδεικνύει ότι θέλει να κάνει checkout ή να μεταβεί στη σελίδα checkout. |
Θέλετε να εμφανίσετε
|
Επιλογές πληρωμής, συμπεριλαμβανομένων των προϊόντων του πλάνου πληρωμής Πρέπει να υποβάλετε ένα αίτημα WS API PAYMENT_OPTIONS_INQUIRY για να ρωτήσετε σχετικά με
Η απόκριση περιέχει το προϊόν του πλάνου πληρωμής ως "Paylater Installments". |
5 |
Ο πληρωτής έχει επιλέξει το προϊόν του πλάνου πληρωμής ως "Paylater Installments" |
Θέλετε να εμφανίσετε όλες τις προσφορές πλάνου πληρωμής για αυτό το προϊόν του πλάνου πληρωμής |
Επιλογές πληρωμής, συμπεριλαμβανομένων των προϊόντων του πλάνου πληρωμής Πρέπει να υποβάλετε ένα αίτημα WS API PAYMENT_OPTIONS_INQUIRY για να ρωτήσετε σχετικά με τη διαθέσιμη προσφορά πλάνου πληρωμής για αυτό το προϊόν του πλάνου πληρωμής Η απόκριση περιέχει μια λίστα προσφορών πλάνου πληρωμής για το καλάθι ή την παραγγελία και το προϊόν του πλάνου πληρωμής. |
6 |
Ο πληρωτής έχει παράσχει το BIN της κάρτας (καθώς εισάγει τον αριθμό της κάρτας) |
Ανάλογα με το BIN της κάρτας που θέλετε να εμφανίσετε
|
Επιλογές πληρωμής, συμπεριλαμβανομένων των προσφορών πλάνου πληρωμής για το καλάθι ή την παραγγελία Πρέπει να υποβάλετε ένα αίτημα WS API PAYMENT_OPTIONS_INQUIRY για να ρωτήσετε σχετικά με
Η απόκριση περιέχει μια λίστα με προσφορές πλάνου πληρωμής για το καλάθι ή την παραγγελία και το BIN. |
7 |
Ο πληρωτής αποδέχεται την προσφορά του πλάνου πληρωμής καλαθιού και συμφωνεί με τους όρους και τις προϋποθέσεις |
Θέλετε να υποβάλετε την αποδοχή της προσφοράς από τον πληρωτή. |
Αν ο πληρωτής επιλέξει μία από τις προσφορές σε αυτόν τον τρόπο πληρωμής ως "Paylater Installments", πρέπει να παράσχετε τους όρους και τις προϋποθέσεις που επιστρέφονται στην απόκριση PAYMENT_OPTIONS_INQUIRY για προσφορές καλαθιού και ο πληρωτής πρέπει να αποδεχτεί την προσφορά για να προχωρήσει σε αυτό το πλάνο πληρωμής. Αποδοχή προσφοράς Εμφανίζετε τους όρους και τις προϋποθέσεις (λεπτομέρειες για τις οποίες παρέχονται στην απόκριση PAYMENT_OPTIONS_INQUIRY) στον πληρωτή. Ο πληρωτής αποδέχεται τους όρους και τις προϋποθέσεις.
Στη συνέχεια, υποβάλετε ένα αίτημα UPDATE_PAYMENT_PLAN_OFFER. Το αίτημα πρέπει να περιέχει:
Η απόκριση υποδεικνύει αν μπορείτε να συνεχίσετε με την παραγγελία, συμπεριλαμβανομένης αυτής της προσφοράς. Αν
|
8 |
Ο πληρωτής προχωρά στην πληρωμή |
- |
Αίτημα Authorize ή Pay Ο έμπορος υποβάλλει ένα αίτημα WS API AUTHORIZE or PAY με το αναγνωριστικό προσφοράς πλάνου της αποδεκτής προσφοράς. Η προσφορά πλάνου πληρωμής καλαθιού που έχει αποδεχτεί ο πληρωτής γίνεται πλέον το πλάνο πληρωμής για την παραγγελία ή τη συναλλαγή. |
Payment Options Inquiry - Αναφορά API [REST][NVP]
Shopping Options Inquiry
Μπορείτε να ζητήσετε την πύλη για μια λίστα με έγκυρες γενικές προσφορές πλάνου χρησιμοποιώντας την πράξη Shopping Options Inquiry. Επιστρέφονται οι ακόλουθες λεπτομέρειες σχετικά με τα υποστηριζόμενα πλάνα πληρωμής:
Από την έκδοση 70 και μετά, η απόκριση περιέχει τα υποστηριζόμενα προϊόντα του πλάνου πληρωμής, το οποίο είναι "Paylater Installments":
paymentPlanProduct.{paymentPlanProductId}paymentPlanProduct.{paymentPlanProductId}.namepaymentPlanProduct.{paymentPlanProductId}.logoUrl
Κάθε προσφορά πλάνου πληρωμής έχει ένα μοναδικό αναγνωριστικό προσφοράς και το αντίστοιχο αναγνωριστικό προϊόντος πλάνου πληρωμής:
paymentPlanOffer.{id}paymentPlanOffer.{id}.currency (populated with payerCurrency from request)paymentPlanOffer{id}.paymentPlanProductIdpaymentPlanOffer{id}.totalAmountpaymentPlanOffer{id}.numberOfPaymentspaymentPlanOffer{id}.subsequentPaymentAmountpaymentPlanOffer{id}.firstPaymentAmountpaymentPlanOffer{id}.deferalPeriodpaymentPlanOffer{id}.interest.ratepaymentPlanOffer{id}.interest.discountAmountpaymentPlanOffer{id}.feeAmountpaymentPlanOffer{id}.cashAward.amountpaymentPlanOffer{id}.cashAward.payerInstructionTextpaymentPlanOffer{id}.qualifier.descriptionpaymentPlanOffer{id}.qualifier.logoUrlpaymentPlanOffer{id}.minimumAmountpaymentPlanOffer{id}.maximumAmountItem Payment Plan Offers
Μπορείτε να ζητήσετε από την πύλη μια λίστα με έγκυρες προσφορές πλάνου για συγκεκριμένο είδος χρησιμοποιώντας την πράξη Item Payment Plan Offers.
Το αίτημα περιέχει τις ακόλουθες λεπτομέρειες:
merchantpayerlocalecurrencyitem[0].skuitem[0].unitPriceitem[1].skuitem[1].unitPriceΕπιστρέφονται οι ακόλουθες λεπτομέρειες σχετικά με τα υποστηριζόμενα πλάνα πληρωμής. Από την έκδοση 70 και μετά, η απόκριση περιέχει τα υποστηριζόμενα προϊόντα του πλάνου πληρωμής, το οποίο είναι "Paylater Installments":
paymentPlanProduct.{paymentPlanProductId}paymentPlanProduct.{paymentPlanProductId}.namepaymentPlanProduct.{paymentPlanProductId}.logoUrl
Κάθε προσφορά πλάνου πληρωμής έχει ένα μοναδικό αναγνωριστικό προσφοράς και το αντίστοιχο αναγνωριστικό προϊόντος πλάνου πληρωμής:
item[n].paymentPlanOffer.{id}item[n].paymentPlanOffer.{id}.paymentPlanProductIditem[n].paymentPlanOffer.{id}.currencyitem[n].paymentPlanOffer.{id}.totalAmountitem[n].paymentPlanOffer.{id}.numberOfPaymentsitem[n].paymentPlanOffer.{id}.deferalPerioditem[n].paymentPlanOffer.{id}.subsequentPaymentAmountitem[n].paymentPlanOffer{id}.firstPaymentAmountitem[n].paymentPlanOffer{id}.interest.rateitem[n].paymentPlanOffer{id}.interest.discountAmountitem[n].paymentPlanOffer{id}.feeAmountitem[n].paymentPlanOffer{id}.cashAward.amountitem[n].paymentPlanOffer{id}.cashAward.payerInstructionTextitem[n].paymentPlanOffer{id}.qualifier.descriptionitem[n].paymentPlanOffer{id}.qualifier.logoUrlresult
Payment Plan Inquiry
Μπορείτε να ζητήσετε από την πύλη μια λίστα με έγκυρα προϊόντα πλάνου πληρωμής και προσφορές πλάνου χρησιμοποιώντας την πράξη Payment Options Inquiry.
Το αίτημα περιέχει:
payerLocaleorder.amountorder.currencyorder.item[n].skuorder.item[n].quantityorder.item[n].unitPriceorder.itemAmountsourceOfFunds.provided.card.prefix
Από την έκδοση 70 και μετά, η απόκριση περιέχει τα υποστηριζόμενα προϊόντα του πλάνου πληρωμής, το οποίο είναι "Paylater Installments":
paymentPlanProduct.{paymentPlanProductId}paymentPlanProduct.{paymentPlanProductId}.namepaymentPlanProduct.{paymentPlanProductId}.logoUrlΚάθε προσφορά πλάνου πληρωμής έχει ένα μοναδικό αναγνωριστικό προσφοράς και το αντίστοιχο αναγνωριστικό προϊόντος πλάνου πληρωμής:
paymentTypes.card.paymentPlanOffer.{id}paymentTypes.card.paymentPlanOffer.{id}.paymentPlanProductIdpaymentTypes.card.paymentPlanOffer.{id}.numberofPaymentspaymentTypes.card.paymentPlanOffer.{id}.deferralPeriodpaymentTypes.card.paymentPlanOffer.{id}.interest.chargedpaymentTypes.card.paymentPlanOffer.{id}.currencypaymentTypes.card.paymentPlanOffer.{id}.minimumOrderAmountpaymentTypes.card.paymentPlanOffer.{id}.startDatepaymentTypes.card.paymentPlanOffer.{id}.endDatepaymentTypes.card.paymentPlanOffer.{id}.totalAmountpaymentTypes.card.paymentPlanOffer.{id}.firstPaymentAmountpaymentTypes.card.paymentPlanOffer.{id}.subsequentPaymentAmountpaymentTypes.card.paymentPlanOffer.{id}.feeAmountpaymentTypes.card.paymentPlanOffer.{id}.interest.ratepaymentTypes.card.paymentPlanOffer.{id}.interest.discountAmountpaymentTypes.card.paymentPlanOffer.{id}.termsAndConditions.textpaymentTypes.card.paymentPlanOffer.{id}.termsAndConditions.acceptanceRequiredpaymentTypes.card.paymentPlanOffer.{id}.termsAndConditions.acceptanceTextpaymentTypes.card.paymentPlanOffer.{id}.cashAward.amountpaymentTypes.card.paymentPlanOffer.{id}.cashAward.payerInstructionTextpaymentTypes.card.paymentPlanOffer.{id}.qualifier.textpaymentTypes.card.paymentPlanOffer.{id}.qualifier.logoUrl
Update Payment Plan Offers
Μπορείτε να υποβάλετε την αποδοχή του πληρωτή για τις προσφορές πλάνου πληρωμής στον πάροχο χρησιμοποιώντας την πράξη Update Payment Plan Offers.
- Το αίτημα περιέχει:
sourceOfFunds parameter grouporder.amountorder.currencyorder.item[n].quantityorder.item[n].unitPrice
Μπορείτε να παρέχετε τις λεπτομέρειες για την αποδοχή πληρωτή υποδεικνύοντας:
paymentPlanOffer.payerAcceptance = truepaymentPlanOffer.termsAndConditionsDisplayΗ τιμή μπορεί να είναι μία από τις ακόλουθες:
NONE- δεν εμφανίσατε κανένα κείμενο με τους όρους και τις προϋποθέσεις.TERMS_AND_CONDITIONS_ONLY- εμφανίσατε κείμενο με τους όρους και τις προϋποθέσεις.TERMS_AND_CONDITIONS_AND_ACCEPTANCE- εμφανίσατε κείμενο με τους όρους και τις προϋποθέσεις, καθώς και υποχρεώσατε τον πληρωτή να αποδεχτεί τους όρους και τις προϋποθέσεις.
Υποβολή μιας συναλλαγής με το πλάνο πληρωμής
Για να υποβάλετε μια συναλλαγή με το πλάνο πληρωμής που επέλεξε ο πληρωτής, συμπληρώστε τα παρακάτω πεδία σε ένα αίτημα Authorize/Pay ή σε ένα αίτημα Update Session. Από την έκδοση 70 και μετά, συμπληρώστε το πεδίο paymentPlan.offerID με το ID προσφοράς στην απόκριση του ερωτήματος Payment Options Inquiry.
Η πύλη επεξεργάζεται ένα πλάνο πληρωμής μόνο αν πληρούνται οι ακόλουθες συνθήκες:
- Το νόμισμα της παραγγελίας υποστηρίζεται για το πλάνο πληρωμής.
- Το ποσό της παραγγελίας υπερβαίνει το ελάχιστο ποσό παραγγελίας που ορίζεται στο πλάνο πληρωμής.
- Ο τύπος κάρτας υποστηρίζεται για το πλάνο πληρωμής.