- Κατευθυντήριες οδηγίες ενοποίησης
- Υποστηριζόμενες δυνατότητες (Τρόποι πληρωμής)
- Πληρωμές μέσω συσκευής
- Πληρωμές Samsung Pay
Samsung Pay
Το Samsung Pay είναι μια υπηρεσία πληρωμών και ψηφιακού πορτοφολιού μέσω κινητής συσκευής της Samsung Electronics που δίνει τη δυνατότητα στους πληρωτές να κάνουν πληρωμές με υποστηριζόμενες συσκευές Samsung. Το Samsung Pay είναι ένας υποστηριζόμενος τρόπος πληρωμής μέσω συσκευής στο Mastercard Gateway.
Αυτή η σελίδα περιγράφει τις λεπτομέρειες ενοποίησης ειδικά για το Samsung Pay. Συνιστάται να διαβάσετε τις κατευθυντήριες οδηγίες ενοποίησης για πληρωμές μέσω συσκευής, πριν δομήσετε την ενοποίηση για το Samsung Pay.
Προαπαιτούμενα
Για να αποδεχτείτε τις πληρωμές Samsung Pay:
- Πρέπει να εγγραφείτε στην Samsung.
- Το προφίλ εμπόρου σας στην πύλη πρέπει να είναι ενεργοποιημένο για "Πληρωμές μέσω συσκευής" από τον your payment service provider.
Προσθήκη υποστήριξης για το Samsung Pay στην ενοποίησή σας
Μπορείτε να ενοποιήσετε το Samsung Pay με την κινητή συσκευή σας με χρήση του Direct Payment.
- Κατά την επιβεβαίωση της πληρωμής, υποβάλετε το κρυπτογραφημένο token πληρωμής που επιστράφηκε από το Samsung Pay στο διακομιστή σας.
- Αποκρυπτογραφήστε το token πληρωμής στο διακομιστή σας με χρήση του ιδιωτικού σας κλειδιού. Για τα βήματα αποκρυπτογράφησης, επικοινωνήστε με τη Samsung.
- Συμπληρώστε τα κλειδιά από το αποκρυπτογραφημένο token στα αντίστοιχα πεδία συναλλαγής στο αίτημα Authorize/Pay ή το αίτημα Update Session.
Κλειδί JSON Samsung PayΑντίστοιχο πεδίο αιτήματος APIΠεριγραφήtokenPAN sourceOfFunds.provided.card.number O αριθμός κύριου λογαριασμού της συγκεκριμένης συσκευής. tokenPanExpiration sourceOfFunds.provided.card.expiry.month
sourceOfFunds.provided.card.expiry.yearΗ ημερομηνία λήξης του tokenPAN. method sourceOfFunds.provided.card.devicePayment.
cryptogramFormatΗ μορφή του κρυπτογράμματος. Ορίστε αυτό το πεδίο σε 3DSECURE. cryptogram sourceOfFunds.provided.card.devicePayment.
onlinePaymentCryptogramΚρυπτόγραμμα σε μορφή 3DSecure. eci_indicator sourceOfFunds.provided.card.devicePayment.
eciIndicatorΔείκτης ECI σύμφωνα με την προδιαγραφή 3DSecure. currency_code order.currency Ο κωδικός νομίσματος ISO 4217 για τη συναλλαγή. amount order.amount Το ποσό παραγγελίας. - Εκτός από τα παραπάνω πεδία, συμπεριλάβετε και τα παρακάτω στο αίτημα Authorize/Pay και υποβάλετέ το στην πύλη.
- transaction.source=INTERNET
- order.walletProvider=SAMSUNG_PAY
- device.mobilePhoneModel: (προαιρετικά) Το αναγνωριστικό της κινητής συσκευής που χρησιμοποιείται για την εκκίνηση της συναλλαγής.
- posTerminal.location: Μπορείτε να καθορίσετε
PAYER_TERMINAL_OFF_PREMISESήPAYER_TERMINAL_ON_PREMISES. Αν δεν δώσετε μια τιμή, χρησιμοποιείται η τιμήPAYER_TERMINAL_OFF_PREMISES.
Παράδειγμα αιτήματος
Παρακάτω είναι ένα δείγμα αιτήματος Authorization στο REST όπου το token πληρωμής έχει αποκρυπτογραφηθεί από την πύλη.
| URL | 'https://mepspay.gateway.mastercard.com/api/rest/version/71/merchant/MADA_DMS_AU/order/446974188/transaction/746444836' |
| Μέθοδος HTTP | PUT |
| Κεφαλίδα | 'Authorization: bWVyY2hhbnQuTUFEQV9ETVNfQVU6M2RjYTQ2YTU1ODYwNDlmMjhhM2FmZGJmZDEwMGNmNWQ=' |
'{
"apiOperation": "AUTHORIZE",
"order": {
"amount": "1500",
"currency": "JPY",
"walletProvider": "SAMSUNG_PAY"
},
"sourceOfFunds": {
"provided": {
"card": {
"number": "5123450000000008",
"expiry": {
"month": "01",
"year": "39"
},
"devicePayment": {
"cryptogramFormat": "3DSECURE",
"onlinePaymentCryptogram": "AAAAAAAALJI6DbfqRzUcwAC6gAAGhgEDoLABAAhAgAABAAAAMlkUxA==",
"eciIndicator": "20"
}
}
},
"type": "CARD"
},
"device": {
"ani": "12341234"
},
"transaction": {
"source": "INTERNET"
}
}'
Παράδειγμα απόκρισης
{
"authorizationResponse": {
"commercialCard": "123",
"commercialCardIndicator": "1",
"date": "0314",
"financialNetworkCode": "MCC",
"posData": "1025104006600",
"posEntryMode": "812",
"processingCode": "003000",
"responseCode": "00",
"stan": "47497",
"time": "105733",
"transactionIdentifier": "609405631",
"transactionIntegrityClass": "A1"
},
"device": {
"ani": "12341234"
},
"gatewayEntryPoint": "WEB_SERVICES_API",
"merchant": "MADA_DMS_AU",
"order": {
"amount": 1500,
"authenticationStatus": "AUTHENTICATION_NOT_IN_EFFECT",
"certainty": "FINAL",
"chargeback": {
"amount": 0,
"currency": "JPY"
},
"creationTime": "2023-03-14T10:57:33.175Z",
"currency": "JPY",
"id": "446974188",
"lastUpdatedTime": "2023-03-14T10:57:33.554Z",
"merchantAmount": 1500,
"merchantCategoryCode": "1234",
"merchantCurrency": "JPY",
"status": "AUTHORIZED",
"totalAuthorizedAmount": 1500,
"totalCapturedAmount": 0,
"totalDisbursedAmount": 0,
"totalRefundedAmount": 0,
"walletProvider": "SAMSUNG_PAY"
},
"response": {
"acquirerCode": "00",
"acquirerMessage": "Approved",
"gatewayCode": "APPROVED",
"gatewayRecommendation": "NO_ACTION"
},
"result": "SUCCESS",
"sourceOfFunds": {
"provided": {
"card": {
"brand": "MASTERCARD",
"devicePayment": {
"cryptogramFormat": "3DSECURE"
},
"deviceSpecificExpiry": {
"month": "1",
"year": "39"
},
"deviceSpecificNumber": "512345xxxxxx0008",
"fundingMethod": "UNKNOWN",
"number": "xxxxxxxxxxxxxxxx",
"scheme": "MASTERCARD",
"storedOnFile": "NOT_STORED"
}
},
"type": "CARD"
},
"timeOfLastUpdate": "2023-03-14T10:57:33.554Z",
"timeOfRecord": "2023-03-14T10:57:33.263Z",
"transaction": {
"acquirer": {
"batch": 20230314,
"date": "0314",
"id": "SYSTEST_ACQ_S2I",
"merchantId": "12345678",
"transactionId": "609405631"
},
"amount": 1500,
"authenticationStatus": "AUTHENTICATION_NOT_IN_EFFECT",
"authorizationCode": "112233",
"currency": "JPY",
"id": "746444836",
"receipt": "307310047497",
"source": "INTERNET",
"stan": "47497",
"terminal": "1111",
"type": "AUTHORIZATION"
},
"version": "71"
}
Δοκιμή ενοποίησης με το Samsung Pay
Μπορείτε να δοκιμάσετε την ενοποίηση με την πύλη στο περιβάλλον παραγωγής χρησιμοποιώντας το δοκιμαστικό προφίλ εμπόρου και ένα υποστηριζόμενο DPAN ή ένα FPAN.
Αν κάνετε δοκιμή για μια πληρωμή μέσω συσκευής ή κάρτας, χρησιμοποιήστε ένα υποστηριζόμενο DPAN ή FPAN από τον ακόλουθο πίνακα.
Πρόγραμμα |
DPAN ή FPAN |
Ημερομηνία λήξης |
|---|---|---|
| Mastercard | 5123456789012346 | 01/2039 |
| American Express | 340353278080900 | 01/2039 |
| Visa | 4440000009900010 | 01/2039 |