- Κατευθυντήριες οδηγίες ενοποίησης
- Υποστηριζόμενες δυνατότητες (Τρόποι πληρωμής)
- Υλοποίηση μιας ενοποίησης πληρωμής μέσω browser
- Πληρωμές Trustly
Trustly
Το Trustly είναι μια πληρωμή μέσω τραπεζικής μεταφοράς. Μέσω του Trustly, οι πληρωτές μπορούν να πραγματοποιούν γρήγορες, απλές και ασφαλείς πληρωμές απευθείας από τους τραπεζικούς λογαριασμούς τους, χωρίς κίνδυνο κλοπής στοιχείων ή απάτης. Οι πληρωμές μπορούν επίσης να πραγματοποιούν πληρωμές ηλεκτρονικού εμπορίου και να ταυτοποιούν την πληρωμή μέσω του υπάρχοντος περιβάλλοντος εργασίας της online τράπεζας.
Συνιστάται να διαβάσετε τις οδηγίες ενοποίησης για πληρωμές μέσω browser, πριν δομήσετε την ενοποίηση για το Trustly.
Προαπαιτούμενα
Για την προσφορά του Trustly ως τρόπου πληρωμής μέσω του <<paymentGateway>>:
- πρέπει να είστε εγγεγραμμένοι στον πάροχο υπηρεσιών πληρωμής μέσω browser
- το προφίλ εμπόρου σας στο <<paymentGateway>> πρέπει να διαμορφωθεί χρησιμοποιώντας τις λεπτομέρειες του λογαριασμού που έχετε με τον πάροχο υπηρεσιών πληρωμής μέσω browser, και
- πρέπει να διαθέτετε τραπεζικό λογαριασμό σε ένα από τα υποστηριζόμενα νομίσματα που έχουν καταχωρηθεί για τον λογαριασμό εμπόρου σας με τον πάροχο υπηρεσιών πληρωμής μέσω browser.
Συναλλαγές Trustly
Το Trustly υποστηρίζει συναλλαγές που προέρχονται από διάφορες χώρες με τα αντίστοιχα νομίσματά τους.
| Χώρα | Νόμισμα |
|---|---|
| Αυστρία (AUT) | EUR |
| Γερμανία (DEU) | EUR |
| Δανία (DNK) | EUR, DK |
| Εσθονία (EST) | EUR |
| Ισπανία (ESP) | EUR |
| Φινλανδία (FIN) | EUR |
| Μεγάλη Βρετανία (GBR) | GBP |
| Λιθουανία (LTU) | EUR |
| Λετονία (LVA) | EUR |
| Κάτω Χώρες (NLD) | EUR |
| Νορβηγία (NOR) | EUR, NOK |
| Πορτογαλία (PRT) | EUR |
| Σουηδία (SWE) | EUR, SEK |
Ενοποίηση Trustly
Η ενοποίηση <<checkout>> σάς επιτρέπει να συλλέγετε τις λεπτομέρειες πληρωμής από τον πληρωτή σας μέσω μιας αλληλεπίδρασης που φιλοξενείται και εμφανίζεται από το <<paymentGateway>>.
Από το API έκδοση 65 και νεότερη, το Trustly είναι αυτόματα διαθέσιμο ως τρόπος πληρωμής μόλις το <<paymentServiceProvider>> σάς ενεργοποιεί και σας διαμορφώνει για αυτόν τον τρόπο πληρωμής.
Για λεπτομέρειες, βλ. Πληρωμές μέσω browser με ενοποίηση <<checkout>>.
Η ενοποίηση <<directPayment>> σάς επιτρέπει να προσφέρετε τον τρόπο πληρωμής Trustly στη δική σας σελίδα checkout.
Επιπλέον των βασικών πεδίων που απαιτούνται σε ένα αίτημα πληρωμής μέσω browser, πρέπει να δώσετε τα ακόλουθα πεδία στο αίτημα Initiate Browser Payment:
Κοινά πεδία
sourceOfFunds.type=TrustlybrowserPayment.operation=PAY (Trustly does not support the Authorize operation)customer.account.id=The ID, username, hash, or anything that is used to identify the consumercustomer.email=Email address of a payersourceOfFunds.provided.trustly.bankAccountHolder=Name of the bank account holder for the payer's bank accountsourceOfFunds.provided.trustly.bankAccountCountryCode=The country where payers have their bank account. Provide the ISO 3166 alpha-3 country code for this country.
Προτιμώμενη γλώσσα
Μπορείτε να ορίσετε τη γλώσσα που προτιμάτε να χρησιμοποιεί το Trustly για τις σελίδες που εμφανίζονται στον πληρωτή δίνοντας το πεδίο browserPayment.preferredLanguage στο αίτημα Initiate Browser Payment. Ωστόσο, η γλώσσα θα χρησιμοποιηθεί μόνο αν υποστηρίζεται από το Trustly.
{
"apiOperation": "INITIATE_BROWSER_PAYMENT",
"billing": {
"address": {
"country": "POL"
}
},
"browserPayment": {
"operation": "PAY",
"returnUrl": "<your_merchant_URL>"
},
"customer": {
"email": "john.smith@example.com",
"account": {
"id": "Customer"
}
},
"order": {
"amount": 100,
"currency": "PLN"
},
"sourceOfFunds": {
"type": "TRUSTLY",
"provided": {
"trustly": {
"bankAccountHolder": "Test Tester",
"bankAccountCountryCode": "POL"
}
}
}
}
Τρόπος ερμηνείας του αποτελέσματος της συναλλαγής
Ο πίνακας καθορίζει τους κωδικούς απόκρισης συναλλαγής για τα πιθανά σενάρια που ενδέχεται να αντιμετωπίσετε μετά την έναρξη μιας πληρωμής Trustly.
| Απόκριση Initiate Browser Payment | Τι σημαίνει αυτό... |
|---|---|
response.gatewayCode=SUBMITTEDresult=SUCCESS |
Ανακατευθύνετε τον πληρωτή χρησιμοποιώντας τη διεύθυνση URL που δίνεται στην απόκριση. |
| Απόκριση Retrieve Transaction/Retrieve Order | Τι σημαίνει αυτό... |
response.gatewayCode=APPROVEDresult=SUCCESS |
Η πληρωμή είναι επιτυχής. |
response.gatewayCode=PENDINGresult=PENDING |
Το <<paymentGateway>> περιμένει μια ειδοποίηση από την τράπεζα εμπόρου σχετικά με το αποτέλεσμα της πληρωμής. Δοκιμάστε ξανά το RETRIEVE_TRANSACTION αργότερα ή ακούστε ειδοποιήσεις από το <<paymentGateway>>. |
response.gatewayCode=CANCELLEDresult=FAILURE |
Ο πληρωτής έχει ακυρώσει την αλληλεπίδραση για αυτή την πληρωμή. Προσφέρετε στον πληρωτή τη δυνατότητα να δοκιμάσει έναν άλλο τρόπο πληρωμής. |
response.gatewayCode=DECLINED ή ACQUIRER_SYSTEM_ERRORresult=FAILURE |
Η πληρωμή απορρίφθηκε. Προσφέρετε στον πληρωτή τη δυνατότητα να δοκιμάσει έναν άλλο τρόπο πληρωμής. Στην περίπτωση ACQUIRER_SYSTEM_ERROR, ίσως θελήσετε να ρωτήσετε την τράπεζα εμπόρου σχετικά με τον λόγο της αποτυχίας πληρωμής ή μπορείτε να δοκιμάσετε ξανά τη συναλλαγή RETRIEVE_TRANSACTION. |
response.gatewayCode=TIMED_OUTresult=FAILURE |
Αντιμετωπίστε το αποτέλεσμα ως απόρριψη πληρωμής. Το <<paymentGateway>> θα επιχειρήσει να διασφαλίσει ότι η συναλλαγή δεν είναι επιτυχής ή θα αναστρέψει τη συναλλαγή. |
Επιστροφές χρημάτων
Μπορείτε να επιστρέψετε τα χρήματα από πληρωμές Trustly σε δόσεις ή στο ακέραιο. Βεβαιωθείτε ότι έχετε διαμορφωθεί για να επιστροφές χρημάτων στο <<paymentGateway>> και στον λογαριασμό εμπόρου που τηρείται με τον πάροχο υπηρεσιών πληρωμής μέσω browser.
Δοκιμή της ενοποίησής σας
Το <<paymentGateway>> παρέχει έναν εξομοιωτή πληρωμών μέσω browser που σας επιτρέπει να δοκιμάζετε την ενοποίηση Trustly.