Google Pay

Google Pay provides both in-app and web purchasing experiences for customers with supported Android devices. It allows customers to pay with cards and PayPal accounts stored in their Google account, in addition to those stored in Google Pay.

For more details on compatibility and availability, see our Google Pay support article.

Creating transactions

Using Credit Cards

For the purpose of making transactions, a Google Pay card is treated just like a standard credit card with a few noted differences.

You can create a Google Pay transaction using the chargePaymentMethod mutation while suppling an amount and paymentMethodId.

mutation ChargePaymentMethod($input: ChargePaymentMethodInput!) {
  chargePaymentMethod(input: $input) {
    transaction {
      id
      legacyId
      status
      paymentMethodSnapshot {
        ... on CreditCardDetails {
          origin {
            type
            details {
              ... on GooglePayOriginDetails {
                googleTransactionId
                bin
              }
            }
          }
        }
      }
    }
  }
}

{
  "input": {
    "paymentMethodId": "id_of_payment_method",
    "transaction": {
      "amount": "1.00"
    }
  }
}

{
  "data": {
    "chargePaymentMethod": {
      "transaction": {
        "id": "id_of_transaction",
        "legacyId": "legacy_id_of_transaction",
        "status": "SUBMITTED_FOR_SETTLEMENT",
        "paymentMethodSnapshot": {
          "origin": {
            "type": "GOOGLE_PAY",
            "details": {
              "googleTransactionId": "id_of_google_transaction",
              "bin": "bank_identification_number"
            }
          }
        }
      }
    }
  },
  "extensions": {
    "requestId": "a-uuid-for-the-request"
  }
}

Notice the origin field in the response. The type clearly spells out that it's a Google Pay transaction. You are also able to pass device data under riskData for added fraud analysis information just like a in standard credit card charge.

Using PayPal with Google Pay

Using PayPal on Google Pay will create a PayPal rather than a Google Pay transaction. PayPal transactions using Google Pay can be done the same as credit card transactions on Google Pay using the chargePaymentMethod mutation. The PayPal payment method will be noted with a Google Pay origin, and the transaction will have FacilitatorDetails.OAuthApplication.name set to Google.

mutation ChargePaymentMethod($input: ChargePaymentMethodInput!) {
  chargePaymentMethod(input: $input) {
    transaction {
      id
      status
      paymentMethodSnapshot {
        __typename
        ... on PayPalTransactionDetails {
          origin {
            details {
              __typename
            }
          }
        }
      }
      facilitatorDetails{
        oauthApplication{
          name
        }
      }
    }
  }
}

{
  "input": {
    "paymentMethodId": "id_of_google_pay_paypal_payment_method",
    "transaction": {
      "amount": "1.00"
    }
  }
}

{
  "data": {
    "chargePaymentMethod": {
      "transaction": {
        "id": "id_of_transaction",
        "status": "SETTLING",
        "paymentMethodSnapshot": {
          "__typename": "PayPalTransactionDetails",
          "origin": {
            "details": {
              "__typename": "GooglePayOriginDetails"
            }
          }
        },
        "facilitatorDetails": {
          "oauthApplication": {
            "name": "Google"
          }
        }
      }
    }
  },
  "extensions": {
    "requestId": "a-uuid-for-the-request"
  }
}

Creating a transaction with a PayPal account through Google Pay is effectively the same as creating a transaction from your PayPal integration, they have the same settlement rules and options that typical PayPal transactions have.

Vaulting Google Pay

Google Pay cards can only be saved to your Vault for specific use cases; see the support article for details.

Vaulting of PayPal accounts from Google Pay is currently not supported. This means the options passed in vaultPaymentMethodAfterTransacting while using chargePaymentMethod mutation are not supported when creating a transaction.

If your use case is supported, you can store a customer's Google Pay card in your Vault in one of the following ways:

• Using the vaultPaymentMethod mutation
• Including vaultPaymentMethodAfterTransacting in the input for the chargePaymentMethod mutation