- Κατευθυντήριες οδηγίες ενοποίησης
- Υποστηριζόμενες δυνατότητες (Τρόποι πληρωμής)
- Υλοποίηση μιας ενοποίησης πληρωμής μέσω browser
- Πληρωμές PayPal
PayPal
Το PayPal είναι ένας υποστηριζόμενος τρόπος πληρωμής μέσω browser στο American Express PSP. Αυτή η σελίδα περιγράφει λεπτομέρειες για την ενοποίηση στο PayPal, συμπεριλαμβανομένου του τρόπου διαμόρφωσης του επαγγελματικού λογαριασμού σας στο PayPal για την αποδοχή πληρωμών μέσω της πύλης, τις απαιτήσεις branding κ.λπ. Συνιστάται να διαβάσετε τις οδηγίες ενοποίησης για πληρωμές μέσω browser, πριν δομήσετε την ενοποίηση για το PayPal.
Αν έχει γίνει ενοποίηση για χρήση του PayPal πριν από το Web-Services API έκδοση 50, κάντε κλικ εδώ.
Προαπαιτούμενα
Για να χρησιμοποιήσετε το PayPal ως τρόπο πληρωμής μέσω του American Express PSP, πρέπει να έχετε έναν επαγγελματικό λογαριασμό PayPal διαμορφωμένο για την πύλη. Για λεπτομέρειες, βλ. Διαμόρφωση του λογαριασμού σας PayPal Business.
Για να εγγραφείτε για έναν επαγγελματικό λογαριασμό PayPal, κάντε κλικ εδώ.
Εμπειρία PayPal Checkout
Οι παρακάτω ενότητες θα σας βοηθήσουν να επιλέξετε μια εμπειρία checkout του PayPal που είναι πιο κατάλληλη για τον ιστότοπο του καταστήματός σας.
Το PayPal επιτρέπει στους πληρωτές σας να πραγματοποιούν γρήγορο και ασφαλές check out στον ιστότοπο του καταστήματός σας, επιτρέποντάς τους να χρησιμοποιούν τον λογαριασμό PayPal για πληρωμή και προαιρετικά να παρέχουν πληροφορίες αποστολής στον ιστότοπο του καταστήματος. Με το PayPal, οι πληρωτές ξεκινούν και τελειώνουν τη διαδικασία checkout στον ιστότοπο του καταστήματός σας.
Η πύλη υποστηρίζει δύο τύπους ροών checkout PayPal — Checkout with PayPal και Pay with PayPal.
Αναβαθμίστε την έκδοση SDK στην 1.3.0 για να προσφέρετε επιλογές πληρωμής Venmo και Pay Later στους αγοραστές. Για περισσότερες πληροφορίες σχετικά με το Venmo και το Pay Later, βλ. Πληρώστε με Venmo και Προσφορές Pay Later (ΗΠΑ).
Η ροή Checkout with PayPal σάς επιτρέπει να ανακατευθύνετε έναν πληρωτή από τον ιστότοπο του καταστήματός σας στο PayPal μέσω του Check Out with PayPal.
- Ένας πληρωτής παρακάμπτει την κανονική ροή checkout και κάνει check out χρησιμοποιώντας τις πληροφορίες που είναι αποθηκευμένες στον λογαριασμό του PayPal.
- Το PayPal παρέχει το όνομα, την ηλεκτρονική διεύθυνση και τη διεύθυνση αποστολής σε εσάς από τον λογαριασμό του πληρωτή. Η ενέργεια αυτή επιτρέπει ένα πιο γρήγορο checkout.
- Το PayPal συλλέγει τη διεύθυνση αποστολής από τον πληρωτή στο PayPal, την οποία ο πληρωτής μπορεί να προσθέσει ή να επεξεργαστεί αν ζητείται.
- Μετά την επαλήθευση των λεπτομερειών της παραγγελίας, ο πληρωτής επιλέγει το κουμπί Continue.
- Ο πληρωτής ανακατευθύνεται στη σελίδα πληρωμής σας για επιβεβαίωση.
- Αν χρειαστεί, μπορείτε να αλλάξετε την παραγγελία πριν αποδεχτείτε την πληρωμή (για παράδειγμα, προσθέτοντας έξοδα αποστολής και διακίνησης με βάση τη διεύθυνση που επιστρέφεται από το PayPal).
Δείγμα ροής checkout
Το παρακάτω διάγραμμα περιγράφει τη ροή Checkout with PayPal όπου ο πληρωτής χρησιμοποιεί τη διεύθυνση αποστολής όπως αποθηκεύεται από το PayPal. Ο πληρωτής ελέγχει και επιβεβαιώνει την πληρωμή στον ιστότοπο καταστήματος του εμπόρου.
Η ροή checkout είναι ως εξής:
- Ένας πληρωτής περιηγείται στον ιστότοπο του καταστήματός σας, επιλέγει ένα προϊόν και κάνει κλικ στο Checkout with PayPal στη σελίδα checkout.
- Όταν ο πληρωτής κάνει κλικ στο κουμπί Checkout with PayPal, εκτελείτε μια κλήση
Initiate Browser Payment
στην πύλη και ανακατευθύνετε τον πληρωτή στη διεύθυνση URL του PayPal που επιστρέφεται στην απόκριση. - Η πύλη ανακατευθύνει τον πληρωτή στο PayPal.
- Ο πληρωτής συνδέεται στον λογαριασμό του PayPal χρησιμοποιώντας τη σελίδα σύνδεσης PayPal.
- Ο πληρωτής καθορίζει τη διεύθυνση αποστολής. Ο πληρωτής μπορεί να επιλέξει μια διεύθυνση αποστολής που είχε αποθηκευτεί προηγουμένως με το PayPal ή να εισάγει μια νέα διεύθυνση.
- Ο πληρωτής επιλέγει μια πηγή χρηματοδότησης και συνεχίζει στην πληρωμή κάνοντας κλικ στο κουμπί "Συνέχεια", στο PayPal.
- Ο πληρωτής ανακατευθύνεται από το PayPal πίσω στον ιστότοπο του καταστήματός σας μέσω της πύλης. Μπορείτε να ανακτήσετε τις λεπτομέρειες της συναλλαγής, συμπεριλαμβανομένου του email του λογαριασμού πληρωτή και της διεύθυνσης αποστολής, χρησιμοποιώντας την πράξη
Retrieve Transaction
. - Εμφανίζετε μια σελίδα αναθεώρησης στον πληρωτή με βάση αυτές τις πληροφορίες (για παράδειγμα, μπορεί να θέλετε να προσθέσετε έξοδα αποστολής και διακίνησης). Όταν ο πληρωτής κάνει κλικ στο κουμπί "Πληρωμή τώρα" για να διεκπεραιώσει την πληρωμή, υποβάλετε μια κλήση
Confirm Browser Payment
στην πύλη.Ο πληρωτής μπορεί να επιλέξει να ενημερώσει τη διεύθυνση αποστολής προτού κάνει κλικ στο κουμπί "Πληρωμή τώρα". - Η πύλη στέλνει μια απόκριση με τις λεπτομέρειες της συναλλαγής, η οποία υποδηλώνει την επιτυχία ή όχι της πληρωμής, ώστε να μπορείτε να παρουσιάσετε την κατάσταση στον πληρωτή.
{ "apiOperation":"INITIATE_BROWSER_PAYMENT", "browserPayment":{ "operation":"AUTHORIZE", "paypal":{ "paymentConfirmation":"CONFIRM_AT_MERCHANT" }, "returnUrl":"Https://test.com" }, "order":{ "amount":"4.20", "currency":"USD" }, "sourceOfFunds":{ "type":"PAYPAL" } }
Η ροή Pay with PayPal επιτρέπει στον πληρωτή να προχωρήσει στην κανονική ροή checkout, εισάγοντας τις πληροφορίες χρέωσης και αποστολής στον ιστότοπο του καταστήματος. Όταν ζητείται από τον πληρωτή να επιλέξει τον τρόπο πληρωμής, ο πληρωτής κάνει την επιλογή PayPal που εμφανίζεται στη σελίδα χρέωσης του ιστότοπου καταστήματος μαζί με άλλες επιλογές πληρωμής. Σε αντίθεση με τη συναλλαγή Checkout with PayPal, η τοποθεσία καταστήματος παρέχει τη διεύθυνση αποστολής στο PayPal. Από προεπιλογή, μπορείτε να επιλέξετε να μην εμφανίζεται η διεύθυνση αποστολής ή/και να απενεργοποιήσετε την επεξεργασία στο PayPal. Βλ. Εμφάνιση/παράκαμψη διεύθυνσης αποστολής παρακάτω για πληροφορίες σχετικά με τον τρόπο υλοποίησης αυτής της ενοποίησης του PayPal. Το κουμπί "Πληρωμή τώρα" επιτρέπει στον πληρωτή να επιβεβαιώσει την πληρωμή στο PayPal πριν ανακατευθυνθεί στον ιστότοπο του καταστήματος. Αυτή η επιλογή σάς επιτρέπει να παρέχετε στον πληρωτή πιο γρήγορη εμπειρία checkout, καθώς ο πληρωτής ολοκληρώνει την πληρωμή στο PayPal.
Δείγμα ροής checkout
Το παρακάτω διάγραμμα περιγράφει τη ροή Pay with PayPal όπου ο πληρωτής αναθεωρεί και επιβεβαιώνει την πληρωμή στο PayPal.
Η ροή checkout είναι ως εξής:
- Ένας πληρωτής μεταβαίνει στον ιστότοπο του καταστήματός σας, επιλέγει ένα προϊόν και κάνει κλικ στην επιλογή PayPal στη σελίδα checkout.
- Όταν ο πληρωτής κάνει κλικ στο κουμπί PayPal, εκτελείτε μια κλήση
Initiate Browser Payment
στην πύλη και ανακατευθύνετε τον πληρωτή στη διεύθυνση URL του PayPal που επιστρέφεται στην απόκριση. - Η πύλη ανακατευθύνει τον πληρωτή στο PayPal.
- Ο πληρωτής συνδέεται στον λογαριασμό του PayPal χρησιμοποιώντας τη σελίδα σύνδεσης PayPal.
- Ο πληρωτής εξετάζει τις πληροφορίες της χρέωσης και επιβεβαιώνει την πληρωμή κάνοντας κλικ στο κουμπί "Πληρωμή τώρα" στο PayPal.
- Η πύλη στέλνει μια απόκριση με τις λεπτομέρειες της συναλλαγής, η οποία υποδηλώνει την επιτυχία ή όχι της πληρωμής, ώστε να μπορείτε να παρουσιάσετε την κατάσταση στον πληρωτή.
{ "apiOperation":"INITIATE_BROWSER_PAYMENT", "browserPayment":{ "operation":"PAY", "paypal":{ "paymentConfirmation":"CONFIRM_AT_PROVIDER" }, "returnUrl":"Https://test.com" }, "order":{ "amount":"4.20", "currency":"USD" }, "sourceOfFunds":{ "type":"PAYPAL" } }
Με τις ροές checkout Checkout with PayPal και Pay with PayPal, μπορείτε να επιλέξετε να εμφανίσετε ένα κουμπί "Πληρωμή τώρα" ή ένα κουμπί "Συνέχεια" στο PayPal.
Το κουμπί "Πληρωμή τώρα" επιτρέπει στον πληρωτή να επιβεβαιώσει την πληρωμή στο PayPal πριν ανακατευθυνθεί στον ιστότοπο του καταστήματος. Αυτή η επιλογή σάς επιτρέπει να παρέχετε στον πληρωτή πιο γρήγορη εμπειρία checkout, καθώς ο πληρωτής ολοκληρώνει την πληρωμή στο PayPal.
Το κουμπί "Συνέχεια" επιτρέπει στον πληρωτή να ανακατευθυνθεί στον ιστότοπο του καταστήματός σας για να επιβεβαιώσει την πληρωμή μετά την προβολή όλων των λεπτομερειών της παραγγελίας. Αυτή η επιλογή σάς επιτρέπει να αλλάξετε την παραγγελία, αν είναι απαραίτητο, πριν αποδεχτείτε την πληρωμή (για παράδειγμα, προσθέτοντας έξοδα αποστολής και διακίνησης με βάση τη διεύθυνση που επιστρέφεται από το PayPal). Ή ακόμα μπορείτε να συμπεριλάβετε άλλα βήματα checkout, για παράδειγμα, up-selling στη σελίδα επιβεβαίωσης παραγγελίας.
Βλ. Επιβεβαίωση πληρωμής παρακάτω για λεπτομέρειες σχετικά με τον τρόπο υλοποίησης αυτής της ενοποίησης του PayPal.
Ανάλογα με τη ροή checkout, Checkout with PayPal ή Pay with PayPal, μπορείτε να επιλέξετε τη συλλογή της διεύθυνσης αποστολή του πληρωτή στον ιστότοπο του καταστήματός σας ή στο PayPal αντιστοίχως. Από προεπιλογή, το PayPal συλλέγει τη διεύθυνση αποστολής από τον πληρωτή στο PayPal, την οποία ο πληρωτής μπορεί να προσθέσει ή να επεξεργαστεί αν είναι απαραίτητο. Μπορείτε να επιλέξετε να μην εμφανίζεται η διεύθυνση αποστολής ή/και να απενεργοποιήσετε την επεξεργασία. Βλ. Εμφάνιση/παράκαμψη διεύθυνσης αποστολής παρακάτω για πληροφορίες σχετικά με τον τρόπο υλοποίησης αυτής της ενοποίησης του PayPal.
Ενοποίηση PayPal
Το PayPal ως επιλογή checkout Hosted Checkout
Αν χρησιμοποιείτε τη σελίδα πληρωμής του American Express PSP (Hosted Checkout), το PayPal θα προσφερθεί αυτόματα ως επιλογή checkout στους πληρωτές σας αν ο your payment service provider έχει διαμορφώσει τον σύνδεσμο σε τράπεζα εμπόρου για το PayPal στο προφίλ εμπόρου σας. Για λεπτομέρειες, βλ. Πληρωμές μέσω browser με ενοποίηση Hosted Checkout.
Το PayPal ως επιλογή checkout στη σελίδα πληρωμής
Μπορείτε να προσθέσετε το PayPal ως επιλογή checkout στη σελίδα πληρωμής αν έχει γίνει ενοποίηση με API έκδοση 50 ή νεότερη. Πρέπει να υποβάλετε το αίτημα Initiate Browser Payment
από την εφαρμογή server για έναρξη της αλληλεπίδρασης με το PayPal.
Ο πληρωτής ανακατευθύνεται από τον ιστότοπο του καταστήματός σας στο PayPal για να συνδεθεί και να συμπληρώσει τις λεπτομέρειες πληρωμής. Για λεπτομέρειες, βλ. PayPal μέσω Direct Payment.
PayPal μέσω Direct Payment
Τα παρακάτω πεδία στο αίτημα Initiate Browser Payment είτε είναι ειδικά για το PayPal είτε έχουν ειδική χρήση στην ενοποίηση του PayPal. Για άλλες λεπτομέρειες, βλ. Πληρωμές μέσω browser με ενοποίηση του Direct Payment.
sourceOfFunds.type = PAYPAL
browserPayment.operation
=AUTHORIZE
ήPAY
Με το PayPal, τα χρήματα μπορούν να κρατηθούν για 3 ημέρες (περίοδος valeur) από τη στιγμή που έγινε η έγκριση. Αν εξακολουθείτε να θέλετε να δεσμεύσετε τα χρήματα μετά από 3 ημέρες, μπορείτε να χρησιμοποιήσετε την πράξη Update Authorization ή να κάνετε έναρξη μέσω του Merchant Administration.
Από προεπιλογή, ο λογαριασμός εμπόρου του PayPal έχει ρυθμιστεί μόνο για μοναδικές δεσμεύσεις. Αν θέλετε να αλλάξετε τη διαμόρφωση για να υποστηρίξετε πολλαπλές δεσμεύσεις, επικοινωνήστε με την PayPal.-
browserPayment.paypal.paymentConfirmation
Όταν ξεκινάτε μια πληρωμή PayPal, πρέπει να καθορίσετε αν θέλετε ο πληρωτής να επιβεβαιώσει την πληρωμή στο PayPal ή στον ιστότοπο του καταστήματός σας.
Πεδίο επιβεβαίωσης πληρωμής - Αναφορά API [REST][NVP]
Αν επιβεβαιώσετε στον πάροχο (PayPal), το PayPal εμφανίζει ένα κουμπί "Πληρωμή τώρα" που επιτρέπει στον πληρωτή να επιβεβαιώσει την πληρωμή στο PayPal πριν ανακατευθυνθεί στον ιστότοπο του καταστήματος. Πρέπει να υποβάλετε ένα αίτημα
Retrieve Transaction
στο American Express PSP για να καθορίσετε την επιτυχία ή όχι της πληρωμής.Αν γίνει επιβεβαίωση για τον ιστότοπο καταστήματος, το PayPal εμφανίζει ένα κουμπί "Συνέχεια" που επιτρέπει στον πληρωτή να ανακατευθυνθεί στον ιστότοπο του καταστήματος, όπου μπορεί να επιβεβαιώσει την πληρωμή. Πρέπει να στείλετε ένα αίτημα
Retrieve Transaction
στην πύλη για να ανακτήσετε τις λεπτομέρειες σχετικά με το αν ο πληρωτής συνέχισε με την πληρωμή ή όχι. Αν ο πληρωτής συνεχίσει με την πληρωμή στον ιστότοπο του καταστήματός σας, πρέπει να στείλετε μια κλήσηConfirm Browser Payment
για να επιβεβαιώσετε την πληρωμή με το PayPal. Η απόκρισηConfirm Browser Payment
θα περιέχει πληροφορίες σχετικά με την επιτυχία ή όχι της πληρωμής.Confirm Browser Payment - Αναφορά API [REST][NVP]
Και στις δύο περιπτώσεις, αν η πληρωμή είναι επιτυχής, η πράξη Retrieve Transaction επιστρέφει:
- τη διεύθυνση email του λογαριασμού PayPal του πληρωτή
- το όνομα του κατόχου του λογαριασμού για τον λογαριασμό PayPal του πληρωτή
- το ID πληρωτή που συσχετίζεται με τον λογαριασμό PayPal ενός πληρωτή'
- τις λεπτομέρειες διεύθυνσης αποστολής
Παράδειγμα αιτήματος{ "apiOperation":"CONFIRM_BROWSER_PAYMENT", "order":{ "amount":"4.20", "currency":"USD" } }
-
[Προιρετικά] Εμφάνιση/παράκαμψη διεύθυνσης αποστολής
Μπορείτε να διαχειριστείτε τον τρόπο με τον οποίο ο πληρωτής σάς παρέχει μια διεύθυνση αποστολής χρησιμοποιώντας δύο πεδία:
browserPayment.paypal.displayShippingAddress
— όταν ρυθμιστεί σε true (προεπιλογή), η διεύθυνση αποστολής εμφανίζεται στο PayPal.Πεδίο εμφάνισης διεύθυνσης αποστολής - Αναφορά API [REST][NVP]
browserPayment.paypal.overrideShippingAddress
— όταν ρυθμιστεί σε true (προεπιλογή), ο πληρωτής μπορεί να αλλάξει τη διεύθυνση αποστολής στο PayPal.Πεδίο παράκαμψης διεύθυνσης αποστολής - Αναφορά API [REST][NVP]
Από προεπιλογή, το PayPal συλλέγει τη διεύθυνση αποστολής από τον πληρωτή στο PayPal για λογαριασμό σας. Αν επιλέξετε να συλλέξετε τη διεύθυνση αποστολής από τον πληρωτή στον ιστότοπο του καταστήματός σας και δεν θέλετε το PayPal να εμφανίσει τη διεύθυνση αποστολής στον πληρωτή, πρέπει να ορίσετε το
browserPayment.paypal.displayShippingAddress
σε false. Αυτό ισχύει επίσης όταν δεν απαιτείται διεύθυνση αποστολής για μια παραγγελία (για παράδειγμα, μόνο για ψηφιακά προϊόντα).Η πύλη θα επιστρέφει πάντα τη διεύθυνση αποστολής στην απόκριση
Retrieve Transaction
αν η διεύθυνση δόθηκε στο αίτημαInitiate Browser Payment
ή αν τοbrowserPayment.paypal.displayShippingAddress
έχει οριστεί σε true.Θα πρέπει να χρησιμοποιήσετε τη διεύθυνση αποστολής που επιστρέφεται στην απόκριση συναλλαγής σε περίπτωση που η διεύθυνση αποστολής άλλαξε από τον πληρωτή στο PayPal. Σημειώστε ότι το PayPal επικυρώνει τους συνδυασμούς πόλης, πολιτείας, ταχυδρομικού κώδικα για διευθύνσεις αποστολής στις ΗΠΑ. -
[Προαιρετικά] Λεπτομέρειες είδους γραμμής
Μπορείτε να ορίσετε λεπτομέρειες είδους γραμμής στο αίτημα
Initiate Browser Payment
για να παρέχετε στους πληρωτές όλες τις λεπτομέρειες της παραγγελίας πριν επιβεβαιώσουν την πληρωμή. Η έρευνα καταναλωτών δείχνει ότι περισσότεροι αγοραστές ολοκληρώνουν τις αγορές όταν βλέπουν τα μεμονωμένα είδη και άλλες λεπτομέρειες μιας παραγγελίας κατά το checkout στο PayPal. Ως εκ τούτου, συνιστάται να παρέχετε πληροφορίες για την παραγγελία όταν ξεκινάτε ένα checkout στο PayPal για να παροτρύνετε τους πληρωτές να συνεχίσουν την πληρωμή αντί να την εγκαταλείψουν.Τα είδη γραμμής θεωρούνται ότι παρέχονται αν καθορίζεται το όνομα του είδους ή η τιμή μονάδας. Για περισσότερες πληροφορίες σχετικά με τις λεπτομέρειες είδους γραμμής, βλ. Δεδομένα είδους γραμμής.
Τρόπος ερμηνείας του αποτελέσματος της συναλλαγής
Ο παρακάτω πίνακας δείχνει τους κωδικούς απόκρισης συναλλαγής για τα πιθανά σενάρια που ενδέχεται να αντιμετωπίσετε μετά την έναρξη μιας πληρωμής μέσω browser.
Απόκριση Initiate Browser Payment |
Τι σημαίνει αυτό... |
---|---|
response.gatewayCode=SUBMITTED result=SUCCESS |
Ανακατευθύνετε τον πληρωτή χρησιμοποιώντας τη διεύθυνση URL που δίνεται στην απόκριση. |
response.gatewayCode=SUBMITTED result=FAILURE or PENDING or UNKNOWN |
Υποβολή άλλου αιτήματος INITIATE_BROWSER_PAYMENT . |
Απόκριση Retrieve Transaction/Retrieve Order |
Τι σημαίνει αυτό... |
response.gatewayCode=APPROVED result=SUCCESS |
Η πληρωμή είναι επιτυχής. |
response.gatewayCode= PENDING result=PENDING |
Για την πληρωμή εκκρεμεί αναθεώρηση στο σύστημα PayPal. Βλ. Πληρωμές σε εκκρεμότητα. |
response.gatewayCode= CANCELLED result=FAILURE |
Ο πληρωτής έχει ακυρώσει την αλληλεπίδραση για αυτή την πληρωμή. Προσφέρετε στον πληρωτή τη δυνατότητα να δοκιμάσει έναν άλλο τρόπο πληρωμής. |
response.gatewayCode= DECLINED or INSUFFICIENT_FUNDS or NOT_SUPPORTED result=FAILURE |
Η πληρωμή απορρίφθηκε από το PayPal. |
response.gatewayCode= ACQUIRER_SYSTEM_ERROR result=FAILURE |
Η τράπεζα εμπόρου δεν μπόρεσε να διεκπεραιώσει τη συναλλαγή. Ίσως θελήσετε να ρωτήσετε την τράπεζα εμπόρου για τον λόγο της αποτυχίας πληρωμής ή μπορείτε να δοκιμάσετε ξανά τη συναλλαγή RETRIEVE_TRANSACTION . Εναλλακτικά, μπορείτε να προσφέρετε στον πληρωτή τη δυνατότητα να δοκιμάσει έναν άλλο τρόπο πληρωμής. |
response.gatewayCode= SYSTEM_ERROR result=FAILURE |
Η πύλη δεν μπόρεσε να διεκπεραιώσει τη συναλλαγή. |
response.gatewayCode=TIMED_OUT result=FAILURE |
Η αλληλεπίδραση μεταξύ του πληρωτή και του συστήματος PayPal δεν ολοκληρώθηκε με επιτυχία, για παράδειγμα, η πύλη δεν έλαβε ανακατεύθυνση του browser του πληρωτή από τον έμπορο εντός 24 ωρών ή η πύλη δεν μπόρεσε να ανακτήσει τις λεπτομέρειες αλληλεπίδρασης μεταξύ του πληρωτή και του συστήματος PayPal, επομένως η πληρωμή δεν είναι ολοκληρωμένη. |
response.gatewayCode=UNKNOWN result=UNKNOWN |
Η πύλη δεν μπόρεσε να μάθει για την επιτυχία ή όχι της πληρωμής. |
Ενημερώσεις έγκρισης
Μπορείτε να ενημερώσετε την περίοδο διατήρησης της έγκρισης ή/και να προσαυξήσετε τα ποσά έγκρισης για έγκυρες συναλλαγές έγκρισης PayPal χρησιμοποιώντας την πράξη Update Authorization ή μέσω του Merchant Administration. Για να επιτραπεί αυτό, πρέπει να έχετε ενεργοποιήσει το δικαίωμα "Ενημέρωση έγκρισης" στο προφίλ εμπόρου σας από τον your payment service provider. Για περισσότερες πληροφορίες, βλ. την Update Authorization.
Συνιστάται να ενημερώσετε μια έγκριση μετά τις αρχικές 3 ημέρες (περίοδος διατήρησης) για να βεβαιωθείτε ότι τα χρήματα εξακολουθούν να είναι διαθέσιμα. Μια εκ νέου εγκεκριμένη πληρωμή έχει μια νέα περίοδο διατήρησης 3 ημερών. Η τιμή διατήρησης 3 ημερών μπορεί να ενημερωθεί το πολύ μία φορά εντός της περιόδου ισχύος 29 ημερών.
Μπορείτε να ενημερώσετε μια έγκριση μία φορά για μέγιστο ποσοστό 115% ή USD $75 του αρχικά εγκεκριμένου ποσού.
Δεσμεύσεις, επιστροφές χρημάτων και ακυρώσεις
Για πληρωμές PayPal, μπορείτε να δεσμεύσετε το εγκεκριμένο ποσό εν μέρει ή στο ακέραιο από το αρχικά εγκεκριμένο ποσό χρησιμοποιώντας την πράξη Capture ή μέσω του Merchant Administration.
Μπορείτε να επιστρέψετε πληρωμές που διεκπεραιώθηκαν μέσω του PayPal εν μέρει ή στο ακέραιο για συναλλαγές Pay και Capture. Μπορείτε να υποβάλετε αιτήματα επιστροφής χρημάτων χρησιμοποιώντας την πράξη Refund ή χρησιμοποιώντας το Merchant Administration.
Μπορείτε να ακυρώσετε οποιαδήποτε συναλλαγή Authorized αν οι προσπάθειες δέσμευσης έχουν αποτύχει ή αν μπορείτε να επιστρέψετε τα χρήματα για μια συναλλαγή Pay για να αντιστρέψετε την πληρωμή. Μπορείτε να υποβάλετε το αίτημα Void ή Refund χρησιμοποιώντας την πράξη API Void και Refund ή μέσω του Merchant Administration.
Πληρωμές σε εκκρεμότητα
Η πύλη μπορεί να επιστρέψει μια κατάσταση PENDING στην απόκριση συναλλαγής. Για παράδειγμα, αν η συναλλαγή βρίσκεται υπό αξιολόγηση κινδύνου στο PayPal. Αν η κατάσταση είναι σε εκκρεμότητα και αν έχετε διαμορφώσει τα δικά σας φίλτρα διαχείρισης απάτης, θα πρέπει να συνδεθείτε στον επαγγελματικό λογαριασμό PayPal και να ελέγξετε την πληρωμή. Το PayPal θα ειδοποιήσει την πύλη όταν η κατάσταση μιας εκκρεμούς συναλλαγής ενημερώνεται από το PayPal.
Συμφωνία χρέωσης και επαναλαμβανόμενες πληρωμές
Χρησιμοποιώντας το Checkout with PayPal ή το Pay with PayPal, μπορείτε να ρυθμίσετε μια συμφωνία χρέωσης για έναν πληρωτή, η οποία σας επιτρέπει να ξεκινήσετε μια συναλλαγή αναφοράς (συνδρομή/επαναλαμβανόμενες πληρωμές ή πληρωμές κατ' απαίτηση) έναντι αυτής της συμφωνίας χρέωσης, χωρίς επιπρόσθετη συγκατάθεση του πληρωτή. Για περισσότερες πληροφορίες, βλ. Συμφωνία χρέωσης και επαναλαμβανόμενες πληρωμές.
Διαμόρφωση της ενοποίησης PayPal σας
Για την επεξεργασία της συναλλαγής μέσω του PayPal, πρέπει να χορηγήσετε στην πύλη άδεια να υποβάλλει αιτήματα συναλλαγών στο PayPal για λογαριασμό σας. Για να χορηγήσετε δικαιώματα τρίτου μέρους, πρέπει να συνδεθείτε στην πύλη Merchant Administration. Στη σελίδα διαμόρφωσης PayPal, μπορείτε να δείτε τους συνδέσμους σε τράπεζα εμπόρου για το PayPal που έχει διαμορφώσει για λογαριασμό σας ο your payment service provider. Αν δεν έχετε χορηγήσει δικαιώματα τρίτου μέρους για τον σύνδεσμο σε τράπεζα εμπόρου, το πεδίο "ID λογαριασμού" παραμένει κενό. Ως εκ τούτου, πρέπει να χορηγήσετε δικαιώματα στην πύλη, ώστε η πύλη να μπορεί να πραγματοποιεί κλήσεις API για λογαριασμό σας.
Για να χορηγήσετε δικαιώματα τρίτου μέρους για PayPal API με νέο λογαριασμό email.
- Για να χορηγήσετε δικαιώματα τρίτου μέρους για ένα συγκεκριμένο σύνδεσμο τράπεζας εμπόρου, επιλέξτε Ενεργοποίηση.
- Εισαγάγετε τις απαιτούμενες λεπτομέρειες στη σελίδα PayPal και, στη συνέχεια, επιλέξτε Επόμενο.
- Εισαγάγετε τις απαιτούμενες λεπτομέρειες και επιλέξτε τα πλαίσια ελέγχου Συμφωνία χρήστη, Δήλωση απορρήτου.
- Επιλέξτε Συμφωνία και δημιουργία λογαριασμού.
- Εισαγάγετε τις πληροφορίες που αφορούν την επιχείρηση και, στη συνέχεια, κάντε κλικ στο κουμπί Επόμενο.
- Εισαγάγετε τις πληροφορίες που αφορούν τον χρήστη και, στη συνέχεια, κάντε κλικ στο κουμπί Υποβολή.
Η σελίδα επιβεβαίωσης εγγραφής εμφανίζει τις οδηγίες για την ενεργοποίηση του λογαριασμού σας PayPal.
- Ενεργοποιήστε τον λογαριασμό σας στο PayPal σύμφωνα με τις οδηγίες που αποστέλλονται στη διεύθυνση email που καταχωρήσατε κατά την εγγραφή.
- Ακολουθήστε τις οδηγίες στην οθόνη για να επιστρέψετε στη σελίδα Merchant Administration.
Χορηγούνται τα δικαιώματα τρίτου μέρους που απαιτούνται για τον συγκεκριμένο σύνδεσμο σε τράπεζα εμπόρου PayPal. Η κατάσταση ενεργοποιείται και εμφανίζεται το ID του λογαριασμού PayPal.
- Για να ανακαλέσετε την άδεια τρίτου μέρους, επιλέξτε Απενεργοποίηση και για να ενημερώσετε τις πληροφορίες, επιλέξτε Ενημέρωση.
Αν αποτύχει η άδεια τρίτου μέρους λόγω οποιουδήποτε προβλήματος, εμφανίζεται ένα μήνυμα σφάλματος.
Για να χορηγήσετε δικαιώματα τρίτου μέρους για τα PayPal API με καταχωρημένο λογαριασμό email:
- Για να χορηγήσετε δικαιώματα τρίτου μέρους για ένα συγκεκριμένο σύνδεσμο τράπεζας εμπόρου, επιλέξτε Ενεργοποίηση.
- Εισαγάγετε τις απαιτούμενες λεπτομέρειες στη σελίδα PayPal και, στη συνέχεια, επιλέξτε Επόμενο.
- Εισαγάγετε τα διαπιστευτήριά σας και, στη συνέχεια, επιλέξτε Σύνδεση.
Έχετε εγγραφεί και ενοποιηθεί με επιτυχία το PayPal.
- Ακολουθήστε τις οδηγίες στην οθόνη για να επιστρέψετε στη σελίδα Merchant Administration.
Χορηγούνται τα δικαιώματα τρίτου μέρους που απαιτούνται για τον συγκεκριμένο σύνδεσμο σε τράπεζα εμπόρου PayPal. Η κατάσταση ενεργοποιείται και εμφανίζεται το ID του λογαριασμού PayPal.
- Για να ανακαλέσετε την άδεια τρίτου μέρους, επιλέξτε Απενεργοποίηση και για να ενημερώσετε τις πληροφορίες, επιλέξτε Ενημέρωση.
Αν αποτύχει η άδεια τρίτου μέρους λόγω οποιουδήποτε προβλήματος, εμφανίζεται ένα μήνυμα σφάλματος.
Βελτιωμένη προστασία πωλητή
Μπορείτε να υποβάλετε πρόσθετα δεδομένα πληρωτή στο Initiate Browser Payment
και στα επόμενα αιτήματα Pay ή Authorize μετά την εκτέλεση Tokenize Browser Payment
, ώστε να επιτραπεί στο PayPal να πραγματοποιήσει εκτίμηση κινδύνου της συναλλαγής πριν από τη διεκπεραίωση της συναλλαγής.
Τα δεδομένα στα παρακάτω πεδία χρησιμοποιούνται από το PayPal για την εκτίμηση της διαχείρισης κινδύνου πριν από τη συναλλαγή:
device.fingerprint
: Ένα μοναδικό αναγνωριστικό για τη συσκευή που μπορεί να δημιουργηθεί δημιουργώντας τη βιβλιοθήκη PayPal FraudNet Javascript. Αυτό επιτρέπει στο PayPal να εκτελεί εκτίμηση κινδύνου της συναλλαγής.risk.custom
: Μπορείτε να δώσετε πρόσθετα δεδομένα σχετικά με την πληρωμή σε αυτό το πεδίο. Πρέπει να έχετε συμφωνία με το PayPal σχετικά με τις τιμές που θέλετε να παρέχετε. Για παράδειγμα,risk.custom.headOfficeLocation
=Λονδίνο, ΗΒ.sourceOfFunds.token
: Το αναγνωριστικό token που προσδιορίζει τις λεπτομέρειες της συμφωνίας χρέωσης (όπως λαμβάνονται από το PayPal) στην πύλη. Μπορείτε να χρησιμοποιήσετε αυτό το αναγνωριστικό token για εφάπαξ και επαναλαμβανόμενες πληρωμές. Για περισσότερες πληροφορίες, βλ. Συμφωνία χρέωσης και επαναλαμβανόμενες πληρωμές.Για άμεση πληρωμή, τοsourceOfFunds
είναι το PayPal.
Επιπλέον πιστωτικό υπόλοιπο
Η επιλογή για επιπλέον πιστωτικό υπόλοιπο πρέπει να είναι ενεργοποιημένη στον ιστότοπο PayPal. Μπορείτε να δεσμεύσετε το εγκεκριμένο πιστωτικό υπόλοιπο χρησιμοποιώντας το αίτημα Capture ή μέσω του Merchant Administration.
Επιτρέπεται πιστωτική δέσμευση έως και 115% της αρχικής εγκεκριμένης συναλλαγής. Μπορείτε να επιστρέψετε πιστωτικές πληρωμές που διεκπεραιώθηκαν μέσω του PayPal για τις συναλλαγές Pay και Capture.
Μπορείτε να υποβάλετε αιτήματα επιστροφής χρημάτων μέσω της πράξης Refund ή χρησιμοποιώντας το Merchant Administration.
Για επιστροφή του πιστωτικού υπόλοιπου, συμπεριλάβετε το ποσό που είναι επιπλέον από το αρχικό ποσό συναλλαγής. Για επιστροφή του πιστωτικού υπολοίπου επί του δεσμευμένου ποσού, βεβαιωθείτε ότι έχετε ενεργοποιηθεί για την επιστροφή πιστωτικού υπολοίπου στο προφίλ εμπόρου σας στο PayPal.
Αν το προφίλ σας στο PayPal είναι ενεργοποιημένο για επιστροφή του πιστωτικού υπολοίπου, πρέπει να διαμορφώσετε το προφίλ εμπόρου σας στο American Express PSP για αυτό.
Δοκιμή της ενοποίησής σας
Το American Express PSP παρέχει έναν προσομοιωτή PayPal που σας επιτρέπει να δοκιμάσετε την ενοποίηση για χρήση της λειτουργίας PayPal μέσω της πύλης.