Sample project that shows how to integrate Google Pay with Datatrans
Google Pay allows merchants to collect payments with the Payment Request API. It enables merchants to receive encrypted payment information which can be forwarded to their Payment Processor. This Guide is intended for merchants who would like to integrate Google Pay with Datatrans. For more Information on Google Pay visit: https://pay.google.com/about/
(Optional) Please also read the Google Pay Guide for Developers to understand flows and technology:
- Java installed on your local dev system
- Maven installed on your local dev system
- Google Chrome, Mozilla Firefox, Apple Safari, or UCWeb UC Browser
- A google account that has a payment method installed (https://support.google.com/payments/answer/6220309)
- A datatrans-merchant-id
- A GooglePay merchant-id for productive transactions (https://developers.google.com/pay/api/web/guides/test-and-deploy/integration-checklist)
- Some basic experience with Spring Boot
- Some understanding of Google Pay and Payment Request API
This sample application demonstrates following parts of collecting a payment with Google Pay.
- Determine if the browser can use Google Pay and if there are payment methods available.
- If so create a payment request object
- Populate the payment request
- Request payment from the user
- Forward the encrypted payment data to the "back-end"
- Create an XML request to authorize the transaction with Datatrans
- Forward the Google Pay data with the XML request to the Datatrans XML API
- Display the results.
- Clone the repository
$ git clone [email protected]:datatrans/google-pay-web-sample.git
$ cd google-pay-web-sample- Open it with your favorite IDE / text editor
- Install the project
mvn clean install
This sample app uses Spring Boot and Embedded Tomcat. The server is listening on port 8080.
To run the app execute the main class GooglepayApplication.java.
Open http://localhost:8080/ in Google Chrome.
Google Pay can be tested using any supported web browser: Google Chrome, Mozilla Firefox, Apple Safari, Opera, or UCWeb UC Browser on a PC or mobile device. However if you need to make this web app available for your mobile device, a tool to expose your local webserver through a public URL is for example Ngrok. Ngrok.
- Open the URL you defined in your browser.
- Fill the inputs and tap/click Build Google Pay Request
- Click the Google Pay button that has been enabled
- Select your payment method (omitted in Screenshots due to security policies)
- Result is displayed
On your Android device / Google account it's easiest if you just configure a real credit card. Authorizations whith real cards will be declined on the Datatrans test system (https://admin.sandbox.datatrans.com/). So don't worry, your card will not be charged. In order to get some successful transactions Datatrans has the following logic in place (only on the test system obviously):
If a valid Google Pay token is sent we do the following replacements:
cardno=4242 4242 4242 4242 expm=12 expy=21
Check out src/main/java/ch/datatrans/examples/googlepay/client/DatatransClient.java to see how the authorization is done.
Sample request:
<?xml version="1.0" encoding="UTF-8" ?>
<authorizationService version="1">
<body merchantId="$merchantId">
<transaction refno="$refno">
<request>
<googlePayData><![CDATA[$token]]></googlePayData>
<reqtype>NOA</reqtype>
<transtype>05</transtype>
<sign>$sign</sign>
</request>
</transaction>
</body>
</authorizationService>Sample response:
<?xml version="1.0" encoding="UTF-8" ?>
<authorizationService version="1">
<body merchantId="$merchantId" status="accepted">
<transaction refno="$refno" trxStatus="response">
<request>
<googlePayData><![CDATA[$token]]></googlePayData>
<reqtype>NOA</reqtype>
<transtype>05</transtype>
<sign>$sign</sign>
</request>
<response>
<responseCode>01</responseCode>
<responseMessage>Authorized</responseMessage>
<uppTransactionId>160823101329060450</uppTrasactionId>
<authorizationCode>538050451</authorizationCode>
<acqAuthorizationCode>101538</acqAuthorizationCode>
<aliasCC>70119122433810042</aliasCC>
<expy>18</expy>
<expm>12</expm>
</response>
</transaction>
</body>
</authorizationService>A successful call will return <body>’s attribute status="accepted" and <transaction>’s trxStatus="response" as
well as a new <response> element containing the responseCode. A responseCode equal to "01" or "02" indicates
an authorized transaction. Elements aliasCC, expy and expm will be returned only if the merchant uses credit card aliases.
- This is sample code! Never ever use this code in production!
- If you have questions please raise an issues and add the label "question".