Eway Google Pay API sample app for Android

Eway Rapid API Documentation

Overview

This sample demonstrates basic usage of the Google Pay API for Android with Eway's Rapid API.

The Google Pay API can be used to request any credit or debit card stored in your customer's Google account, including Android device tokens managed in the Google Pay app on Android.

For more information, visit the following link:

https://developers.google.com/pay/api/android/overview

Instructions

Make sure you read the comments in Constants.java and PaymentsUtil.java before you continue. These files must be modified prior to running the app, as per the instructions provided in the comments.

Requirements

In order to build and run this sample app, make sure you:

• Have Android Studio 3.0 or greater installed.
• Have a device running Android 4.4 (KitKat) or greater.
• Have Google Play services version 16.0.0 or greater installed on this device.

To be able to fully test the API, you will also need to:

• Add a payment method to your Google Account.
• Install and add a payment method to the Google Pay app (optional).
• Consult your payment processor's documentation to learn about whether they support the Google Pay API.

Support

For any questions or issues, please refer to our How to get help page.

Google Pay

Onboarding

1. To enable Google Pay on the account, login to MyEway http://au.myeway.com.
2. Go to Google Pay Settings page in Settings > Google Pay Settings.
3. Read and agree to the terms and conditions by checking the "I agree to the terms and conditions" box.
4. Enter the Google Pay Merchant ID. This is the ID you were provided once successfully onboarded on Google Pay.
5. Click the Activate Button

Integration Guide

1. Prerequisites

The merchant has been onboarded with Google Pay via MyEway, see onboarding guide for the details.

App Credentials

Setup for Credentials and Endpoint for the app are located in the Constants.java file. You will need to set up the API key, Password and Eway's Endpoint.

    public static final String EWAY_API_KEY = "";
    public static final String EWAY_PASSWORD = "";
    public static final String EWAY_ENDPOINT = ""; 

• Please note that this app is using Direct Connection only to process payments with Eway.

2. Integration Steps (Responsive Shared Page)

Google Pay is integrated into the Eway Responsive Shared Page. Once Google Pay is enabled and onboarded in MyEway, no further steps are required.

3. Integration Steps (Transparent Redirect)

When using Transparent Redirect, the first step of generating an Access Code is the same as Transparent Redirect.

To request an Access Code, make a server-side call to the CreateAccessCode method of Rapid API. The service will respond with an Access Code, a Form Action URL and the customer data.

The difference is that instead of sending the Card Details to the Form Action URL, you send the Google Pay Network token. You must include these 3 fields in your form-data request:

• EWAY_ACCESSCODE
• EWAY_PAYMENTTYPE
• EWAY_GOOGLEPAY_NETWORKTOKEN

Where EWAY_PAYMENTTYPE is set to GooglePay.

You can find an example to Google Pay Network Token here.

Exmaple:

<form method="POST" action="<<FormActionURL Goes Here>>" id="payment_form">
  <input type="hidden" name="EWAY_ACCESSCODE" value="<<AccessCode Goes Here>>" />
  <input type="hidden" name="EWAY_PAYMENTTYPE" value="GooglePay" />
   <input type="hidden" name="EWAY_GOOGLEPAY_NETWORKTOKEN" value="{{TOKEN}}" />
  <input type="submit" value="Process" text="Process" />
</form> 

Once the transaction has been processed, request the results from Eway using the Access Code.

4. Integration Steps (Direct API)

Live endpoints

Type	Gateway URL
REST (POST)	https://api.ewaypayments.com/Transactions/

Sandbox endpoints

Type	Gateway URL
REST (POST)	https://api.sandbox.ewaypayments.com/Transactions/

Rapid Plus API Direct Connection can accept Google Pay Token to process Purchase / PreAuth payments.

1. Call the Rapid plus endpoint /Transactions with a request that contains the payment instrument and the payment type: Google Pay.
2. Send the Google pay token in the WalletDetails object > Token.

Request Field Descriptions

Example Google Pay Request

{
    "paymentInstrument": {
        "paymentType": "GooglePay",
        "walletDetails": {
            "Token": "{  \"protocolVersion\": \"ECv2\",  \"signature\": \"MEQCIH6Q4OwQ0jAceFEkGF0JID6sJNXxOEi4r+mA7biRxqBQAiAondqoUpU\/bdsrAOpZIsrHQS9nwiiNwOrr24RyPeHA0Q\\u003d\\u003d\",  
            \"intermediateSigningKey\": {    \"signedKey\": \"{\\\"keyExpiration\\\":\\\"1542323393147\\\",\\\"keyValue\\\":\\\"MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAE\/1+3HBVSbdv+j7NaArdgMyoSAM43yRydzqdg1TxodSzA96Dj4Mc1EiKroxxunavVIvdxGnJeFViTzFvzFRxyCw\\\\u003d\\\\u003d\\\"}\",    \"signatures\": [ \"MEYCIQCO2EIi48s8VTH+ilMEpoXLFfkxAwHjfPSCVED\/QDSHmQIhALLJmrUlNAY8hDQRV\/y1iKZGsWpeNmIP+z+tCQHQxP0v\" ]  },  \"signedMessage\": \"{\\\"tag\\\":\\\"jpGz1F1Bcoi\/fCNxI9n7Qrsw7i7KHrGtTf3NrRclt+U\\\\u003d\\\",\\\"ephemeralPublicKey\\\":\\\"BJatyFvFPPD21l8\/uLP46Ta1hsKHndf8Z+tAgk+DEPQgYTkhHy19cF3h\/bXs0tWTmZtnNm+vlVrKbRU9K8+7cZs\\\\u003d\\\",\\\"encryptedMessage\\\":\\\"mKOoXwi8OavZ\\\"}\"}"
        }
    },
    "Payment": {
        "TotalAmount": 100,
        "currencyCode": "AUD"
    },
    "Method": "ProcessPayment",
    "TransactionType": "Ecom"
}

1. The Method can be ProcessPayment for normal payment or PreAuthorisation for PreAuth payment.
2. The response will include the tranasction result.

Specific Error Codes for Google Pay

Response Message	Reason
V6125	Selected Payment Type Not Enabled
S5017	Google Pay processing error
V7100	GooglePay Not Supported By Gateway
V7101	TokenCustomer and GooglePay should not coexist at the same time
V7102	Invalid GooglePay request, IntermediateSigningKey has no value
V7103	Invalid GooglePay request, Signature has no value
V7104	Invalid GooglePay request, Version number is not supported
V7105	Invalid GooglePay request, SignedMessage is null
V7106	Invalid GooglePay request, IntermediateSigningKey.SignedKey has no value
V7107	Invalid GooglePay request, IntermediateSigningKey.Signatures has no value
V7109	Invalid GooglePay request, GooglePay isn't available in your country
V7110	Invalid GooglePay GatewayMerchantId, GatewayMerchantId in GPay doesn't match with what was on-boarded in MyEway