- Κατευθυντήριες οδηγίες ενοποίησης
- Υποστηριζόμενες δυνατότητες (πράξεις πληρωμής)
- Υποστήριξη διευκολυντή (aggregator)
Υποστήριξη διευκολυντή (aggregator)
Το Mastercard Gateway σάς προσφέρει υποστήριξη για να ενεργήσετε ως διευκολυντής (aggregator). Αυτό σας δίνει τη δυνατότητα να προσφέρετε ηλεκτρονικές υπηρεσίες για την αποδοχή ηλεκτρονικών πληρωμών σε άλλους εμπόρους (που ονομάζονται δευτερεύοντες έμποροι), όπου ο δευτερεύων έμπορος δεν χρειάζεται να έχει συμβατική σχέση ούτε με την τράπεζα εμπόρου ούτε με την πύλη. Είναι μια ελκυστική επιλογή για εμπόρους με μικρό αριθμό συναλλαγών, ώστε να δέχονται ηλεκτρονικές πληρωμές από τους πληρωτές τους και προετοιμάζονται πολύ γρήγορα.
Ο δευτερεύων έμπορος χρειάζεται μόνο μια σύμβαση μαζί σας, τον διευκολυντή (aggregator). Διαχειρίζεστε τη συμβατική σχέση με την τράπεζα εμπόρου, λαμβάνετε χρήματα από τον δευτερεύοντα έμπορο και τα τακτοποιείτε προς τον δευτερεύοντα έμπορο.
- Η λειτουργικότητα διευκολυντή (aggregator) υποστηρίζεται από το API έκδοση 32 και νεότερη.
- Τα προγράμματα κάρτας έχουν ορισμένες απαιτήσεις με τις οποίες πρέπει να συμμορφώνεστε, εφόσον θέλετε να λειτουργήσετε ως διευκολυντής (aggregator). Για περισσότερες λεπτομέρειες, επικοινωνήστε με την τράπεζα εμπόρου ή/και τα προγράμματα κάρτας.
- Η American Express απαιτεί το email και τον αριθμό τηλεφώνου του διευκολυντή (aggregator) πληρωμών εκτός από τα στοιχεία άλλων δευτερευόντων εμπόρων.
Προαπαιτούμενα
Πρέπει να επικοινωνήσετε με την τράπεζα εμπόρου σας, η οποία θα σας εντάξει στα προγράμματα κάρτας προκειμένου να σας προετοιμάσει ως διευκολυντή (aggregator). Η τράπεζα εμπόρου μπορεί σας δώσει ένα αναγνωριστικό ή/και όνομα διευκολυντή (aggregator). Δώστε αυτές τις λεπτομέρειες στο your payment service provider.
Ο Your payment service provider πρέπει να προετοιμάσει αναλόγως το προφίλ σας εμπόρου (σύνδεσμος σε τράπεζα εμπόρου) στην πύλη.
Υποβολή API συναλλαγών για δευτερεύοντες εμπόρους
Κατά την υποβολή μιας συναλλαγής για έναν δευτερεύοντα έμπορο μέσω των ακόλουθων πράξεων API, μπορείτε να δώσετε τις λεπτομέρειες του δευτερεύοντος εμπόρου που αναφέρονται παρακάτω στην ομάδα παραμέτρων order.subMerchant.
Αιτήματα API:
PAYAUTHORIZE- Standalone
CAPTURE - Standalone
REFUND VERIFYUPDATE_SESSION
Λεπτομέρειες δευτερεύοντος εμπόρου:
order.subMerchant.identifier(υποχρεωτικό αν δίνεται τοorder.subMerchant.tradingName)order.subMerchant.registeredNameorder.subMerchant.tradingName(υποχρεωτικό αν δίνεται τοorder.subMerchant.identifier)order.subMerchant.bankIndustryCode- Πεδία
order.subMerchant.address.* order.subMerchant.phoneorder.subMerchant.email
Αν δίνεται, θα επιστραφούν τα ακόλουθα στις παρακάτω αποκρίσεις:
RETRIEVE_TRANSACTIONRETRIEVE_ORDERRETRIEVE_SESSION
Αν η πύλη δεν παρέχει υποστήριξη για τους διευκολυντές (aggregator) για την τράπεζα εμπόρου που χρησιμοποιείτε, το αίτημα με λεπτομέρειες δευτερεύοντος εμπόρου θα απορριφθεί.
Οι λεπτομέρειες δευτερεύοντος εμπόρου ισχύουν για όλες τις συναλλαγές σε μια παραγγελία. Δίνονται μόνο για τις αρχικές συναλλαγές, δηλαδή για τις συναλλαγές που δημιουργούν μια παραγγελία. Αν δίνονται για επακόλουθες συναλλαγές (δηλαδή, συναλλαγές για μια υπάρχουσα παραγγελία, όπως ένα επακόλουθο αίτημα CAPTURE ή REFUND), η πύλη απορρίπτει το αίτημα.
Tokenization
Για εκδόσεις API προγενέστερες της 70, αν ενεργείτε ως διευκολυντής (aggregator), δεν μπορείτε να χρησιμοποιήσετε τη λειτουργικότητα Tokenization. Η πύλη απορρίπτει αιτήματα συναλλαγών με λεπτομέρειες δευτερεύοντος εμπόρου για εκείνους τους εμπόρους που έχουν τη δυνατότητα για Tokenization.
Από την έκδοση 70 του API και μετά, αν ενεργείτε ως διευκολυντής (aggregator), μπορείτε να χρησιμοποιήσετε τη λειτουργικότητα Tokenization. Η υποστήριξη για τη λειτουργικότητα Tokenization προστίθεται στις ακόλουθες πράξεις:
Αίτημα:
TOKENIZECreate or Update TokenCreate or Update Token (system generated token)
DELETE_TOKENSEARCH_TOKEN, andRETRIEVE_TOKEN.
Απόκριση:
TOKENIZECreate or Update TokenCreate or Update Token (system generated token)
TOKENIZE_BROWSER_PAYMENT, andRETRIEVE_TOKEN.
Ως διευκολυντής (aggregator) που χρησιμοποιεί τη λειτουργικότητα Tokenization, πρέπει να παρέχετε τις ακόλουθες λεπτομέρειες δευτερεύοντος εμπόρου στην ομάδα παραμέτρων subMerchant.
subMerchantsubMerchant.identifier
Ως έμπορος με ρόλο διευκολυντή (aggregator) αναμένεται
- να παρέχετε το αναγνωριστικό δευτερεύοντος εμπόρου σε όλες τις πράξεις tokenization
- να παρέχετε λεπτομέρειες δευτερεύοντος εμπόρου στα αιτήματα συναλλαγών
- να ενεργοποιηθείτε για τη δυνατότητα διευκολυντή (aggregator), και
- να χρησιμοποιήσετε έναν σύνδεσμο σε τράπεζα εμπόρου που υποστηρίζει συναλλαγές διευκολυντή (aggregator) [η δυνατότητα υποστήριξης διευκολυντή (aggregator) πρέπει να είναι ενεργοποιημένη στον σύνδεσμο της αγοράς].
Περιορισμοί
Οι ακόλουθες λειτουργίες δεν είναι προς το παρόν διαθέσιμες:
- Ένας διευκολυντής (aggregator) δεν μπορεί να διαμορφωθεί με αποθετήριο για το οποίο η Στρατηγική δημιουργίας token = Τράπεζα εμπόρου.
- Ένας διευκολυντής (aggregator) δεν μπορεί να διαμορφωθεί με εξωτερικό αποθετήριο token (tokenprovider = LTV ή TV2G).
- Ένας διευκολυντής (aggregator) δεν μπορεί να διαμορφωθεί με tokenization δικτύου για token πύλης.
Hosted Checkout
Αν θέλετε να παρέχετε στους δευτερεύοντες εμπόρους σας τη λειτουργικότητα Hosted Checkout, πρέπει να τους παρέχετε ένα περιβάλλον εργασίας στην ενοποίησή σας με Hosted Checkout.
Αν δώσετε τις λεπτομέρειες δευτερεύοντος εμπόρου, πρέπει να δώσετε ένα ID περιόδου λειτουργίας όταν γίνεται κλήση του Checkout.configure(). Υποβάλετε ένα αίτημα APICREATE_CHECKOUT_SESSION και συμπεριλάβετε τις λεπτομέρειες παραγγελίας του δευτερεύοντος εμπόρου για να δημιουργηθεί το ID της περιόδου λειτουργίας (session). Ο browser του πληρωτή θα επιστραφεί στην εφαρμογή σας και πρέπει να ανακατευθύνετε τον πληρωτή στην εφαρμογή του δευτερεύοντος εμπόρου.
Χρησιμοποιήστε το Checkout.configure() για να δώσετε τις λεπτομέρειες εμφάνισης του δευτερεύοντος εμπόρου, όπως το όνομα εμπόρου, τη διεύθυνση και τις λεπτομέρειες επικοινωνίας, καθώς επίσης λογότυπο. Αυτές οι λεπτομέρειες παρουσιάζονται στον πληρωτή κατά τη διάρκεια της αλληλεπίδρασης Hosted Checkout.
Ταυτοποίηση 3-D Secure EMV
Για να επιτρέψετε σε δευτερεύοντες εμπόρους να χρησιμοποιούν την ταυτοποίηση 3-D Secure (3DS2) EMV μέσω της πύλης, οι διευκολυντές (aggregator) πρέπει να υποβάλουν τις σχετικές λεπτομέρειες του δευτερεύοντος εμπόρου στο αίτημα Initiate Authentication. Όταν υποβάλλονται λεπτομέρειες δευτερεύοντος εμπόρου στην πύλη, η πύλη χρησιμοποιεί τις λεπτομέρειες του δευτερεύοντος εμπόρου στη θέση των λεπτομερειών διευκολυντή (aggregator) στο μεταγενέστερο μήνυμα ταυτοποίησης. Τα πεδία που πρέπει να δοθούν ποικίλλουν ανάλογα με το πρόγραμμα. Τα υποστηριζόμενα προγράμματα περιλαμβάνουν τα εξής:
- Mastercard SecureCode™
- Verified by Visa
- American Express SafeKey
- mada secure
Αν η ταυτοποίηση ακολουθείται από πληρωμή με χρήση μιας πράξης Authorize ή Pay που κάνει αναφορά στο ID ταυτοποίησης 3DS2, τότε οι λεπτομέρειες του δευτερεύοντος εμπόρου που παρέχονται στο αίτημα Initiate Authentication χρησιμοποιούνται επίσης στις πράξεις Authorize/Pay.
Βήμα 1: Έναρξη ταυτοποίησης
Δώστε τις ακόλουθες λεπτομέρειες στο αίτημα Initiate Authentication για τον δευτερεύοντα έμπορό σας επιπλέον άλλων απαιτούμενων πεδίων, όπως αναφέρονται στην ενότητα Έναρξη ταυτοποίησης στον Οδηγό ενοποίησης.
Για να δείτε τα βασικά πεδία απόκρισης για την απόκριση Initiate Authentication, βλ. "Έναρξη ταυτοποίησης" στον Οδηγό ενοποίησης.
Λεπτομέρειες δευτερεύοντος εμπόρου
order.subMerchant.identifier(υποχρεωτικό για όλα τα υποστηριζόμενα προγράμματα 3DS2)order.subMerchant.tradingName(υποχρεωτικό για όλα τα υποστηριζόμενα προγράμματα 3DS2)order.subMerchant.bankIndustryCode(υποχρεωτικό για όλα τα υποστηριζόμενα προγράμματα 3DS2)order.subMerchant.registeredNameorder.subMerchant.address.country(υποχρεωτικό για όλα τα υποστηριζόμενα προγράμματα 3DS2)order.subMerchant.address.*(άλλα πεδία διεύθυνσης)order.subMerchant.phoneorder.subMerchant.email
Λεπτομέρειες 3DS2
Δώστε τις ακόλουθες λεπτομέρειες διαμόρφωσης 3DS2 για τον δευτερεύοντα έμπορο. Ως προαπαιτούμενο, πρέπει να έχετε ενεργοποιηθεί για το αντίστοιχο πρόγραμμα ταυτοποίησης 3DS2 στο προφίλ εμπόρου σας για το οποίο ο δευτερεύων έμπορος μπορεί να πραγματοποιήσει ταυτοποιήσεις πληρωτή 3DS2.
order.subMerchant.websiteUrl: Η διεύθυνση URL του ιστότοπου του δευτερεύοντος εμπόρου. Αν δοθεί, θα χρησιμοποιηθεί η διεύθυνση URL του ιστότοπου από το προφίλ εμπόρου σας.order.subMerchant.authentication[n].protocolorder.subMerchant.authentication[n].3DS2.requestorIdorder.subMerchant.authentication[n].3DS2.requestorName
Για Mastercard SecureCode, JCB J/Secure και mada secure, μην παρέχετε λεπτομέρειες ταυτοποίησης. Το ID αιτούντα και το όνομα αιτούντα δημιουργούνται από την πύλη.
Για το Verified By Visa στις λεπτομέρειες ταυτοποίησης, δώστε μόνο το πρωτόκολλο ταυτοποίησης. Το ID αιτούντα και το όνομα αιτούντα δημιουργούνται από την πύλη.
Για το American Express Safekey, η πύλη θα χρησιμοποιήσει το ID αιτούντα "AGG", το οποίο σημαίνει Aggregator. Αν το ζητήσει η American Express, μπορείτε να το παρακάμψετε και να χρησιμοποιήσετε διαφορετικό. Η πύλη, όπως και άλλα προγράμματα, θα δημιουργήσει το όνομα αιτούντα.
| URL | https://na.gateway.mastercard.com/api/rest/version/<version>/merchant/<your_merchant_ID>/order/<your_order_ID>/transaction/<your_transaction_ID> |
| Μέθοδος HTTP | PUT |
{
"authentication": {
"acceptVersions":"3DS2",
"channel": "PAYER_BROWSER",
"purpose": "PAYMENT_TRANSACTION"
},
"correlationId": "test",
"order": {
"currency": "USD",
"subMerchant": {
"authentication":[
{
"protocol":"AMEX_SAFEKEY",
"3DS2":{
"requestorId":"testRequestorId",
"requestorName":"testRequestorName"
}
}
],
"identifier": "123456",
"tradingName": "SubmerchantName",
"address": {
"city": "sydney",
"company": "Acme",
"country": "AUS"
},
"bankIndustryCode": "1234",
"registeredName": "SubmerchantRegisteredName"
}
},
"sourceOfFunds": {
"provided": {
"card": {
"number": "373224999999174"
}
}
},
"apiOperation": "INITIATE_AUTHENTICATION"
}
{
"authentication":
{
"3ds2": {
"directoryServerId": "A999999999",
"methodCompleted": false,
"methodSupported": "SUPPORTED",
"protocolVersion": "2.1.0",
"requestorId": "testRequestorId",
"requestorName": "testRequestorName"
},
"acceptVersions": "3DS2",
"channel": "PAYER_BROWSER",
"purpose": "PAYMENT_TRANSACTION",
"redirect": {
"customized": {
"3DS": {
"methodPostData": "eyJ0aHJlZURTTWV0aG9kTm90aWZpY2F0aW9uVVJMIjoiaHR0cHM6Ly9xYTA2LmdhdGV3YXkubWFzdGVyY2FyZC5jb20vY2FsbGJhY2tJbnRlcmZhY2UvZ2F0ZXdheS8xYjZjMmNiYTc3NjMxZDBjNTAxOWM1YzUxMzZmM2ZjZWI4NDZiMGE4ZTFkZmM2Njg2YjA1YWNkZjQxMGZkMWEwIiwidGhyZWVEU1NlcnZlclRyYW5zSUQiOiJmYzBmNDg0OC03MzQzLTQzMDAtOTg2YS05NmQwYmE0MDM0ODUifQ==",
"methodUrl": "https://qa06.gateway.mastercard.com/acs/mastercard/v2/method"
}
}
},
"redirectHtml":"<div id=\"initiate3dsSimpleRedirect\" xmlns=\"http://www.w3.org/1999/html\"> <iframe id=\"methodFrame\" name=\"methodFrame\" height=\"100\" width=\"200\"> </iframe> <form id=\"initiate3dsSimpleRedirectForm\" method=\"POST\" action=\"https://qa06.gateway.mastercard.com/acs/mastercard/v2/method\" target=\"methodFrame\"> <input type=\"hidden\" name=\"threeDSMethodData\" value=\"eyJ0aHJlZURTTWV0aG9kTm90aWZpY2F0aW9uVVJMIjoiaHR0cHM6Ly9xYTA2LmdhdGV3YXkubWFzdGVyY2FyZC5jb20vY2FsbGJhY2tJbnRlcmZhY2UvZ2F0ZXdheS8xYjZjMmNiYTc3NjMxZDBjNTAxOWM1YzUxMzZmM2ZjZWI4NDZiMGE4ZTFkZmM2Njg2YjA1YWNkZjQxMGZkMWEwIiwidGhyZWVEU1NlcnZlclRyYW5zSUQiOiJmYzBmNDg0OC03MzQzLTQzMDAtOTg2YS05NmQwYmE0MDM0ODUifQ==\"/> </form> <script id=\"initiate-authentication-script\"> var e=document.getElementById(\"initiate3dsSimpleRedirectForm\"); if (e) { e.submit(); if (e.parentNode !== null) { e.parentNode.removeChild(e); } } </script> </div>",
"version": "3DS2"
},
"correlationId": "test",
"merchant": "TESTMITSUKO_GWS",
"order": {
"authenticationStatus": "AUTHENTICATION_AVAILABLE",
"creationTime": "2022-03-03T02:21:20.043Z",
"currency": "USD",
"id": "TEST1234",
"lastUpdatedTime": "2022-03-03T02:21:19.966Z",
"merchantCategoryCode": "1234",
"status": "AUTHENTICATION_INITIATED",
"subMerchant": {
"address": {
"city": "sydney",
"company": "Acme",
"country": "AUS"
},
"authentication": [
{
"3DS2": {
"requestorId": "testRequestorId",
"requestorName": "testRequestorName"
},
"protocol": "AMEX_SAFEKEY"
}
],
"bankIndustryCode": "1234",
"identifier": "123456",
"registeredName": "SubmerchantRegisteredName",
"tradingName": "SubmerchantName"
},
"totalAuthorizedAmount": 0,
"totalCapturedAmount": 0,
"totalRefundedAmount": 0
},
"response": {
"gatewayCode": "AUTHENTICATION_IN_PROGRESS",
"gatewayRecommendation": "PROCEED"
},
"result": "SUCCESS",
"sourceOfFunds": {
"provided": {
"card": {
"brand": "AMEX",
"fundingMethod": "CREDIT",
"issuer": "AMERICAN EXPRESS US CONSUMER",
"number": "373224xxxxx9174",
"scheme": "AMEX"
}
},
"type": "CARD"
},
"timeOfLastUpdate": "2022-03-03T02:21:19.966Z",
"timeOfRecord": "2022-03-03T02:21:20.043Z",
"transaction": {
"amount": 0,
"authenticationStatus": "AUTHENTICATION_AVAILABLE",
"currency": "USD",
"id": "123",
"type": "AUTHENTICATION"
},
"version": "64"
}
Βήμα 2: Ταυτοποίηση πληρωτή
Ανατρέξτε στην ενότητα Ταυτοποίηση πληρωτή για όλες τις οδηγίες που σχετίζονται με τη ροή δευτερεύοντος εμπόρου.
| URL | https://na.gateway.mastercard.com/api/rest/version/<version>/merchant/<your_merchant_ID>/order/<your_order_ID>/transaction/<your_transaction_ID> |
| Μέθοδος HTTP | PUT |
{
"correlationId": "foo",
"order": {
"amount": "100",
"currency": "USD"
},
"sourceOfFunds": {
"provided": {
"card": {
"number": "373224999999174",
"expiry": {
"month" : "01",
"year" : "39"
}
}
}
},
"device": {
"browser": "MOZILLA",
"browserDetails": {
"3DSecureChallengeWindowSize": "FULL_SCREEN",
"acceptHeaders": "application/json",
"colorDepth": 24,
"javaEnabled": true,
"language": "en-US",
"screenHeight": 640,
"screenWidth": 480,
"timeZone": 273
},
"ipAddress": "127.0.0.1"
},
"apiOperation": "AUTHENTICATE_PAYER"
}
{
"authentication": {
"3ds": {
"acsEci": "05",
"authenticationToken": "mHyn+7YFi1EUAREAAAAvNUe6Hv8=",
"transactionId": "AgEAAJZvNBiNg0EWkd6ryLVH8ik="
},
"3ds2": {
"3dsServerTransactionId": "fc0f4848-7343-4300-986a-96d0ba403485",
"acsTransactionId": "ebd1628f-b62a-44f6-bb2d-480359ac3e70",
"directoryServerId": "A999999999",
"dsTransactionId": "966f3418-8d83-4116-91de-abc8b547f229",
"methodCompleted": false,
"methodSupported": "SUPPORTED",
"protocolVersion": "2.1.0",
"requestorId": "testRequestorId",
"requestorName": "testRequestorName",
"transactionStatus": "Y"
},
"payerInteraction": "NOT_REQUIRED",
"redirect": {
"customized": {
"3DS": {
"acsUrl": "https://qa06.gateway.mastercard.com/callbackInterface/gateway/3a672661a6b7027834df3e5863e78f02152c7b99b18b0f9ea8bbd30f86323dc2",
"cReq": "e30="
}
},
"domainName": "qa06.gateway.mastercard.com"
},
"redirectHtml":"<div id=\"threedsFrictionLessRedirect\" xmlns=\"http://www.w3.org/1999/html\"> <iframe id=\"challengeFrame\" name=\"challengeFrame\" </iframe> <form id=\"threedsFrictionLessRedirectForm\" method=\"POST\" action=\"https://qa06.gateway.mastercard.com/acs/mastercard/v2/method\" target=\"challengeFrame\"> <input type=\"hidden\" name=\"order.id\" value=\"TEST1234\"/> <input type=\"hidden\" name=\"transaction.id\" value=\"123\"/> input type=\"hidden\" name=\"response.gatewayRecommendation\" value=\"PROCEED\"/> <input type=\"hidden\" name=\"result\" value=\"SUCCESS\"/> </form> <script id=\"authenticate-payer-script\"> </script> var e=document.getElementById(\"threedsFrictionLessRedirectForm\"); if (e) { e.submit(); if (e.parentNode !== null) { e.parentNode.removeChild(e); } } </script> </div>",
"version": "3DS2"
},
"correlationId": "foo",
"device": {
"browser": "MOZILLA",
"ipAddress": "127.0.0.1"
},
"merchant": "TESTMITSUKO_GWS",
"order": {
"amount": 100.00,
"authenticationStatus": "AUTHENTICATION_SUCCESSFUL",
"creationTime": "2022-03-03T02:21:20.043Z",
"currency": "USD",
"id": "TEST1234",
"lastUpdatedTime": "2022-03-03T02:25:30.340Z",
"merchantCategoryCode": "1234",
"status": "AUTHENTICATED",
"subMerchant": {
"address": {
"city": "sydney",
"company": "Acme",
"country": "AUS"
},
"authentication": [
{
"3DS2": {
"requestorId": "testRequestorId",
"requestorName": "testRequestorName"
},
"protocol": "AMEX_SAFEKEY"
}
],
"bankIndustryCode": "1234",
"identifier": "123456",
"registeredName": "SubmerchantRegisteredName",
"tradingName": "SubmerchantName"
},
"totalAuthorizedAmount": 0,
"totalCapturedAmount": 0,
"totalRefundedAmount": 0,
"valueTransfer": {
"accountType": "NOT_A_TRANSFER"
}
},
"response": {
"gatewayCode": "APPROVED",
"gatewayRecommendation": "PROCEED"
},
"result": "SUCCESS",
"sourceOfFunds": {
"provided": {
"card": {
"brand": "AMEX",
"expiry": {
"month": "1",
"year": "39"
},
"fundingMethod": "CREDIT",
"issuer": "AMERICAN EXPRESS US CONSUMER",
"number": "373224xxxxx9174",
"scheme": "AMEX"
}
},
"type": "CARD"
},
"timeOfLastUpdate": "2022-03-03T02:25:30.340Z",
"timeOfRecord": "2022-03-03T02:21:20.043Z",
"transaction": {
"acquirer": {
"merchantId": "1234567890"
},
"amount": 100.00,
"authenticationStatus": "AUTHENTICATION_SUCCESSFUL",
"currency": "USD",
"id": "123",
"type": "AUTHENTICATION"
},
"version": "64"
}
Βήμα 3: Χρήση του αποτελέσματος ταυτοποίησης στην πράξη πληρωμής
Ανατρέξτε στην ενότητα Χρήση του αποτελέσματος ταυτοποίησης στην πράξη πληρωμής για όλες τις οδηγίες που σχετίζονται με τη ροή δευτερεύοντος εμπόρου.
| URL | https://na.gateway.mastercard.com/api/rest/version/<version>/merchant/<your_merchant_ID>/order/<your_order_ID>/transaction/<your_transaction_ID> |
| Μέθοδος HTTP | PUT |
{
"apiOperation": "AUTHORIZE",
"authentication": {
"transactionId": "123"
},
"order": {
"amount": "100",
"currency": "USD",
"reference": "300"
},
"sourceOfFunds": {
"provided": {
"card": {
"number": "373224999999174",
"expiry": {
"month": "01",
"year": "39"
}
}
},
"type": "CARD"
},
"transaction": {
"source": "INTERNET",
"reference": "3600"
}
}
{
"authentication": {
"3ds": {
"acsEci": "05",
"authenticationToken": "mHyn+7YFi1EUAREAAAAvNUe6Hv8=",
"transactionId": "AgEAAJZvNBiNg0EWkd6ryLVH8ik="
},
"3ds2": {
"dsTransactionId": "966f3418-8d83-4116-91de-abc8b547f229",
"protocolVersion": "2.1.0",
"transactionStatus": "Y"
},
"transactionId": "123",
"version": "3DS2"
},
"authorizationResponse": {
"posData": "1605S0100130",
"transactionIdentifier": "AmexTidTest"
},
"device": {
"browser": "MOZILLA",
"ipAddress": "127.0.0.1"
},
"gatewayEntryPoint": "WEB_SERVICES_API",
"merchant": "TESTMITSUKO_GWS",
"order": {
"amount": 100.00,
"authenticationStatus": "AUTHENTICATION_SUCCESSFUL",
"chargeback": {
"amount": 0,
"currency": "USD"
},
"creationTime": "2022-03-03T02:21:19.948Z",
"currency": "USD",
"id": "TEST1234",
"lastUpdatedTime": "2022-03-03T02:45:56.851Z",
"merchantAmount": 100.00,
"merchantCategoryCode": "1234",
"merchantCurrency": "USD",
"reference": "300",
"status": "AUTHORIZED",
"subMerchant": {
"address": {
"city": "sydney",
"company": "Acme",
"country": "AUS"
},
"bankIndustryCode": "1234",
"identifier": "123456",
"registeredName": "SubmerchantRegisteredName",
"tradingName": "SubmerchantName"
},
"totalAuthorizedAmount": 100.00,
"totalCapturedAmount": 0.00,
"totalDisbursedAmount": 0.00,
"totalRefundedAmount": 0.00
},
"response": {
"acquirerCode": "000",
"acquirerMessage": "Approved ",
"gatewayCode": "APPROVED",
"gatewayRecommendation": "NO_ACTION"
},
"result": "SUCCESS",
"sourceOfFunds": {
"provided": {
"card": {
"brand": "AMEX",
"expiry": {
"month": "1",
"year": "39"
},
"fundingMethod": "CREDIT",
"issuer": "AMERICAN EXPRESS US CONSUMER",
"number": "373224xxxxx9174",
"scheme": "AMEX",
"storedOnFile": "NOT_STORED"
}
},
"type": "CARD"
},
"timeOfLastUpdate": "2022-03-03T02:45:56.851Z",
"timeOfRecord": "2022-03-03T02:45:56.762Z",
"transaction": {
"acquirer": {
"batch": 1,
"id": "AMEXGWS",
"merchantId": "1234567890"
},
"amount": 100.00,
"authenticationStatus": "AUTHENTICATION_SUCCESSFUL",
"authorizationCode": "007257",
"currency": "USD",
"id": "1234",
"receipt": "2203031",
"reference": "3600",
"source": "INTERNET",
"stan": "1",
"terminal": "123456",
"type": "AUTHORIZATION"
},
"version": "64"
}