LiqPay icon_menu
LiqPay logo_lp_national_dk
Products
Industry solutions
Documentation
Tariffs
Information
Log in
Public
Google Pay
Easy way to pay from Google.
Options for generating data:
Main
ParameterRequiredTypeDescription
versionRequiredNumberVersion API. Current value - 3
public_keyRequiredStringPublic key - the store identifier. You can get the key in the store settings
actionRequiredStringpay, hold
amountRequiredNumberPayment amount. For example: 5, 7.34
currencyRequiredStringPayment currency. Possible values: USD, EUR, UAH
descriptionRequiredStringPayment description
order_idRequiredStringUnique purchase ID in your shop. Maximum length is 255 symbols
phone
Optional
StringPayer's phone number. The OTP-password will be sent to this telephone number to confirm your payment, and the linked payer's LiqPay cabinet. The telephone number should be indicated in the international format (Ukraine +380). For example: +380950000001 (with +) or 380950000001 (without +)
paytypeRequiredStringgpay_tavv
tavvRequiredStringA cryptogram is a dynamic one-time code for each transaction that accompanies a token. It is obtained when decrypting payment data from the Android device
language
Optional
StringCustomer's language uk, en
result_url
Optional
StringURL of your shop where the buyer would be redirected after completion of the purchase. Maximum length 510 symbols
server_url
Optional
StringURL API in your store for notifications of payment status change (server -> server). Maximum length is 510 symbols. Learn more
cardRequiredStringCard token obtained by decrypting data from an Google device
card_exp_monthRequiredStringExpiry month of the payer's token. For example: 08
card_exp_yearRequiredStringExpiry year of the payer's token. For example: 19
Sender parameters:
ParameterRequiredTypeDescription
sender_address
Optional
StringSender's address
sender_city
Optional
StringSender's city
sender_country_code
Optional
StringCountry code of the sender. Digital ISO 3166-1 code
sender_first_name
Optional
StringSender's first name
sender_last_name
Optional
StringSender's last name
sender_postal_code
Optional
StringSender's zip code
Parameters of splitting the payments:
ParameterRequiredTypeDescription
split_rules
Optional
StringPayment with a split amount for a few receivers. This parameter is a JSON array containing split rules. While using the split_rules parameter, the card is being charged and the amount is split and credited to a few receivers. If you need to convey your purpose for each amount use the parameter description. If you need to fiscalize payment, you should add the object rro_info into each part of the split rules.
Acquiring fee is being charged from each receiver in the split_rules.
Example JSON string:
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"
  }
]
Other parameters:
ParameterRequiredTypeDescription
dae
Optional
StringDetail Addenda.
Required for merchants with MCC 4511
Parameter dae is JSON string, to which function base64. JSON can contain the parameters shown in the example
Example of parameter dae: ewogICJhaXJMaW5lIjogIkROSVBST0FWSUEiLAogICJ0aWNrZXROdW1iZXIiOiAiQUNTRkQxMjM1NFNBIiwKICAicGFzc2VuZ2VyTmFtZSI6ICJKb2huIERvZSIsCiAgImZsaWdodE51bWJlciI6ICI3NDIiLAogICJvcmlnaW5DaXR5IjogIkRQIiwKICAiZGVzdGluYXRpb25DaXR5IjogIk5ZIiwKICAiZGVwYXJ0dXJlRGF0ZSI6ICIxMDA1MTQiCn0=
json
{
  "airLine": "Avia", // airline abbreviation, max 4 symbols.
  "ticketNumber": "ACSFD12354SA", // ticket number, max 15 symbols. 
  "passengerName": "John Doe", // passenger name, max 29 symbols.
  "flightNumber": "742", // flight number, max 5 number.
  "originCity": "DP", // departure city/airport code, max 5 symbols.
  "destinationCity": "NY", // arrival city/airport code, max 5 symbols.
  "departureDate": "100514" // departure date in format YYMMDD, max 6 number.
}
info
Optional
StringInformation to add details to payment. For example: «External information for payments»
product_category
Optional
StringProduct category in your shop. The maximum length is 25 symbols
product_description
Optional
StringProduct description in your shop. The maximum length is 500 symbols
product_name
Optional
StringProduct name in your shop. The maximum length is 100 symbols
product_url
Optional
StringProduct page address. The maximum length is 2000 symbols