PayPal

Τι χρειάζεστε

Γιατί ζητάμε κάθε πεδίο

Client ID

Ταυτοποιεί την εφαρμογή PayPal σας στις κλήσεις API. Λειτουργεί μόνο όταν συνδυάζεται με το Client secret.

Client secret

Το ιδιωτικό μισό του ελέγχου ταυτότητας API. Μαζί με το Client ID, μας επιτρέπει να δημιουργήσουμε την παραγγελία, ώστε η πληρωμή να περάσει μέσα από τον λογαριασμό σας.

Webhook ID

Πώς επιβεβαιώνουμε ότι ένα webhook προέρχεται πραγματικά από το PayPal: το PayPal ταυτοποιεί κάθε webhook με ένα ID, και το χρησιμοποιούμε για να ρωτήσουμε το PayPal απευθείας αν ένα δεδομένο μήνυμα είναι αυθεντικό. Αυτό σταματά οποιονδήποτε από το να πλαστογραφήσει ένα συμβάν "paid".

Success and Cancel URL

Απλές ρυθμίσεις: πού καταλήγει ο αγοραστής αφού πληρώσει ή υπαναχωρήσει. Δεν είναι μυστικό.

Ρύθμιση

1. Δημιουργήστε έναν δωρεάν λογαριασμό προγραμματιστή (χωρίς πληρωμή)

   Ο ιστότοπος προγραμματιστών του PayPal σας δίνει λογαριασμούς δοκιμής sandbox χωρίς κόστος, συμπεριλαμβανομένου ενός ψεύτικου επαγγελματικού λογαριασμού και ενός ψεύτικου αγοραστή.

   1. Συνδεθείτε στο developer.paypal.com.
   2. Χρησιμοποιήστε τον διακόπτη Sandbox / Live για να εναλλάξετε περιβάλλοντα. Ρυθμίστε πρώτα το sandbox, μετά επαναλάβετε στο live.
2. Δημιουργήστε μια εφαρμογή και αντιγράψτε τα διαπιστευτήριά της

   Πηγαίνετε στο Apps & Credentials, ανοίξτε ή δημιουργήστε μια εφαρμογή, και αντιγράψτε το Client ID και το Client secret. Η εφαρμογή sandbox και η εφαρμογή live έχουν η καθεμία το δικό της ζεύγος.

   ⤢
3. Προσθέστε το webhook
   1. Στην ίδια εφαρμογή, προσθέστε ένα webhook.
   2. Ορίστε το webhook URL στη διεύθυνση webhook του έργου σας (παρακάτω).
   3. Εγγραφείτε σε συμβάντα. Εφάπαξ πληρωμές: CHECKOUT.ORDER.APPROVED, PAYMENT.CAPTURE.COMPLETED, PAYMENT.CAPTURE.DENIED, PAYMENT.CAPTURE.DECLINED, PAYMENT.CAPTURE.REFUNDED, PAYMENT.CAPTURE.REVERSED, CUSTOMER.DISPUTE.CREATED. Συνδρομές: BILLING.SUBSCRIPTION.ACTIVATED, BILLING.SUBSCRIPTION.UPDATED, BILLING.SUBSCRIPTION.CANCELLED, BILLING.SUBSCRIPTION.PAYMENT.FAILED, PAYMENT.SALE.COMPLETED. Τα επιπλέον συμβάντα είναι ακίνδυνα.
   4. Αντιγράψτε το Webhook ID που αναθέτει το PayPal. Καταχωρίστε ξεχωριστό webhook σε sandbox και σε live.

   https://api.coinmoebius.com/webhook/paypal/<your project id>

   ⤢
4. Δοκιμάστε με έναν αγοραστή sandbox

   Συνδεθείτε στο www.sandbox.paypal.com με τον λογαριασμό αγοραστή sandbox από τον πίνακα ελέγχου προγραμματιστή σας και πληρώστε μέσα από ένα δοκιμαστικό checkout. Δεν κινούνται πραγματικά χρήματα.

5. Συνδέστε στον πίνακα ελέγχου

   Add provider → PayPal. Εισαγάγετε Success URL, Cancel URL, και την ομάδα Live (Client ID, Client secret, Webhook ID). Προσθέστε την προαιρετική ομάδα Sandbox για δοκιμή. Η ομάδα Sandbox είναι όλα ή τίποτα: και τα τρία πεδία, ή κανένα. Το live και το sandbox ελέγχονται ξεχωριστά.

Αφού συνδεθείτε

Κάντε μία δοκιμαστική πληρωμή πριν βγείτε live:

1. Δημιουργήστε ένα προϊόν και ορίστε το Environment του σε Testing. Αυτό τρέχει το προϊόν στα διαπιστευτήρια sandbox σας, ώστε να κάνετε μια πλήρη παραγγελία χωρίς να κινηθούν χρήματα. (Αν παραλείψατε το σύνολο sandbox, ένα προϊόν Testing επιστρέφει στο live, οπότε προσθέστε το πρώτα.)
2. Τοποθετήστε το κουμπί αγοράς σε μια σελίδα (ένα τοπικό αρχείο HTML λειτουργεί) που δείχνει στο έργο σας.
3. Ολοκληρώστε το checkout πληρώνοντας με τον λογαριασμό αγοραστή sandbox σας.
4. Ανοίξτε την καρτέλα Transactions. Μια νέα γραμμή εμφανίζεται, με ετικέτα Testing. Όταν η κατάστασή της φτάσει στο succeeded, τα διαπιστευτήριά σας και το webhook λειτουργούν και τα δύο από άκρη σε άκρη.

Αλλάξτε το Environment του προϊόντος σε Live όταν είστε έτοιμοι για πραγματικές πληρωμές.

Αντιμετώπιση προβλημάτων

Ξεκινήστε με το Verify. Στον πίνακα ελέγχου, κάντε κλικ στο Verify (ή Verify test credentials για sandbox) για να ελέγξετε τα διαπιστευτήρια client σας.

Το Verify αποτυγχάνει.

Αντιγράψτε ξανά το Client ID και το Client secret. Η εφαρμογή sandbox και η εφαρμογή live έχουν διαφορετικά ζεύγη, οπότε μην τα μπερδεύετε.

Η πληρωμή ολοκληρώνεται αλλά η παραγγελία μένει σε εκκρεμότητα.

Το Webhook ID πρέπει να προέρχεται από την ίδια εφαρμογή και περιβάλλον με τα διαπιστευτήρια client σας. Τα live διαπιστευτήρια χρειάζονται το live webhook id. Επιβεβαιώστε ότι το webhook URL ταιριάζει.

Επιβεβαιώστε το από άκρη σε άκρη.

PayPal Developer Dashboard → Webhooks Simulator: στείλτε ένα δείγμα συμβάντος στο webhook URL σας, και μετά παρακολουθήστε την παραγγελία να ενημερώνεται.

Καλό να γνωρίζετε

Εναλλαγή μυστικών. Δημιουργήστε ένα νέο client secret οποτεδήποτε, μετά επικολλήστε το. Τα μυστικά πεδία μένουν κενά κατά την επεξεργασία.

Ερωτήσεις; Join our Discord