Google Pay Alternative

Вариант интеграции GW

Описание процесса оплаты

Покупатель инициирует Google Pay оплату на странице торговца.
Торговец отправляет запрос оплаты в PaySage.io.
PaySage.io возвращает торговцу ссылку для завершения оплаты.
Торговец перенаправляет покупателя на полученную ссылку. По ссылке открывается страница, где отображена сумма транзакции и размещена кнопка для оплаты с помощью Google Pay.
Покупатель совершает оплату с помощью Google Pay.
PaySage.io высылает торговцу автоматическое уведомление со статусом оплаты.

Info

Этот вариант интеграции поддерживает только валюту EUR.

Оплата

Запрос

Отправьте запрос оплаты, указав следующие дополнительные параметры:

Параметр	Тип данных	Описание
request	object
amount * обязательный	bigInteger	Сумма транзакции в минимальных денежных единицах, например, 5000 (50 евро).
return_url * обязательный	string	URL, на который будет возвращен покупатель после завершения операции в платёжной системе.
ip * обязательный	string	IP-адрес покупателя.
method	object	Секция параметров способа оплаты.
type * обязательный	string	`google_pay_alt`
customer	object	Секция информации о покупателе.
phone	string	Номер телефона покупателя.
email * обязательный	string	Адрес электронной почты покупателя.
first_name	string	Имя покупателя.
last_name	string	Фамилия покупателя.
middle_name	string	Отчество покупателя.
country	string	Страна покупателя в формате ISO 3166-1 alpha-2. Например, `DE`.

Пример запроса

{
    "request": {
        "amount": 200,
        "currency": "EUR",
        "description": "description",
        "return_url": "https://your_return_url.com",
        "ip": "127.0.0.1",
        "method": {
            "type": "google_pay_alt"
        },
        "customer": {
            "phone": "0123456789",
            "email": "email@example.com"
        }
    }
}

Ответ

Отправьте покупателя на URL, указанный в параметре form.action.

Пример ответа

{
    "transaction": {
        "uid": "5658d7ca-6f8c-4050-ac19-05980b8356e5",
        "type": "payment",
        "status": "pending",
        "amount": 200,
        "currency": "EUR",
        "description": "description",
        "created_at": "2024-08-14T14:51:59Z",
        "updated_at": "2024-08-14T14:52:01Z",
        "method_type": "google_pay_alt",
        "receipt_url": "https://backoffice.paysage.io/customer/transactions/5658d7ca-6f8c-4050-ac19-05980b8356e5/96003c2fd2601e204900b4df53b549a471743e262b15a3d8d8109d6c8ea1b1f7",
        "payment": {
            "status": "pending",
            "gateway_id": 4379,
            "ref_id": "363698704",
            "message": "Transaction was initialized."
        },
        "google_pay_alt": {
            "type": "google_pay_alt"
        },
        "customer": {
            "email": "email@example.com",
            "phone": "0123456789",
            "ip": "127.0.0.1"
        },
        "manually_corrected_at": null,
        "version": 0,
        "message": "Transaction was initialized.",
        "test": false,
        "billing_address": {
            "email": "email@example.com",
            "phone": "0123456789"
        },
        "additional_data": {
            "payment_method": {
                "type": "alternative"
            }
        },       
        "gateway": {
            "iframe": false
        },
        "form": {
            "action": "https://example.com/url-for-redirect",
            "method": "GET",
            "fields": []
        }
    }
}

Вариант интеграции TW

Описание процесса оплаты

Покупатель инициирует Google Pay оплату на странице торговца.
Торговец отправляет запрос оплаты в PaySage.io.
PaySage.io присылает в ответе параметры для формирования HTML формы для завершения оплаты.
Торговец перенаправляет покупателя на форму для завершения оплаты.
Покупатель совершает оплату с помощью Google Pay.
PaySage.io высылает торговцу автоматическое уведомление со статусом оплаты.

Info

Этот вариант интеграции поддерживает только валюту EUR.

Оплата

Запрос

Отправьте запрос оплаты, указав следующие дополнительные параметры:

Параметр	Тип данных	Описание
request	object
amount * обязательный	bigInteger	Сумма транзакции в минимальных денежных единицах, например, 5000 (50 евро).
return_url * обязательный	string	URL, на который будет возвращен покупатель после завершения операции в платёжной системе.
method	object	Секция параметров способа оплаты.
type * обязательный	string	`google_pay_alt`
ip	string	IP-адрес покупателя.
customer	object	Секция информации о покупателе.
country	string	Страна покупателя в формате ISO 3166-1 alpha-2. Например, `AT`.
phone	string	Номер телефона покупателя.
email	string	Адрес электронной почты покупателя.
first_name	string	Имя покупателя.
last_name	string	Фамилия покупателя.
city	string (120)	Город покупателя.
zip	string (40)	Почтовый индекс покупателя.
address	string (510)	Адрес покупателя.
birth_date	string	Дата рождения покупателя в формате ISO-8601 (`YYYY-MM-DD`).

Пример запроса

{
    "request": {
        "amount": 500,
        "currency": "EUR",
        "description": "test description",
        "test": false,
        "tracking_id": "your_uniq_number21212",
        "return_url": "https://example.com/return",
        "method": {
            "type": "google_pay_alt"
        },
        "customer": {
            "email": "example@example.com"
        }
    }
}

Ответ

Направьте покупателя на форму для завершения оплаты. В качестве значений полей формы используйте значения из секции form из ответа на запрос оплаты.

<form action="https://tw-integration-option/transaction/PGRRedirect?gw=XPV2&trackingId=52104859" method="POST">
    <input type="hidden" name="TermUrl" value="https://tw-integration-option/transaction/PGRRedirect?gw=XPV2&trackingId=52104859">
    <input type="hidden" name="XPV2" value="">
    <input type="submit" value="Submit">
</form>

Пример ответа

{
    "transaction": {
        "uid": "c95498bc-6c70-434c-b083-91a1b63b1bc9",
        "type": "payment",
        "status": "pending",
        "amount": 1000,
        "currency": "EUR",
        "description": "test description",
        "created_at": "2024-12-19T07:18:03Z",
        "updated_at": "2024-12-19T07:18:09Z",
        "method_type": "google_pay_alt",
        "receipt_url": "https://backoffice.paysage.io/customer/transactions/c95498bc-6c70-434c-b083-91a1b63b1bc9/b61efa9b947bbd9942938684465c48349edc3242ccf0207f3bae6a3ec2927728",
        "payment": {
            "status": "pending",
            "gateway_id": 4752,
            "ref_id": "52104859",
            "message": "Transaction is pending",
            "bank_code": "10004"
        },
        "google_pay_alt": {
            "type": "google_pay_alt"
        },
        "customer": {
            "email": "example@example.com",
            "ip": null
        },
        "manually_corrected_at": null,
        "version": 0,
        "message": "Transaction is pending",
        "tracking_id": "your_uniq_number21212",
        "test": false,
        "billing_address": {
            "email": "example@example.com"
        },
        "additional_data": {
            "payment_method": {
                "type": "alternative"
            }
        },

        "gateway": {
            "iframe": false
        },
        "form": {
            "action": "https://tw-integration-option/transaction/PGRRedirect?gw=XPV2&trackingId=52104859",
            "method": "POST",
            "fields": [
                {
                    "name": "TermUrl",
                    "value": "https://tw/pay/f2a3feae-831c-470e-bbf4-05df69ebb16e/select-payment-method/google-pay/69a68e24-2da5-4b7b-901b-20c360d92503/"
                },
                {
                    "name": "XPV2",
                    "value": ""
                }
            ]
        }
    }
}

Возврат средств

Запрос

Отправьте стандартный запрос возврата средств. Сумма возврата не должна превышать сумму родительской транзакции.

Вариант интеграции TW2

Описание процесса оплаты

Покупатель инициирует Google Pay оплату на странице торговца.
Торговец отправляет запрос оплаты в PaySage.io.
PaySage.io присылает в ответе параметры для формирования HTML формы для завершения оплаты.
Торговец перенаправляет покупателя на форму для завершения оплаты.
Покупатель совершает оплату с помощью Google Pay.
PaySage.io высылает торговцу автоматическое уведомление со статусом оплаты.

Info

Этот вариант интеграции поддерживает только валюту EUR.

Оплата

Запрос

Отправьте запрос оплаты, указав следующие дополнительные параметры:

Параметр	Тип данных	Описание
request	object
amount * обязательный	bigInteger	Сумма транзакции в минимальных денежных единицах, например, 5000 (50 евро).
return_url * обязательный	string	URL, на который будет возвращен покупатель после завершения операции в платёжной системе.
method	object	Секция параметров способа оплаты.
type * обязательный	string	`google_pay_alt`
ip	string	IP-адрес покупателя.
customer	object	Секция информации о покупателе.
country	string	Страна покупателя в формате ISO 3166-1 alpha-2. Например, `AT`.
phone	string	Номер телефона покупателя.
email	string	Адрес электронной почты покупателя.
first_name	string	Имя покупателя.
last_name	string	Фамилия покупателя.
city	string (120)	Город покупателя.
zip	string (40)	Почтовый индекс покупателя.
state	string	Двухбуквенная аббревиатура штата, если страна покупателя `US`, `CA` или `IN`.
address	string (510)	Адрес покупателя.

Пример запроса

{
    "request": {
        "amount": 100,
        "currency": "EUR",
        "description": "test description",
        "test": false,
        "tracking_id": "your_uniq_number21212",
        "return_url": "https://your-success.url",
        "method": {
            "type": "google_pay_alt"           
        },
        "customer": {
            "phone": "123456789",
            "country": "DE",
            "city": "Berlin",
            "address": "Friedrichstrasse, 8",
            "first_name": "Helen",
            "last_name": "Kohl",
            "email": "helen@example.com"
        }
    }
}

Ответ

Создайте HTML-форму, используя параметры из секции form. Отправьте покупателя на форму для завершения оплаты.

Пример ответа

{
  "transaction": {
    "uid": "0b26a3de-8753-47e1-9181-ff422285afdc",
    "type": "payment",
    "status": "pending",
    "amount": 100,
    "currency": "EUR",
    "description": "test description",
    "created_at": "2025-03-19T09:41:08Z",
    "updated_at": "2025-03-19T09:41:08Z",
    "method_type": "google_pay_alt",
    "receipt_url": "https://backoffice.paysage.io/customer/transactions/0b26a3de-8753-47e1-9181-ff422285afdc/52a0a76f39f30cb3979f21906e8cf62808eab230e4d5b94dceddaa6761228f1d",
    "payment": {
      "status": "pending",
      "gateway_id": 5091,
      "message": "Transaction was initialized."
    },
    "google_pay_alt": {
      "type": "google_pay_alt"
    },
    "customer": {
      "first_name": "Helen",
      "last_name": "Kohl",
      "email": "helen@example.com",
      "country": "DE",
      "city": "Berlin",
      "address": "Friedrichstrasse, 8",
      "phone": "123456789",
      "ip": null
    },
    "manually_corrected_at": null,
    "version": 0,
    "message": "Transaction was initialized.",
    "tracking_id": "your_uniq_number21212",
    "test": false,
    "billing_address": {
      "first_name": "Helen",
      "last_name": "Kohl",
      "email": "helen@example.com",
      "country": "DE",
      "city": "Berlin",
      "address": "Friedrichstrasse, 8",
      "phone": "123456789"
    },
    "additional_data": {
      "payment_method": {
        "type": "alternative"
      }
    },    
    "gateway": {
      "iframe": false
    },
    "form": {
      "action": "tw-2/transaction/Checkout",
      "method": "POST",
      "fields": [
        {
          "name": "memberId",
          "value": "13106",
          "type": "hidden"
        },
        {
          "name": "terminalid",
          "value": "6093",
          "type": "hidden"
        },
        {
          "name": "partnerId",
          "value": "39",
          "type": "hidden"
        },
        {
          "name": "checksum",
          "value": "7d0a47520e551b544f7e31e2e83455eb",
          "type": "hidden"
        },
        {
          "name": "merchantTransactionId",
          "value": "0b26a3de-8753-47e1-9181-ff422285afdc",
          "type": "hidden"
        },
        {
          "name": "amount",
          "value": "1.00",
          "type": "hidden"
        },
        {
          "name": "currency",
          "value": "EUR",
          "type": "hidden"
        },
        {
          "name": "paymentBrand",
          "value": "GOOGLEPAY",
          "type": "hidden"
        },
        {
          "name": "paymentMode",
          "value": "EW",
          "type": "hidden"
        },
        {
          "name": "orderDescription",
          "value": "test description",
          "type": "hidden"
        },
        {
          "name": "country",
          "value": "DE",
          "type": "hidden"
        },
        {
          "name": "city",
          "value": "Berlin",
          "type": "hidden"
        },
        {
          "name": "postcode",
          "value": "15239-5452",
          "type": "hidden"
        },
        {
          "name": "street",
          "value": "Friedrichstrasse, 8",
          "type": "hidden"
        },
        {
          "name": "firstName",
          "value": "Helen",
          "type": "hidden"
        },
        {
          "name": "lastName",
          "value": "Kohl",
          "type": "hidden"
        },
        {
          "name": "email",
          "value": "helen@example.com",
          "type": "hidden"
        },
        {
          "name": "merchantRedirectUrl",
          "value": "https://api.paysage.io/beyag/transactions/returns/88c70e7191aa823ac0588a279d22ef5722fc26712f6eac23ab76b53a65019c48/0b26a3de-8753-47e1-9181-ff422285afdc",
          "type": "hidden"
        },
        {
          "name": "notificationUrl",
          "value": "https://api.paysage.io/beyag/transactions/notifications/88c70e7191aa823ac0588a279d22ef5722fc26712f6eac23ab76b53a65019c48/0b26a3de-8753-47e1-9181-ff422285afdc",
          "type": "hidden"
        },
        {
          "name": "totype",
          "value": "TW",
          "type": "hidden"
        },
        {
          "name": "phone",
          "value": "456789",
          "type": "hidden"
        },
        {
          "name": "telnocc",
          "value": "123",
          "type": "hidden"
        }
      ]
    }
  }
}

Возврат средств

Запрос

Отправьте стандартный запрос возврата средств. Сумма возврата не должна превышать сумму родительской транзакции. Для одной транзакции оплаты можно совершить несколько транзакций возврата средств при условии, что сумма возвратов не превышает сумму соответствующей им родительской транзакции.