Публічний
Google Pay
Зручний спосіб оплати від Google.
Параметри для формування data:
Основні
ParameterRequiredTypeDescription
versionRequiredNumberВерсія API. Поточне значення - 3
public_keyRequiredStringПублічний ключ - ідентифікатор магазину. Отримати ключ можна в налаштуваннях магазину
actionRequiredStringpay, hold
amountRequiredNumberСума платежу. Наприклад: 5, 7.34
currencyRequiredStringВалюта платежу. Можливі значення: USD, EUR, UAH
descriptionRequiredStringПризначення платежу
order_idRequiredStringУнікальний ID покупки у Вашому магазині. Максимальна довжина 255 символів
phone
Optional
StringТелефон платника. На цей номер буде відправлений OTP пароль підтвердження платежу та підвязаний кабінет платника LiqPay. Телефон вказується в міжнародному форматі (Україна +380). Наприклад: +380950000001 (з +) або 380950000001 (без +)
paytypeRequiredStringgpay_tavv
tavvRequiredStringКриптограма — динамічний одноразовий код кожної транзакції, що супроводжує токен. Виходить при розшифровці платіжних даних із пристрою Android
language
Optional
StringМова клієнта uk, en
result_url
Optional
StringURL у Вашому магазині на який покупця буде переадресовано після завершення покупки. Максимальна довжина 510 символів
server_url
Optional
StringURL API в Вашому магазині для повідомлень про зміну статусу платежу (сервер -> сервер). Максимальна довжина 510 символів. Детальніше
cardRequiredStringТокен картки, отриманий при декриптуванні даних від Google
card_exp_monthRequiredStringМісяць терміну дії токену платника. Наприклад: 08
card_exp_yearRequiredStringРік терміну дії токену платника. Наприклад: 19
Параметри відправника:
ParameterRequiredTypeDescription
sender_address
Optional
StringАдреса відправника
sender_city
Optional
StringМісто відправника
sender_country_code
Optional
StringКод країни відправника. Цифровий ISO 3166-1 код
sender_first_name
Optional
StringІм'я відправника
sender_last_name
Optional
StringПрізвище відправника
sender_postal_code
Optional
StringПоштовий індекс відправника
Параметри розщеплення платежу:
ParameterRequiredTypeDescription
split_rules
Optional
StringПлатіж з розщепленням суми на декількох одержувачів. У цьому параметрі вказується JSON масив з правилами розщеплення платежу. При використанні параметра split_rules відбувається одне списання з клієнта і кілька зарахувань одержувачам. Якщо необхідно передавати своє призначення по кожній сумі використовуйте параметр description.
Якщо необхідно фіскалізувати платежі по кожному одержувачу слід додати об'єкт rro_info. Еквайрингова комісія стягується з кожного одержувача в масиві split_rules.
Приклад JSON рядка:
[
  {
    "public_key": "i000000001",
    "amount": 404,
    "commission_payer": "sender",
    "server_url": "https://server1/callback",
    "rro_info": {
      "items": [
        {
          "amount": 2,
          "price": 202,
          "cost": 404,
          "id": 123456
        }
      ],
      "delivery_emails": [
        "email1@email.com",
        "email2@email.com"
      ]
    }
  },
  {
    "public_key": "i000000002",
    "amount": 200,
    "commission_payer": "receiver",
    "server_url": "https://server2/callback"
  }
]
Інші параметри:
ParameterRequiredTypeDescription
dae
Optional
StringДовгий запис Detail Addenda.
Обов'язковий для мерчантів з МСС 4511
Параметр dae являє собою JSON рядок, до якого застосували функцію base64. JSON може містити параметри наведені у прикладі
Приклад параметру dae: ewogICJhaXJMaW5lIjogIkROSVBST0FWSUEiLAogICJ0aWNrZXROdW1iZXIiOiAiQUNTRkQxMjM1NFNBIiwKICAicGFzc2VuZ2VyTmFtZSI6ICJKb2huIERvZSIsCiAgImZsaWdodE51bWJlciI6ICI3NDIiLAogICJvcmlnaW5DaXR5IjogIkRQIiwKICAiZGVzdGluYXRpb25DaXR5IjogIk5ZIiwKICAiZGVwYXJ0dXJlRGF0ZSI6ICIxMDA1MTQiCn0=
{
  "airLine": "Avia", // абревіатура авіакомпанії, max 4 символів.
  "ticketNumber": "ACSFD12354SA", // номер квитка, max 15 символів. 
  "passengerName": "John Doe", // ім'я пасажира, max 29 символів.
  "flightNumber": "742", // номер рейсу, max 5 цифр.
  "originCity": "DP", // код міста/аеропорту вильоту, max 5 символів.
  "destinationCity": "NY", // код міста/аеропорту призначення, max 5 символів.
  "departureDate": "100514" // дата вильоту в форматі YYMMDD, max 6 цифр.
}
info
Optional
StringІнформація для додавання даних до платежу. Наприклад: «External information for payments»
product_category
Optional
StringКатегорія товару. Максимальна довжина 25 символів
product_description
Optional
StringОпис товару. Максимальна довжина 500 символів
product_name
Optional
StringНазва товару. Максимальна довжина 100 символів
product_url
Optional
StringАдреса сторінки з товаром. Максимальна довжина 510 символів