Google Pay Integration Guide

1. Introduction

Google Pay™ is the fast, simple way that allows you to make card payments without entering card details for each payment. The card data is safely stored by Google. This payment method is available for all devices (mobile phones and computers), regardless of the operating system and web browser.

2. Connection via Portmone.com page

Preconditions

  1. You should sign an agreement with Portmone.com.

  2. You need to agree with Google Pay Terms of Service.

Description

With this connection method, you do not need to perform additional integrations. The Google Pay button will be displayed on Portmone.com payment page. You can manage payment methods and the order in which the payment instruments (including Google Pay) are displayed using JSON-request (see section 3.2 of documentation) or contacting the cooperation manager.

3. Connection with Google Pay API

Preconditions

  1. You should register with Google Pay API.

  2. Your website should use HTTPS and support TLS protocol.

  3. To integrate your website or mobile application with the Google Pay, proceed according to the following instructions:

    • API documentation:

    a) for mobile application

    b) for website

    • Brand guidelines

    a) for mobile application

    b) for website

How it works?

Google Pay Flow

  1. You request the encrypted payment data from your application.
  2. Google Pay returns the encrypted data after buyer authentication.
  3. You send the encrypted payment data to your server.
  4. You send an JSON-request to Portmone.com containing the encrypted data.
  5. We send you the payment response
  6. You inform the buyer of the outcome

How to integrate the Google Pay method?

Step 1. Use Google Pay API to get PaymentData

Settings parameters:

a. allowPaymentMethods : CARD

b. tokenizationSpecification = { "type": "PAYMENT_GATEWAY"}

allowedCardNetworks = ['MASTERCARD', 'VISA'];

allowedCardAuthMethods = ['PAN_ONLY', 'CRYPTOGRAM_3DS'];

c. gateway = portmonecom

d. gatewayMerchantId - A unique identifier of the online shop. Assigned to each partner individually when connected to the Portmone.com system.

Am example of dataset returned by Google Pay

{
  "cardInfo": {
    "cardNetwork": "Visa",
    "cardDetails": "5594",
    "cardImageUri": "https://lh6.ggpht.com/h6TBIVV7tlYGr1zkIA8CmCzINizzASbPIetpxh_5otBu3VkPEC5_Kk_wH5szy7gDhMkRhVVp",
    "cardDescription": "Visa •••• 5594",
    "cardClass": "CREDIT"
  },
  "paymentMethodToken": {
    "tokenizationType": "PAYMENT_GATEWAY",
    "token": "{\"signature\": \"MEUCIZ29vZ2xlIHBheSBkZWNvZGVkIHNpZ25hdHVyZSBkYXRhIChiaW5hcnkpCg\\u003d\", \"protocolVersion\":\"ECv1\", \"signedMessage\":\"{\\\"encryptedMessage\\\": \\\"TG9yZW0gaXBzdW0gZG9sb3Igc2l0IGFtZXQsIGNvbnNlY3RldHVyIGFkaXBpc2NpbmcgZWxpdCwg//c2VkIGRvIGVpdXNtb2QgdGVtcG9yIGluY2lkaWR1bnQgdXQgbGFib3JlIGV0IGRvbG9yZSBtYWdu//YSBhbGlxdWEuIFV0IGVuaW0gYWQgbWluaW0gdmVuaWFtLCBxdWlzIG5vc3RydWQgZXhlcmNpdGF0//aW9uIHVsbGFtY28gbGFib3JpcyBuaXNpIHV0IGFsaXF1aXAgZXggZWEgY29tbW9kbyBjb25zZXF1YXQuCg\\\", \\\"ephemeralPublicKey\\\":\\\"Z29vZ2xlIHBheSBlbXBoZXJhbCBwdWJsaWMga2V5IChkZWNvZGVkIGJpbmFyeSkK\\\\u003d\\\",\\\"tag\\\":\\\"Z29vZ2xlIHBheSB0YWcgKGRlY29kZWQgYmluYXJ5KQo\\\\u003d\\\"}\"}"
  }
}

The data obtained from processPayment should be send to the API Portmone.com.

Method: GPay

URL: https://www.portmone.com.ua/r3/api/gateway

Parameters description:

ParameterDescriptionRequired
loginThe Online Store login to access account managementYes
passwordThe Online Store passwordYes
gPayTokenToken received from the Google Pay systemYes
payeeIdA unique identifier of the Online Store. Assigned to each Partner individually when connected to the Portmone.com systemYes
billAmountAmount of the paymentYes
descriptionPayment description (comment to the order / payment details)No
shopOrderNumberNumber of paid order (bill) in the Online Store systemNo
emailRecipientE-mail address of the clientNo
preauthFlagPayment pre-authorization flag (value "Y" indicates that this payment is carried out using the pre-authorization procedure, value "N" is a regular payment without pre-authorization)No
billCurrencyCurrency of the payment. Possible values: UAH (default value), USD, EUR, GBP, BYN, KZT, RUBNo

An example of dataset sent by GPay method to the Portmone.com

{
    "method":"GPay",
    "params": {
        "data":{
            "login":"wdishop",
            "password":"wdi451",
            "gPayToken":"{
"signature":"BEQCIEHXkYIXHJGMLzV/mWarddasNdIasdSdaoaDd5sadneEnfrwboAim0qAiAlQkgA5jwdswqeqefsaEHkfvDsHfENBx13dGhR/tUXrw\u003d\u003d","intermediateSigningKey":{"signedKey":"{\"keyValue\":\"fdsrfewrSYIKoZIzj0DAQcDQgAEFqnQNTcgsA2s9RXdasqwreOIRUZYXV0K6AWx9LtYD+yc+PrLIiZSDoQr+LbVVf//AWtscPRCUpDApQCifIj0eRyg\\u003d\\u003d\",\"keyExpiration\":\"1547332502665\"}","signatures":["MEQUXsLj97pXthJYM6bAq9rezLOeE0xmVm8SAiAWmRqFlf44O5PNdnTz+ZuK9AwQLmenUdprZxeqPiAotg\u003d\u003d"]},"protocolVersion":"ECv2","signedMessage":"{\"encryptedMessage\":\"n1dxiU7Ci6LPfY00LvKiuqHfOYnsUJKO46gPRFHCPVosmgeoQ/pr+f31MLEqg7nrPPxpZH39LUx+HDUSEoMFrF7qZI5ME5Mc5eL14msf7FZ/PyE8yQq251FFOrx40mjRNVDQxupsPbYJziHYPZ6kOz/1SENDi9e85W38RADWaBN2AmoeZ34OdJUEM9n9isUKoIrMBATlfiaanL3HNYasz1P6BHIPt1lP6LiLpg5QE3tnbdzoCyq3pK+Vfq6s5paw5PrSvzKlZ2zVQ1I1AZfPqfPac28rrKmuT/uD1BWWwPEH5XeGXuo+Iybl1LI/ifNY\\u003d\",\"ephemeralPublicKey\":\"BT0/2SkGJo+BPVPYcWE4mvU0Bs/0B6MWEk3N6nlM55ewfnOatJ9kpGqiY22UJm8dtQCTphM\\u003d\",\"tag\":\"qvhau2mvT4/4/FSdRWaAR7j9hd0\\u003d\"}"}",
            "payeeId":"1185",
            "billAmount":"10",
            "description":"test payment",
            "shopOrderNumber":"123456",
            "attribute1":"1",
            "attribute2":"2",
            "attribute3":"3",
            "attribute4":"4",
            "emailRecipient":"test@gmail.com",
            "billCurrency":"UAH",
            "preauthFlag":"N"
        }
    },
    "id": "1"
}

Successful response parameters:

ParameterDescription
statusThe result of payment. Possible values:
success - successful payment,
error - error, or 3D Secure check is required
is3DS3DS-authorization flag ("Y" - 3D Secure check is required, "N" - no additional actions required)
shopBillIdA unique identifier (Id) assigned to each transaction (payment document) in the Portmone.com system
shopOrderNumberNumber of an order (bill) in the Online Store system. Maximum length is 120 symbols
descriptionComment to the order / description of payment details. Maximum length is 250 symbols
cardMaskPayer’s Card mask
billAmountThe transaction amount sent in the request
tokenToken value for subsequent payments
MDParameter which should be sent to acsUrl for 3D Secure check
PaReqParameter which should be sent to acsUrl for 3D Secure check
acsUrlThe card issuing bank page URL to which client should be redirected to confirm payment with 3D Secure
attribute1Service field. Filled at company’s discretion
attribute2Service field. Filled at company’s discretion
attribute3Service field. Filled at company’s discretion
attribute4Service field. Filled at company’s discretion
errorCodeError code
errorError description

An example of successful response:

{
    "result": {
        "status": "success",
        "is3DS": "N",
        "shopBillId": "476986520",
        "shopOrderNumber": "GO-14",
        "description": "test",
        "cardMask": "516874******5179",
        "billAmount": "1.23",
        "token": "",
        "MD": "",
        "PaReq": "",
        "acsUrl": "",
        "attribute1": "",
        "attribute2": "",
        "attribute3": "",
        "attribute4": "",
        "errorCode": "",
        "error": ""
    },
    "id": "1"
}

An example of response if 3D Secure check is required:

{
    "result": {
        "status": "error",
        "is3DS": "N",
        "shopBillId": "476986520",
        "shopOrderNumber": "GO-14",
        "description": "test",
        "cardMask": "516874******5179",
        "billAmount": "1.23",
        "token": "",
        "MD": "166765657",
        "PaReq": "eJxVUdtugkAQ/RXDY5O6u1wW1oxrqPbiA0KtfegjwY1iBHTBFvv1nUWs7SabzJnrmTMwaYv94FPpOq/KscWG1BqoMqvWebkZW++rp/vAmkhYbbVSszeVnbSSEKm6TjdqkK/HVpIu1ZF5nsMDfK7g3Oc2FUwI6nmccSE45ZaEJMQ8Cf0kiYOGNpArxJY626ZlIyHNjg/zhfTcgHsBkB5CofR8Jjljru9j4QVCmRZKJvFyFcWLx+E0ju6ek/ADSOeHrDqVjT7LgLpArgBOei+3TXOoR4QcKt0UVamGWVUAMREgNyrJyVg1dmrztYxm4Rf+Nl6F39EuaxdTyqJZRKPd6xiIyYB12ihpUyaoY/sDZo+YO3JxdueHtDAUcHXbwb0uAA5mRthHTOCvA1Bvjec4SxFQXOGKQLUHZI0ZKMWvDeRGePpilMwaFMlxHN/2fY+KTs7OZxrkKIaNZLsOBgAxVaS/FOmvjNa/6/8AWHOz+w==",
        "acsUrl": "https://acs.privatbank.ua/pPaReqMC.jsp",
        "attribute1": "",
        "attribute2": "",
        "attribute3": "",
        "attribute4": "",
        "errorCode": "",
        "error": ""
    },
    "id": "1"
}

To proceed with 3D Secure verification procedure client should be redirected to the issuing bank page (acsUrl). To do so merchant should send POST request including acsUrl, PaReq and MD parameters and merchant URL to return after 3D Secure (TermUrl).

Request parameters to call the bank page:

ParameterDescription
actionThe acsUrl value received in Portmone response
PaReqThe PaReq value received in Portmone response
MDThe MD value received in Portmone response
TermUrlURL of the merchant site to which the issuing bank returns a response message after passing 3D Secure. If payment is made from the application - app url

Example of the POST-request to call the bank page:

 <form id="TheForm" action="https://acs.privatbank.ua/pPaReqMC.jsp" method="POST" name="TheForm">
       <input type="hidden" name="PaReq" value="eJxVUdtugkAQ/RXDY5O6u1wW1oxrqPbiA0KtfegjwY1iBHTBFvv1nUWs7SabzJnrmTMwaYv94F
           PpOq/KscWG1BqoMqvWebkZW++rp/vAmkhYbbVSszeVnbSSEKm6TjdqkK/HVpIu1ZF5nsMDfK7g3Oc2FUwI6nmccSE45ZaEJMQ8Cf0kiYOGNpArx
           JY626ZlIyHNjg/zhfTcgHsBkB5CofR8Jjljru9j4QVCmRZKJvFyFcWLx+E0ju6ek/ADSOeHrDqVjT7LgLpArgBOei+3TXOoR4QcKt0UVamGWVUA
           MREgNyrJyVg1dmrztYxm4Rf+Nl6F39EuaxdTyqJZRKPd6xiIyYB12ihpUyaoY/sDZo+YO3JxdueHtDAUcHXbwb0uAA5mRthHTOCvA1Bvjec4SxF
           QXOGKQLUHZI0ZKMWvDeRGePpilMwaFMlxHN/2fY+KTs7OZxrkKIaNZLsOBgAxVaS/FOmvjNa/6/8AWHOz+w==" />
       <input type="hidden" name="MD" value="166765657" />
       <input type="hidden" name="TermUrl" value="https://portmone2.com/r3/ecommerce/test/" />
  </form>

Afrer entering a code at the issuing bank page the client returns to the merchant's server address (specified as TermUrl at the request). The response message from the bank contains parameters with MD and PaRes values which should be sent to the Portmone for obtaining authorization results.

Request parameters for 3D Secure confirmation:

ParameterDescription
MDThe MD value received from the bank to your URL
PaResThe PaRes value received from the bank to your URL
shopBillIdA unique identifier of transaction (payment document) in the Portmone.com system which was received in previous requests

An example of request to the Portmone for 3D Secure confirmation:

{"method":"confirmMpi", "params": { "data":

{ "MD":"166765657",
  "PaRes":"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",
  "shopBillId":"476986520" }
    },    "id": "1"}

The response from the Portmone.com will contain the result of payment.

Step 2. Check the integration checklist.

Step 3. Send to GPay mobile application package file (.apk) or link to site with payment page for verification.

← Masterpass iOS SDKApple Pay →