Skip to content

Google Pay Alternative

SS Integration option

Payment flow

  1. The customer initiates the payment on the merchant's website.
  2. The merchant sends the payment request to Freepayment.
  3. Freepayment sends a response containing the URL for completing the payment.
  4. The merchant redirects the customer to the provided URL.
  5. The customer completes the payment.
  6. Freepayment sends a webhook notification with the payment status to the merchant. The merchant may also request the payment status from Freepayment with the status query. If the transaction was successful, the webhook notification and the response to the status query may additionally contain google_pay_alt.account_number parameter with the card mask value.

Info

This integration option supports only EUR currency.

Payment

Request

Send a payment request with the following additional parameters:
object
return_url
required
 string
A URL to return the customer to when a transaction is completed.
object
A section of the payment method.
type
required
 string
google_pay_alt.
Request example 
{
  "request": {
    "amount": 100,
    "currency": "EUR",
    "description": "description",
    "test": false,
    "tracking_id": "your_unique_number",
    "ip": "127.0.0.1",
    "language": "en",
    "notification_url": "https://example.com/notification",
    "return_url": "https://example.com/return",   
    "method": {
      "type": "google_pay_alt"
    }
  }
}
Response

Redirect your customer to the URL received as the value of the form.action parameter.

Response example 
{
  "transaction": {
    "uid": "b3144345-9a5b-4101-827f-f96dc6f56f36",
    "type": "payment",
    "status": "pending",
    "amount": 100,
    "currency": "EUR",
    "description": "description",
    "created_at": "2026-02-24T14:14:37Z",
    "updated_at": "2026-02-24T14:14:37Z",
    "method_type": "google_pay_alt",
    "receipt_url": "https://account.freepayment.online/customer/transactions/b3144345-9a5b-4101-827f-f96dc6f56f36/e7894e316505655ec8b7232cc3fd5129462ffe19987835cba6ed1369fcb99ef7?language=en",
    "payment": {
      "status": "pending",
      "gateway_id": 6211,
      "ref_id": "4240880",
      "message": "Sender card details entry required",
      "bank_code": 35
    },
    "google_pay_alt": {
      "type": "google_pay_alt"
    },
    "customer": {
      "email": null,
      "ip": "127.0.0.1"
    },
    "manually_corrected_at": null,
    "version": 1,
    "message": "Sender card details entry required",
    "tracking_id": "your_unique_number",
    "test": false,
    "language": "en",    
    "additional_data": {
      "payment_method": {
        "type": "alternative"
      }
    },
    "smart_routing_verification": {
      "status": "successful"
    },
    "gateway": {
      "iframe": false
    },
    "form": {
      "action": "link-to-payment-page",
      "fields": [],
      "method": "GET"
    }
  }
}

Refund

Request

Send a standard refund request. The amount value must equal the amount of the corresponding payment transaction.