Requests

Pay

Once you have properly implemented the Google Pay™ button on your site, you can proceed with processing the Payment via Buckaroo's Checkout Gateway.

The flow of processing the payment once you received the token is as follows:

Retrieve the Token from the “paymentData” parameter of the “processPayment” callback function.
Initiate a Google Pay Transaction via Buckaroo. Provide the Base64 Encoded Token as parameter in the request under the name PaymentData.

Service-specific parameters

Parameter	Required	Type	Description
Payment data	Yes	String	Base64 Encoded string of the retrieved token from Google Pay API
CustomerCardName	No	String	The full name of the card holder.

Basic parameters

You can find basic parameters here.

Example request

{
    "Invoice": "Dummy_Invoice",
    "Description": "Dummy_Description",
    "Currency": "EUR",
    "AmountDebit": 0.01,
    "Services": {
        "ServiceList": [
            {
                "Name": "GooglePay",
                "Action": "Pay",
                "Parameters": [
                    {
                        "Name": "PaymentData",
                        "Value": "VGhpcyBpcyBhIEJhc2U2NCBlbmNvZGVkIHRleHQ="
                    },
                    {
                        "Name": "CustomerCardName",
                        "Value": "XXXXXXXXXXXXX”
                    }
                ]
            }
        ]
    }
}

Pay Response

Service-specific parameters

Parameter	Type	Required	Recommended	Description
CardNumberEnding	String			Last 4 digits of the credit card number.
CardExpirationDate	String			Credit card expiration date.
MaskedCreditcardNumber	String			Masked card number.

Example response

{
   "Key": "9AA4C81A08A84FA7B68E6A6A6291XXXX",
   "Status": {
      "Code": {
         "Code": 190,
         "Description": "Success"
      },
      "SubCode": {
         "Code": "S001",
         "Description": "Transaction successfully processed"
      },
      "DateTime": "2019-06-13T09:19:52"
   },
   "RequiredAction": null,
   "Services": [
      {
         "Name": "GooglePay",
         "Action": null,
         "Parameters": [
            {
               "Name": "CardNumberEnding",
               "Value": "00XX"
            },
            {
               "Name": "CardExpirationDate",
               "Value": "0019-07"
            },
            {
               "Name": "MaskedCreditcardNumber",
               "Value": "XXXXXX******XXXX"
            }
         ]
      }
   ],
   "CustomParameters": null,
   "RequestErrors": null,
   "Invoice": "10000480",
   "ServiceCode": "googlepay",
   "IsTest": true,
   "Currency": "EUR",
   "AmountDebit": 1.00,
   "TransactionType": "V187",
   "MutationType": 2,
   "RelatedTransactions": null,
   "ConsumerMessage": null,
   "Order": "10000480",
   "IssuingCountry": null,
   "StartRecurrent": false,
   "Recurring": false,
   "CustomerName": "XXXXXXXXXXXX",
   "PayerHash": "XXXXXXXXXXXXXXXXXXX",
   "PaymentKey": "XXXXXXXXXXXXXXXXXXXXXX"
}

Refund

Refund Request

Parameters

Parameter	Type	Required	Recommended	Description
OriginalTransactionKey	String	Yes	N/A	Transaction key of the payment that needs to be refunded. Please note: This is a basic parameter, not a service specific parameter.

Example request

{
   "Currency": "EUR",
   "AmountCredit": 1.00,
   "Invoice": "10000480",
   "OriginalTransactionKey": "XXXXXXXXXXXXXXX",
   "Services": {
      "ServiceList": [
         {
            "Name": "googlepay",
            "Action": "refund"
         }
      ]
   }
}

Refund Response

Example response

{
   "Key": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
   "Status": {
      "Code": {
         "Code": 190,
         "Description": "Success"
      },
      "SubCode": {
         "Code": "S001",
         "Description": "Transaction successfully processed"
      },
      "DateTime": "2019-06-13T09:20:24"
   },
   "RequiredAction": null,
   "Services": null,
   "CustomParameters": null,
   "RequestErrors": null,
   "Invoice": "10000480",
   "ServiceCode": "googlepay",
   "IsTest": true,
   "Currency": "EUR",
   "AmountCredit": 1.00,
   "TransactionType": "V188",
   "MutationType": 2,
   "RelatedTransactions": [
      {
         "RelationType": "refund",
         "RelatedTransactionKey": "XXXXXXXXXXXXXXXXXXXXX"
      }
   ],
   "ConsumerMessage": null,
   "Order": null,
   "IssuingCountry": null,
   "StartRecurrent": false,
   "Recurring": false,
   "CustomerName": "XXXXXXXXXXXX",
   "PayerHash": null,
   "PaymentKey": "XXXXXXXXXXXXXXXX"
}

Refund Push

Parameters

Example push

{
   "Key": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
   "Status": {
      "Code": {
         "Code": 190,
         "Description": "Success"
      },
      "SubCode": {
         "Code": "S001",
         "Description": "Transaction successfully processed"
      },
      "DateTime": "2019-06-13T09:20:24"
   },
   "RequiredAction": null,
   "Services": null,
   "CustomParameters": null,
   "RequestErrors": null,
   "Invoice": "10000480",
   "ServiceCode": "googlepay",
   "IsTest": true,
   "Currency": "EUR",
   "AmountCredit": 1.00,
   "TransactionType": "V188",
   "MutationType": 2,
   "RelatedTransactions": [
      {
         "RelationType": "refund",
         "RelatedTransactionKey": "XXXXXXXXXXXXXXXXXXXXX"
      }
   ],
   "ConsumerMessage": null,
   "Order": null,
   "IssuingCountry": null,
   "StartRecurrent": false,
   "Recurring": false,
   "CustomerName": "XXXXXXXXXXXX",
   "PayerHash": null,
   "PaymentKey": "XXXXXXXXXXXXXXXX"
}

Updated about 6 hours ago