Цей функціонал буде активовано після вашого запиту в груповому чаті.

Зміст

Опис

Цей метод дозволить розмістити на вашому сайті або додатку окрему кнопку оплати Google Pay.

Демо

Чекліст інтеграції

Привести сайт / додаток до відповідності вимогам.
Інтегрувати API Google Pay.
Вказати environment в режимі TEST.
Передати тех підтримці PSP Platon посилання для Callback.
Повідомити тех підтримці PSP Platon ваші IP адреси серверів сайта або про те, що буде використовуватить додаток (в цьому випадку обмеження по IP будуть зняті).
Провести запит по API Google Pay для отримання кнопки Google Pay.
Після авторизації користувача та вибору реальної картки в гаманці Google Pay вам повернуться зашифровані дані PaymentData.
З отриманих шифрованих даних PaymentData необхідно витянути token та відформатувати його відповідно до вимогам і прикладу вказаному в цій документації.
Провести запит відповідно API методу PSP Platon використовуючи відформатований токен Google Pay.
Отримати Response або Callback для редиректа платника на 3DS перевірку.
Відправити кліента на 3DS перевірку.
Отримати Response або Callback зі статусом оплати DECLINED від PSP Platon.
Відправити запит в Google Business Console для активації акаунта.
Повідомити тех підтримці PSP Platon про активацію акаунта.
Вказати environment в режимі PRODUCTION.
Провести запит з отриманням Response или Callback зі статусом оплати SUCCESS від PSP Platon.
Відобразити клиенту інформаію про успішну / невдалу оплату.

Вимоги

SSL сертифікат

У вашого сайту має бути валідний SSL сертифікат.

Для перевірки валідності та терміну дії вашого SSL сертифіката рекомендуємо скористатися сервісом за посиланням.

TLS 1.2

Обов'язкова підтримка протоколу TLS не нижче версії 1.2

Логотипи платіжних систем та PSP Platon

У футері вашого сайту необхідно розмістити логотипи платіжних систем та PSP Platon.

У випадку регулярних списань без участі платника

Повідомити платника про умови підписки та регулярних списань та отримати підтвердження про згоду з умовами
Розмістити договір публічної оферти та отримати підтвердження від платника про згоду з умовами
Надати платнику можливість відмінити підписку
Згідно правил МПС дозволена лише одна спроба списання коштів з платника за добу

Обмеження

Браузери

На даний момент Google Pay працює в таких браузерах:

Chrome
Safari
UC Browser
Firefox
Opera
Microsoft Edge
Android

WebView

Google забороняє використовувати Google Pay в WebView.

Google Business Console

Активація Google Pay в Business Console

Інструкція по активація Google Pay в Business Console

Пройдіть весь чекліст інтеграції:

Перейдіть в Business Console.

Створіть нову або використайте існуючу компанію (при інтеграції в додаток акаунт має бути той самий з якого ви вивантажуєте його в магазин Google Play).

В правому верхньому кутку вказано ваш Merchant ID.

Перейдіть до розділу Профіль Компанії.

Заповніть дані про вашу компанію або пропустіть цей крок якщо дані вже внесено.

Перейдіть до розділу Google Pay API.

Виберіть необхідний для вас варіант інтеграції - Android додаток або сайт.

Для прикладу розглянемо варіант інтеграції для сайту. Для Android додатку процедура аналогічна.

Вкажіть адресу вашого сайту. Сайт обов'язково має підтримувати HTTPS.

Виберіть Тип інтеграції - Через шлюз.

Трохи нижче на цій же сторінці завантажте 5 скріншотів процедури проходження Google Pay клієнтом на вашому сайті.

Натисніть Зберегти (кнопка в нижній частині сторінки).

Натисніть Submit for approval (кнопка у верхній частині сторінки).

Google Pay API

Для сайта:

Для Android додатку:

Інтегруйте Google Pay API слідуючи документації вище для отримання PaymentData.

Параметри:

allowPaymentMethods : CARD
tokenizationSpecification = { "type": "PAYMENT_GATEWAY"}
allowedCardNetworks = ['MASTERCARD', 'VISA'];
allowedCardAuthMethods = ['PAN_ONLY', 'CRYPTOGRAM_3DS'];
gateway = platon
gatewayMerchantId = CLIENT_KEY (API ключ PSP Platon)

Приклад конфіг файла

{
    "apiVersion": 2,
    "apiVersionMinor": 0,
    "allowedPaymentMethods": [
        {
            "type": "CARD",
            "parameters": {
                "allowedAuthMethods": ["PAN_ONLY", "CRYPTOGRAM_3DS"],
                "allowedCardNetworks": ["VISA", "MASTERCARD"]
            },
            "tokenizationSpecification": {
                "type": "PAYMENT_GATEWAY",
                "parameters": {
                    "gateway": "platon", //фіксований ідентифікатор PSP Platon
                    "gatewayMerchantId": "RJ9AE5Y7GX" //API ключ PSP Platon
                }
            }
        }
    ],
    "merchantInfo": {
        "merchantId": "00986993593073708917", //ваші дані з Google Business Console
        "merchantName": "Name" //ваші дані з Google Business Console
    },
    "transactionInfo": {
        "totalPriceStatus": "FINAL",
        "totalPriceLabel": "Total",
        "totalPrice": "5.00",
        "currencyCode": "UAH",
        "countryCode": "UA"
    }
}

Якщо все зробити правильно - на вашому сайті / додатку відобразиться кнопка Google Pay та після вибору картки вам повернеться набір даних з PaymentData.

Приклад набору даних PaymentData, які повертаються від Google Pay

{
  "apiVersionMinor": 0,
  "apiVersion": 2,
  "paymentMethodData": {
    "description": "Mastercard •••• 5179",
    "tokenizationData": {
      "type": "PAYMENT_GATEWAY",
      "token": {
        "signature": "MEYCIQC+IHxUu9Wwra2Vu6tBa2wJPCMT3pWtN1VphLGYtNVLLwIhAOkdbNje//eLrXVc+n6LOlc4PqxWOUcqwrmki/CNA1ur",
        "intermediateSigningKey": {
          "signedKey": "{\"keyValue\":\"MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEwhRrvGB0kZ1248MEJAPwX0YfrQInhyyRM7nyGFjQuzGSViZG3QC9NMvXR9Zd6uVcVzAz+6K/+NEGIWbX8zbk6A\\u003d\\u003d\",\"keyExpiration\":\"1571208568000\"}",
          "signatures": [
            "MEUCIQCR6vIEiyHB8qmlho4/tLd7W8CIGrZDJlCI48CBHeFPvQIgLZJIe4cZv6pYtYYa56QCI/vvg1GqXTP3bTBjO49r5mI="
          ]
        },
        "protocolVersion": "ECv2",
        "signedMessage": "{\"encryptedMessage\":\"k85CGUMmd5PaGmQlHFqHc0HrDZmjM1yG82rFB/p31ZyUleN5nihzjOZif/BKXwg3XA2oLXqBSSWcAdfZwXxCEOqvAQE+kpTC7qVO4wTPip6RruraT6vO9M9FtIf0kcqzYSAN7pl1SUA5jC9rHrqucPoh0/FSspup78SWBt8TnmVKC9O3sQhIZ3SMoGOG4mdjtIrgCwWH2cbrxUH0dHAqOe5ANGOY/mII4nTEp7xaKu41hK/kFE15zVyqgPJXP9bPxzMVk/ozEZSfhSzVTS+9stjkU/kT5EibKB3O1bbxyybKcGQ5vxBOtNOBKKd/NuqNmN2eEK3UbSKb1M3gv45gT9cCeEvlzO7Wg0N100vUBp9RPDN9TH4tj4w578sWFKfTi6FsSrZB27SGWcU0EaKHO9buo94mRBY5yqffF3bKg5mAMPzjDhyHSujqWKAs9C5fBzMEuEr2z7A23kfLqBceH5uS9LJMiZ/yVKCwfpY9u2XyCjKdp7I\\u003d\",\"ephemeralPublicKey\":\"BAMDAtfgcPNuzItrwGLigGj3rtxmyHhZLwx1B4RJZ2oo11jpFf3SA6a3utryCMmlCEcqLfLn6WDH2ArrNBGn+Ew\\u003d\",\"tag\":\"T/qhZ/XY5/3Fe4QBKafm6NqS6EzwVeiKXhRlp8NeWrA\\u003d\"}"
      }
    },
    "type": "CARD",
    "info": {
      "cardNetwork": "MASTERCARD",
      "cardDetails": "5179"
    }
  }
}

Ознайомтесь з прикладом token з PaymentData нижче:

Приклад token з набору даних PaymentData, які повертаються від Google Pay

{
  "signature": "MEYCIQC+IHxUu9Wwra2Vu6tBa2wJPCMT3pWtN1VphLGYtNVLLwIhAOkdbNje//eLrXVc+n6LOlc4PqxWOUcqwrmki/CNA1ur",
  "intermediateSigningKey": 
    {
    "signedKey": "{
        \"keyValue\":\"MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEwhRrvGB0kZ1248MEJAPwX0YfrQInhyyRM7nyGFjQuzGSViZG3QC9NMvXR9Zd6uVcVzAz+6K/+NEGIWbX8zbk6A\\u003d\\u003d\",
        \"keyExpiration\":\"1571208568000\"
      }",
      "signatures": [
        "MEUCIQCR6vIEiyHB8qmlho4/tLd7W8CIGrZDJlCI48CBHeFPvQIgLZJIe4cZv6pYtYYa56QCI/vvg1GqXTP3bTBjO49r5mI="
      ]
    },
    "protocolVersion": "ECv2",
    "signedMessage": "{
      \"encryptedMessage\":\"k85CGUMmd5PaGmQlHFqHc0HrDZmjM1yG82rFB/p31ZyUleN5nihzjOZif/BKXwg3XA2oLXqBSSWcAdfZwXxCEOqvAQE+kpTC7qVO4wTPip6RruraT6vO9M9FtIf0kcqzYSAN7pl1SUA5jC9rHrqucPoh0/FSspup78SWBt8TnmVKC9O3sQhIZ3SMoGOG4mdjtIrgCwWH2cbrxUH0dHAqOe5ANGOY/mII4nTEp7xaKu41hK/kFE15zVyqgPJXP9bPxzMVk/ozEZSfhSzVTS+9stjkU/kT5EibKB3O1bbxyybKcGQ5vxBOtNOBKKd/NuqNmN2eEK3UbSKb1M3gv45gT9cCeEvlzO7Wg0N100vUBp9RPDN9TH4tj4w578sWFKfTi6FsSrZB27SGWcU0EaKHO9buo94mRBY5yqffF3bKg5mAMPzjDhyHSujqWKAs9C5fBzMEuEr2z7A23kfLqBceH5uS9LJMiZ/yVKCwfpY9u2XyCjKdp7I\\u003d\",
      \"ephemeralPublicKey\":\"BAMDAtfgcPNuzItrwGLigGj3rtxmyHhZLwx1B4RJZ2oo11jpFf3SA6a3utryCMmlCEcqLfLn6WDH2ArrNBGn+Ew\\u003d\",
      \"tag\":\"T/qhZ/XY5/3Fe4QBKafm6NqS6EzwVeiKXhRlp8NeWrA\\u003d\"
    }"
  }
}

Налаштуйте відправку отриманого значення token в параметрі payment_token у відповідному форматі вказаному нижче:

Приклад формату для передачі токена по API методу PSP Platon

'payment_token' => '{"signature": "MEYCIQC+IHxUu9Wwra2Vu6tBa2wJPCMT3pWtN1VphLGYtNVLLwIhAOkdbNje//eLrXVc+n6LOlc4PqxWOUcqwrmki/CNA1ur","intermediateSigningKey":{"signedKey":"{\\"keyValue\\":\\"MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAENGvh+0txlndYyWnenquCGqEXnG77IWDPuk6HiMvg6XXwBWGDItHJuXadYnnEtX5g20xo8DBP5LSWORqRqjI2vA\\\\u003d\\\\u003d\\",\\"keyExpiration\\":\\"1683710430000\\"}","signatures":["MEYCIQDovFtcqE7q4ahpEXBbKzbnxlCzn3lF+oeFKn4UbWT25QIhAN6KdqmVyobBKM9V4j2GPmDKs15nzo/r/ZrKd8+7d0SL"]},"protocolVersion":"ECv2","signedMessage":"{\\"encryptedMessage\\":\\"8AYy2FFX0mm+6w8gJZUr57PjQ5txXNaosVFUPHuo06ZhykABc4do4Lvrc5RxdSrGJNSqq6a9KGEnP2tLHdjecVxTn5oL2sSerxTmVLa99TqBW65cGBLV0bIX6sdNht2XBuWn7jFIzSxMO/ZmcdoNYc6w/MI1CFLNfINTkTNjVxszATDBmNfdMi+s2V3NpjM5xmEIZs3FFWZ401/1XeoDHnJfbjMO7GY3GHrMKEsOOQsnDGUBnvB4q9pf/0rsQ8X4VlHB2UMfUAwErgyLOb6gpGtVKESh59tyewKn14fkfSYsETUiVlUsu62PoP+gY141AFYexgAB8K7ygTX/hxwau2DEd+vb1Y9rR9cYXBZDgYlhBWoR1tCeZcMLjDKk8A0vUEzlKbI7fgsKLIa4GvqmPx79bTSrJJ2dZo1fq14ShI9fFk2Jitu6aoHMKwGcyKnC+UOGox/ArlojtHRCdKzu65vjn0M4yMZDmuww9A\\\\u003d\\\\u003d\\",\\"ephemeralPublicKey\\":\\"BMPEPyCUSrSIlz2lZHh9nmbjtobXwoTnMq/PFDDItLpHDDd0PsPoy1VP1XQSpqFUEvxiXXxL2BQ8FhUCzpR6yDQ\\\\u003d\\",\\"tag\\":\\"LG5PWsVF7lDLfEI3pwEi47OHKRGIz/f2FasGq64JlK8\\\\u003d\\"}"}',

API параметри

HTTP METHOD: POST

API ENDPOINT: https://secure.platononline.com/post/

Параметр	Значення	Опис	Особливості
`action` ОБОВ'ЯЗКОВИЙ	`GOOGLEPAY`	Код платіжного метода
`client_key` ОБОВ'ЯЗКОВИЙ	String	API ключ мерчанта	Ключ надається на пошту мерчанта
`order_id` ОБОВ'ЯЗКОВИЙ	String	ID оплати в системі мерчанта	Max 255 символи
`order_amount` ОБОВ'ЯЗКОВИЙ	Number	Сума оплати	Вірний варіант 1000.00 Невалідні варіанти 1000 1000.0 1,000.0 1,000.00
`order_currency` ОБОВ'ЯЗКОВИЙ	`UAH`	Валюта	Оплата можлива лише в національній валюті гривні
`order_description` ОБОВ'ЯЗКОВИЙ	String	Опис	Для кириличних символів необхідно використовувати формат UTF-8 Max 255 символів
`payment_token` ОБОВ'ЯЗКОВИЙ	String	Токен отриманий від Google	Токен необхідно відформатувати відповідно до прикладу вказаного вище.
`payer_ip` ОБОВ'ЯЗКОВИЙ	Number	IP-адреса платника	В форматі "ХХХ.ХХХ.ХХХ.ХХХ" IPv6 на даний момент не підтримується та при передачі поверне помилку
`payer_email` ОБОВ'ЯЗКОВИЙ	String	E-mail платника	Обов'язково валідна пошта. Відсутність пробілів. Max 256 символів
`payer_phone` ОБОВ'ЯЗКОВИЙ	Number	Номер телефона платника	Обов'язковий формат телефону 380…
`term_url_3ds` ОБОВ'ЯЗКОВИЙ	String	Посилання куди буде відправлено платника після спроби оплати	Max 255 символів
`hash` ОБОВ'ЯЗКОВИЙ	String	Контрольний підпис	md5( strtoupper( strrev($payer_email). $CLIENT_PASS. strrev($payment_token) ) )
`payer_first_name` НЕ ОБОВ'ЯЗКОВИЙ	String	Ім'я платника	Max 32 символи без пробілів
`payer_last_name` НЕ ОБОВ'ЯЗКОВИЙ	String	Прізвище платника	Max 32 символи без пробілів
`payer_middle_name` НЕ ОБОВ'ЯЗКОВИЙ	String	Отчество плательщика	Max 32 символи без пробілів
`payer_birth_date` НЕ ОБОВ'ЯЗКОВИЙ	String	Дата народження платника	В форматі “YYYY-MM-DD”
`payer_address` НЕ ОБОВ'ЯЗКОВИЙ	String	Адреса платника	Max 256 символів Вкажіть `NA`, якщо немає даних
`payer_country` НЕ ОБОВ'ЯЗКОВИЙ	String	Країна платника	Стандарт ISO 3166-1 alpha-2 В форматі "ХХ" 2 символа Вкажіть `NA`, якщо немає даних
`payer_state` НЕ ОБОВ'ЯЗКОВИЙ	String	Штат платника	Стандарт ISO 3166-2 В форматі "ХХ" 2 символа Вкажіть `NA`, якщо немає даних
`payer_city` НЕ ОБОВ'ЯЗКОВИЙ	String	Місто платника	Max 32 символи Вкажіть `NA`, якщо немає даних
`payer_zip` НЕ ОБОВ'ЯЗКОВИЙ	String	Поштовий індекс платника	Max 32 символи Вкажіть `NA`, якщо немає даних
`ext1`, `ext2`, `ext3`, `ext4`, `ext5`, `ext6`, `ext7`, `ext8`, `ext9`, `ext10` НЕ ОБОВ'ЯЗКОВИЙ	String	10 додаткових полів	Max 1024 символи в кажному ext полі
`channel_id` НЕ ОБОВ'ЯЗКОВИЙ	String	Додатковий платіжний канал	Дозволяє перенаправляти платежі на інший банківський термінал
`async` НЕ ОБОВ'ЯЗКОВИЙ	`Y` `N`	Включити асинхронний режим	В асинхронному режимі обов'язкове використання коллбеків. Стандартне значення `N`.
`auth` НЕ ОБОВ'ЯЗКОВИЙ	`Y` `N`	HOLD коштів на картці платника	Стандартне значення `N`.
`req_token` НЕ ОБОВ'ЯЗКОВИЙ	`Y` `N`	Для отримання `card_token`	Стандартне значення `N`.

Приклад запиту

Приклад запиту на PHP

Content-Type: form-data или x-www-form-urlencoded

<?php
  $CLIENT_PASS='***';
  $data['action']='GOOGLEPAY';
  $data['CLIENT_KEY']='***';
  $data['order_id']='Test_006';
  $data['order_amount']='0.51';
  $data['order_currency']='UAH';
  $data['order_description']='test';
  $data['payment_token']= '{"signature": "MEYCIQC+IHxUu9Wwra2Vu6tBa2wJPCMT3pWtN1VphLGYtNVLLwIhAOkdbNje//eLrXVc+n6LOlc4PqxWOUcqwrmki/CNA1ur","intermediateSigningKey":{"signedKey":"{\\\\"keyValue\\\\":\\\\"MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAE73Pk51MSGFgZ3Ul2K7rPNXNZDY886ybbDotCRXfNqaqyu3j4UAxu3rTPn6u9s2h+6eQfLWtQzZ+2IdA32zYUIw\\\\\\\\u003d\\\\\\\\u003d\\\\",\\\\"keyExpiration\\\\":\\\\"1683886728000\\\\"}","signatures":["MEYCIQChYMsPP6iE0EBWjN4yCaYutxJsXJwbQ241w21YZ1iI6AIhAI5u97+CSg04TTcZwGolxbcjs3I8J4srgIuXdbc7wKET"]},"protocolVersion":"ECv2","signedMessage":"{\\\\"encryptedMessage\\\\":\\\\"P/eXUyfiFgOFkvyBecknRUBbZEHZfLp59RViFryhOjz6Fx9AJ4VpsdstPI9/HFYeLiWMXw8kCXeoiJ0UQiUYmd/MklZt4LH6LySi3kLRxRp0Dbmh2OLpgfGBtbKzUOhlDAD4025OVfsG8Hwlrsvc3yCdFYiA3+w6rc12uAu9EBlAQv2nTJj6FHCIrOrwJ0FYjdk2hqXNKN/4CSBhxHoqITlYh8wX5EIqpHbnS73zp4aOvPgV8iPicnOxD1Cbr7OPZRqB2hUmWNeLv8ZSyQXLsVXLb5cQ5ZFLTcEdRWQrvwvZ43Fz5RHrBZGcVZmvCagLLh9euII4aVMVAfHepjmcWF1kOJdpvmygZnTfGx1MweSn8LEl8NM9mQh5eUy0yP/5R4/Egv8btC7uKxwmBuxuVoNd0DCeiShaUzx+AVVhdIHUytRIqllFFkbvf491ljpa6cWOQReuh3pYOCQ/cWSRNWXR2WiVtSOo0q47iH1AYGCsTyxpKq1Jcoq7ws1FJQEKy5ofZAcktdsmdDFtCnA6V/Pdzl7XWMIWbRrVXS2U\\\\",\\\\"ephemeralPublicKey\\\\":\\\\"BLD5aoQeQ1M51wRDphfxHNBuDa1i0hcbO+9rIeX8kfWGfM7Bm0Uzu1V6/jRWGttY6lq6c8Gqi4a4DvU1oE7zbw8\\\\\\\\u003d\\\\",\\\\"tag\\\\":\\\\"pP9Fo/JfuRGJw0gR7NbrqcRNx7TDvmnKj7Gq42FJmDA\\\\\\\\u003d\\\\"}"}';
  $data['payer_email']='sale@gmail.com';
  $data['term_url_3ds']='http://google.com';
  $hash = md5(
            strtoupper(
            strrev($data['payer_email']).
            $CLIENT_PASS.
            strrev($data['payment_token'])
            )
          );
?>

<!DOCTYPE html>
<html>
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
    <title>Payment</title>
  </head>
  <body onload="javascript:document.forms[0].submit()">
    <form action="https://secure.platononline.com/post/" method="post">
      <input type="hidden" name="action" value="<?=$data['action']?>" />
      <input type="hidden" name="client_key" value="<?=$data['CLIENT_KEY']?>" />
      <input type="hidden" name="order_id" value="<?=$data['order_id']?>" />
      <input type="hidden" name="order_amount" value="<?=$data['order_amount']?>" />
      <input type="hidden" name="order_currency" value="<?=$data['order_currency']?>" />
      <input type="hidden" name="order_description" value="<?=$data['order_description']?>" />
      <input type="hidden" name="payment_token" value="<?=$data['payment_token']?>" />
      <input type="hidden" name="payer_email" value="<?=$data['payer_email']?>" />
      <input type="hidden" name="term_url_3ds" value="<?=$data['term_url_3ds']?>" />
      <input type="hidden" name="hash" value="<?=$hash?>" />
    </form>
  </body>
</html>

Postman Collection

Тестування

Переведите environment в режим 'TEST’.

Используйте реальную карту подвязанную в Google Pay для оплаты.

При успешном тесте вы получите ответ о неуспешной транзакции (особенности тестового режима) и 'decline_reason' => 'Declined by processing'

Сообщите тех саппорту об успешном тесте и только после этого перейдите к активации бизнес-аккаунта Google.

Параметр environment в режим 'TEST’ оставить до указаний со стороны тех саппорта PSP Platon.

Проверка платежей

Полный список методов получения результата транзакции

Особистий кабінет PSP Platon

Всю необхідну інформацію ви знайдете в нашому особистому кабінеті за посиланням https://secure.platononline.net/auth/login

Подробиці

Інструкція по використанню

Інструкція до особистого кабінету PSP Platon

Помилки доступу в кабінет

Пароль для особистого кабінета актуальний 30 днів. В налаштуваннях кабінету є можливість змінити пароль до кінця терміну його дії, а також нотифікація в останні 10 днів перед закінченням терміну дії старого паролю.

Якщо пароль було втрачено або протерміновано і доступ в кабінет заблоковано, будь ласка, зверніться в груповий чат вказавши логін та email для відправки нового пароля.

Callback и Response

Особенности работы с Callback

URL для Callback

Для отримання Callback відправте URL на ваш обробник в груповий чат з вказанням API ключа для якого потрібно прописати посилання. Посилання для Callback вказується на боці PSP Platon.

IP адреси

Callback будуть надходити з IP:
78.140.172.231
78.140.135.130
167.99.253.235
62.113.223.114
62.113.223.116
212.83.61.161
185.172.90.66
185.172.90.74
185.172.90.75
185.172.90.115
185.172.90.119

Очікувана відповідь на Callback

Після відправки Callback у відповідь PSP Platon має отримати HTTP код 200.

Помилки при відправці Callback

Якщо Callback не вдалося відправити або було отримано не HTTP код 200, будуть проведені додаткові повторні спроби відправки в проміжках часу 1 хв, 5 хв, 10 хв, 15 хв, 30 хв, 60 хв.

Перевідправка Callback

Для перевідправки Callback прохання повідомити в груповий чат список необхідних ордерів.

Безопасность

Увага! Рекоменлації цього розділу допоможуть запезпечити безпеку від шахрайських дій пов'язаних з вашим сайтом та транзакціями.

Довірені IP

Для забезпечення додаткової безпеки рекомендуємо опціонально додати в білий список доступів POST запити тільки з наших довірених IP:
78.140.172.231
78.140.135.130
167.99.253.235
62.113.223.114
62.113.223.116
212.83.61.161
185.172.90.66
185.172.90.74
185.172.90.75
185.172.90.115
185.172.90.119

Секретність API доступів

Не тримайте у відкритому доступі API ключ та API пароль, а також не надавайте обидва ці параметри в групові робочі чати, в тому числі з нами. Для перевірки деталей представники PSP Platon можуть попросити у вас лише API ключ, пароль треба тримати в таємниці.

Секретність кабінету

Не розголошуйте логін та пароль від вашого особистого кабінету третім особам. У випадку якщо доступ був втрачений зверніться в груповий чат. Пароль від особистого кабінету діє 30 днів. Рекомендуємо оновлювати пароль до закінчення терміну дії в 30 днів.

Секретність посилання для Callback

Не залишайте посилання для Callback у відкритому доступі на вашому ресурсі.

Сторінка успішної оплати не гарантія успіху оплати

Не використовуйте факт переходу платника на сторінку успіщної оплати як признак успішної оплати. Статус транзакції та деталі оплати необхідно отримати тільки в Callback або в особистому кабінеті PSP Platon.

Звірка даних в Callback

При отриманні від нас Callback про успішну оплату рекомендуємо проводити на вашому боці додаткову перевірку суми та ордера з Callback на відповідність первоначальної суми та ордера у вашій базі даних, які були вказані при створенні замовлення.

Синхронный режим:

Данный режим работает по умолчанию. Передавать async = N не нужно.

Асинхронный режим:

Данный режим активируется при передаче async = Y. В этом режиме обязательно необходимо принимать callback на ваш callback url.

При оплаті з 3DS СИНХРОННИЙ РЕЖИМ

Промежуточный редирект плательщика на 3DS СИНХРОННИЙ РЕЖИМ

Промежуточный Response при наличии 3DS проверки

{
  "action": "SALE",
  "result": "REDIRECT",
  "status": "3DS",
  "trans_id": "03346-89225-87891",
  "order_id": "ORDER-12345",
  "trans_date": "2012-04-0316:02:02",
  "redirect_url": "https://server_3ds.com/3ds.php",
  "redirect_params": {
    "PaReq": "bc5865698ae46de4eba4c51f0359a714",
    "MD": "111111111111111111111",
    "TermUrl": "https://term_url.com/3ds/67c14e5?trans_id=03346-89225-87891&hash=8b98db60fb3c24c14a6d7075241da38b"
  },
  "redirect_method": "POST"
}

Параметры	Описание
`action` ОБЯЗАТЕЛЬНО	`SALE`
`result` ОБЯЗАТЕЛЬНО	`REDIRECT`
`status` ОБЯЗАТЕЛЬНО	`3DS`
`order_id` ОБЯЗАТЕЛЬНО	ID транзакции в системе мерчанта
`trans_id` ОБЯЗАТЕЛЬНО	ID транзакции в платежной системе
`trans_date` ОБЯЗАТЕЛЬНО	Дата транзакции в платежной системе. Время UTC
`redirect_url` ОБЯЗАТЕЛЬНО	URL, на который должен быть перенаправлен плательщик
`redirect_params` ОБЯЗАТЕЛЬНО	Массив определенных параметров 3DS
`redirect_method` ОБЯЗАТЕЛЬНО	`POST` Метод передачи параметров

Промежуточный Callback при наличии проверки 3DS

array (
  'action' => 'SALE',
  'result' => 'REDIRECT',
  'status' => '3DS',
  'order_id' => '6b51033e-3e58-42e0-8ec3-88c97388018b',
  'trans_id' => '28738-47774-55067',
  'trans_date' => '2020-04-20 12:12:57',
  'redirect_url' => 'https://acs.privatbank.ua/pPaReqMC.jsp',
  'redirect_params' => 
    array (
      'PaReq' => 'eJxVUllu2zAQvYqg/4qUIlFUMGYgxykaoEqN2j4AIxGxUi2Olsb+K/qTG+S3VygKpGhRtL0CdaMMHWUDSHDeLJw3Cxxty8L6rJo2r6uJ7TrUtlSV1lleXUzs1fLtG24fCViuG6VmC5X2jRKQqLaVF8rKs4k9lx/VlRvw8ID7YRhFYcgDHrmeF/KQc8apG/jcFjCP0U/AmElgIscD8gjxyyZdy6oTINOr6emZwCgWcCAjhFI1pzPBXB66jAF5gFDJUolpPF29P1k4xx8SZxUD2Sshrfuqa3aCUx/II4C+KcS66zbtISGbQnZ1VeSVctK6BGJsQJ6ZzHsjtfjXNs9EMouv8e7w0uQy3p4t6HWy/IT4ZALEeEAmOyU86lHqe9RyvUM8QQRkrwdZGhKmcoplPQDYmBzxaDGGlwrAdjc4jZ2IOJqeEKjtpq4UemALn2TIVJsK/U3fDV/0nf4x3OL7b7jRf/Uv/dvS//Uf/X34Otzqn9a5PO8L1Zq6nV4iQxMK5Lni43dmEmmHTfZdN2CMMz/wzTj2OsMgx356B5TtKRgAxESRcdJk3BKUXm3PPfYf2CM=',
      'TermUrl' => 'https://secure.platononline.com/3ds/4de0025?operation_type=purchase&trans_id=28738-47774-55067&hash=***************************************************
    ),
  'redirect_method' => 'POST',
  'hash' => '********************************',
)

Параметры	Описание
`action` ОБЯЗАТЕЛЬНО	`SALE`
`result` ОБЯЗАТЕЛЬНО	`REDIRECT`
`status` ОБЯЗАТЕЛЬНО	`3DS`
`order_id` ОБЯЗАТЕЛЬНО	ID транзакции в системе мерчанта
`trans_id` ОБЯЗАТЕЛЬНО	ID транзакции в платежной системе
`trans_date` ОБЯЗАТЕЛЬНО	Дата транзакции в платежной системе. Время UTC
`redirect_url` ОБЯЗАТЕЛЬНО	URL, на который должен быть перенаправлен плательщик
`redirect_params` ОБЯЗАТЕЛЬНО	Строка параметров
`redirect_method` ОБЯЗАТЕЛЬНО	`POST` Метод передачи параметров
`hash` ОБЯЗАТЕЛЬНО	Зашифрованная подпись для проверки достоверности коллбека md5( strtoupper( strrev(email). CLIENT_PASS. strrev(payment_token) ) ) Внимание! Если при запросе на оплату не был указан `email`, то при проверке `hash` в подписи Callback следует указать пустое значение для `email`.

При успішній оплаті з 3DS СИНХРОННИЙ РЕЖИМ

Response про фінальний статус при оплаті з 3DS відсутній.

Callback при успешном списании

array (
  'action' => 'SALE',
  'result' => 'SUCCESS',
  'status' => 'SETTLED',
  'order_id' => '1_691201',
  'trans_id' => '31176-65336-00444',
  'trans_date' => '2021-01-27 16:55:33',
  'descriptor' => NULL,
  'auth_code' => '990647',
  'hash' => '********************************',
)

Параметры	Описание
`action` ОБЯЗАТЕЛЬНО	`SALE`
`result` ОБЯЗАТЕЛЬНО	`SUCCESS`
`status` ОБЯЗАТЕЛЬНО	`SETTLED` `PENDING` только когда было указано `auth` = `Y`
`order_id` ОБЯЗАТЕЛЬНО	ID транзакции в системе мерчанта
`trans_id` ОБЯЗАТЕЛЬНО	ID транзакции в платежной системе
`trans_date` ОБЯЗАТЕЛЬНО	Дата транзакции в платежной системе. Время UTC
`descriptor` ОБЯЗАТЕЛЬНО	Это строка, которую владелец кредитной карты увидит в выписка из банка. В большинстве случаев это веб-сайт поддержки клиентов.
`auth_code` ОБЯЗАТЕЛЬНО	Код авторизации от банка
`amount` ОПЦИОНАЛЬНО	Сумма транзакции Поле опционально и по умолчанию выключено. Для включения просьба написать запрос в ваш групповой чат.
`ext1`, `ext2`, `ext3`, `ext4`, `ext5`, `ext6`, `ext7`, `ext8`, `ext9`, `ext10` ОПЦИОНАЛЬНО	10 дополнительных полей Поля опционально и по умолчанию выключены. Для включения просьба написать запрос в ваш групповой чат.
`MID` ОПЦИОНАЛЬНО	Уникальный идентификатор банковского терминала PSP Paton. Под каждый платежный метод и мерчанта свой идентификатор. Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`card` ОПЦИОНАЛЬНО	Маска карты в формате ХХХХХХ****ХХХХ Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`card_hash` ОПЦИОНАЛЬНО	Уникальное зашифрованное значение номера карты, которое будет возвращаться в коллбеке при оплате, верификации, погашении и выплате средств на карту. Этот параметр даст вам возможность в вашей системе: Привязать карту под клиента. Проверить не использовал ли другой клиент эту же карту. Проверить какие кредиты, товары и услуги погашаются данной картой. Отслеживать мошенничество, когда клиент использует ту же карту с другого аккаунта, например, чтобы повторно воспользоваться акцией. Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`brand` ОПЦИОНАЛЬНО	`'brand' => 'VISA'` `'brand' => 'MASTER'` `'brand" => 'PROSTIR'` Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`fee_type` ОПЦИОНАЛЬНО	Признак каким образом взимается комиссия: `ACT` - по актам. `TRANSACTION` - потранзакционно. Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`fee` ОПЦИОНАЛЬНО	Сумма комиссии с мерчанта по транзакции в ГРН Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`currency` ОПЦИОНАЛЬНО	Валюта операции Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`hash` ОБЯЗАТЕЛЬНО	Зашифрованная подпись для проверки достоверности коллбека md5( strtoupper( strrev(email). client_pass. trans_id. strrev( substr(card,0,6). substr(card,-4) ) ) ) Внимание! Если при запросе на оплату не был указан `email`, то при проверке `hash` в подписи Callback следует указать пустое значение для `email`.

При неуспешной оплате з 3DS СИНХРОННИЙ РЕЖИМ

Response про фінальний статус при оплаті з 3DS відсутній.

Callback при неуспешном списании

array (
  'action' => 'SALE',
  'result' => 'DECLINED',
  'status' => 'DECLINED',
  'order_id' => '1_691201',
  'trans_id' => '31176-65336-00444',
  'trans_date' => '2021-01-27 16:55:33',
  'decline_reason' => 'Declined by processing',
  'hash' => '********************************',
)

Параметры	Описание
`action` ОБЯЗАТЕЛЬНО	`SALE`
`result` ОБЯЗАТЕЛЬНО	`DECLINED`
`status` ОБЯЗАТЕЛЬНО	`DECLINED`
`order_id` ОБЯЗАТЕЛЬНО	ID транзакции в системе мерчанта
`trans_id` ОБЯЗАТЕЛЬНО	ID транзакции в платежной системе
`trans_date` ОБЯЗАТЕЛЬНО	Дата транзакции в платежной системе. Время UTC
`amount` ОПЦИОНАЛЬНО	Сумма транзакции Поле опционально и по умолчанию выключено. Для включения просьба написать запрос в ваш групповой чат.
`ext1`, `ext2`, `ext3`, `ext4`, `ext5`, `ext6`, `ext7`, `ext8`, `ext9`, `ext10` ОПЦИОНАЛЬНО	10 дополнительных полей Поля опционально и по умолчанию выключены. Для включения просьба написать запрос в ваш групповой чат.
`MID` ОПЦИОНАЛЬНО	Уникальный идентификатор банковского терминала PSP Paton. Под каждый платежный метод и мерчанта свой идентификатор. Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`card` ОПЦИОНАЛЬНО	Маска карты в формате ХХХХХХ****ХХХХ Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`card_hash` ОПЦИОНАЛЬНО	Уникальное зашифрованное значение номера карты, которое будет возвращаться в коллбеке при оплате, верификации, погашении и выплате средств на карту. Этот параметр даст вам возможность в вашей системе: Привязать карту под клиента. Проверить не использовал ли другой клиент эту же карту. Проверить какие кредиты, товары и услуги погашаются данной картой. Отслеживать мошенничество, когда клиент использует ту же карту с другого аккаунта, например, чтобы повторно воспользоваться акцией. Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`brand` ОПЦИОНАЛЬНО	`'brand' => 'VISA'` `'brand' => 'MASTER'` `'brand" => 'PROSTIR'` Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`fee_type` ОПЦИОНАЛЬНО	Признак каким образом взимается комиссия: `ACT` - по актам. `TRANSACTION` - потранзакционно. Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`fee` ОПЦИОНАЛЬНО	Сумма комиссии с мерчанта по транзакции в ГРН Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`currency` ОПЦИОНАЛЬНО	Валюта операции Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`decline_reason` ОБЯЗАТЕЛЬНО	Причина, по которой транзакция была отклонена
`hash` ОБЯЗАТЕЛЬНО	Зашифрованная подпись для проверки достоверности коллбека md5( strtoupper( strrev(email). client_pass. trans_id. strrev( substr(card,0,6). substr(card,-4) ) ) ) Внимание! Если при запросе на оплату не был указан `email`, то при проверке `hash` в подписи Callback следует указать пустое значение для `email`.

При оплаті з 3DS АСИНХРОННИЙ РЕЖИМ

Промежуточный ответ АСИНХРОННИЙ РЕЖИМ

Response о принятии запроса в обработку

{
  "action": "SALE",
  "result": "ACCEPTED",
  "trans_id": "03346-89211-86461",
  "order_id": "ORDER-12345",
  "trans_date": "2012-04-03 16:02:01"
}

Параметры	Описание
`action` ОБЯЗАТЕЛЬНО	`SALE`
`result` ОБЯЗАТЕЛЬНО	`ACCEPTED`
`order_id` ОБЯЗАТЕЛЬНО	ID транзакции в системе мерчанта
`trans_id` ОБЯЗАТЕЛЬНО	ID транзакции в платежной системе
`trans_date` ОБЯЗАТЕЛЬНО	Дата транзакции в платежной системе. Время UTC

Промежуточный редирект плательщика на 3DS АСИНХРОННИЙ РЕЖИМ

Промежуточный Callback при наличии проверки 3DS

array (
  'action' => 'SALE',
  'result' => 'REDIRECT',
  'status' => '3DS',
  'order_id' => '6b51033e-3e58-42e0-8ec3-88c97388018b',
  'trans_id' => '28738-47774-55067',
  'trans_date' => '2020-04-20 12:12:57',
  'redirect_url' => 'https://acs.privatbank.ua/pPaReqMC.jsp',
  'redirect_params' => 
    array (
      'PaReq' => 'eJxVUllu2zAQvYqg/4qUIlFUMGYgxykaoEqN2j4AIxGxUi2Olsb+K/qTG+S3VygKpGhRtL0CdaMMHWUDSHDeLJw3Cxxty8L6rJo2r6uJ7TrUtlSV1lleXUzs1fLtG24fCViuG6VmC5X2jRKQqLaVF8rKs4k9lx/VlRvw8ID7YRhFYcgDHrmeF/KQc8apG/jcFjCP0U/AmElgIscD8gjxyyZdy6oTINOr6emZwCgWcCAjhFI1pzPBXB66jAF5gFDJUolpPF29P1k4xx8SZxUD2Sshrfuqa3aCUx/II4C+KcS66zbtISGbQnZ1VeSVctK6BGJsQJ6ZzHsjtfjXNs9EMouv8e7w0uQy3p4t6HWy/IT4ZALEeEAmOyU86lHqe9RyvUM8QQRkrwdZGhKmcoplPQDYmBzxaDGGlwrAdjc4jZ2IOJqeEKjtpq4UemALn2TIVJsK/U3fDV/0nf4x3OL7b7jRf/Uv/dvS//Uf/X34Otzqn9a5PO8L1Zq6nV4iQxMK5Lni43dmEmmHTfZdN2CMMz/wzTj2OsMgx356B5TtKRgAxESRcdJk3BKUXm3PPfYf2CM=',
      'TermUrl' => 'https://secure.platononline.com/3ds/4de0025?operation_type=purchase&trans_id=28738-47774-55067&hash=***************************************************
    ),
  'redirect_method' => 'POST',
  'hash' => '********************************',
)

Параметры	Описание
`action` ОБЯЗАТЕЛЬНО	`SALE`
`result` ОБЯЗАТЕЛЬНО	`REDIRECT`
`status` ОБЯЗАТЕЛЬНО	`3DS`
`order_id` ОБЯЗАТЕЛЬНО	ID транзакции в системе мерчанта
`trans_id` ОБЯЗАТЕЛЬНО	ID транзакции в платежной системе
`trans_date` ОБЯЗАТЕЛЬНО	Дата транзакции в платежной системе. Время UTC
`redirect_url` ОБЯЗАТЕЛЬНО	URL, на который должен быть перенаправлен плательщик
`redirect_params` ОБЯЗАТЕЛЬНО	Строка параметров
`redirect_method` ОБЯЗАТЕЛЬНО	`POST` Метод передачи параметров
`hash` ОБЯЗАТЕЛЬНО	Зашифрованная подпись для проверки достоверности коллбека md5( strtoupper( strrev(email). CLIENT_PASS. strrev(payment_token) ) ) Внимание! Если при запросе на оплату не был указан `email`, то при проверке `hash` в подписи Callback следует указать пустое значение для `email`.

При успешной оплате АСИНХРОННИЙ РЕЖИМ

Callback при успешном списании

array (
  'action' => 'SALE',
  'result' => 'SUCCESS',
  'status' => 'SETTLED',
  'order_id' => '1_691201',
  'trans_id' => '31176-65336-00444',
  'trans_date' => '2021-01-27 16:55:33',
  'descriptor' => NULL,
  'auth_code' => '990647',
  'hash' => '********************************',
)

Параметры	Описание
`action` ОБЯЗАТЕЛЬНО	`SALE`
`result` ОБЯЗАТЕЛЬНО	`SUCCESS`
`status` ОБЯЗАТЕЛЬНО	`SETTLED` `PENDING` только когда было указано `auth` = `Y`
`order_id` ОБЯЗАТЕЛЬНО	ID транзакции в системе мерчанта
`trans_id` ОБЯЗАТЕЛЬНО	ID транзакции в платежной системе
`trans_date` ОБЯЗАТЕЛЬНО	Дата транзакции в платежной системе. Время UTC
`descriptor` ОБЯЗАТЕЛЬНО	Это строка, которую владелец кредитной карты увидит в выписка из банка. В большинстве случаев это веб-сайт поддержки клиентов.
`auth_code` ОБЯЗАТЕЛЬНО	Код авторизации от банка
`amount` ОПЦИОНАЛЬНО	Сумма транзакции Поле опционально и по умолчанию выключено. Для включения просьба написать запрос в ваш групповой чат.
`ext1`, `ext2`, `ext3`, `ext4`, `ext5`, `ext6`, `ext7`, `ext8`, `ext9`, `ext10` ОПЦИОНАЛЬНО	10 дополнительных полей Поля опционально и по умолчанию выключены. Для включения просьба написать запрос в ваш групповой чат.
`MID` ОПЦИОНАЛЬНО	Уникальный идентификатор банковского терминала PSP Paton. Под каждый платежный метод и мерчанта свой идентификатор. Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`card` ОПЦИОНАЛЬНО	Маска карты в формате ХХХХХХ****ХХХХ Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`card_hash` ОПЦИОНАЛЬНО	Уникальное зашифрованное значение номера карты, которое будет возвращаться в коллбеке при оплате, верификации, погашении и выплате средств на карту. Этот параметр даст вам возможность в вашей системе: Привязать карту под клиента. Проверить не использовал ли другой клиент эту же карту. Проверить какие кредиты, товары и услуги погашаются данной картой. Отслеживать мошенничество, когда клиент использует ту же карту с другого аккаунта, например, чтобы повторно воспользоваться акцией. Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`brand` ОПЦИОНАЛЬНО	`'brand' => 'VISA'` `'brand' => 'MASTER'` `'brand" => 'PROSTIR'` Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`fee_type` ОПЦИОНАЛЬНО	Признак каким образом взимается комиссия: `ACT` - по актам. `TRANSACTION` - потранзакционно. Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`fee` ОПЦИОНАЛЬНО	Сумма комиссии с мерчанта по транзакции в ГРН Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`currency` ОПЦИОНАЛЬНО	Валюта операции Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`hash` ОБЯЗАТЕЛЬНО	Зашифрованная подпись для проверки достоверности коллбека md5( strtoupper( strrev(email). client_pass. trans_id. strrev( substr(card,0,6). substr(card,-4) ) ) ) Внимание! Если при запросе на оплату не был указан `email`, то при проверке `hash` в подписи Callback следует указать пустое значение для `email`.

При неуспешной оплате з 3DS АСИНХРОННИЙ РЕЖИМ

Callback при неуспешном списании

array (
  'action' => 'SALE',
  'result' => 'DECLINED',
  'status' => 'DECLINED',
  'order_id' => '1_691201',
  'trans_id' => '31176-65336-00444',
  'trans_date' => '2021-01-27 16:55:33',
  'decline_reason' => 'Declined by processing',
  'hash' => '********************************',
)

Параметры	Описание
`action` ОБЯЗАТЕЛЬНО	`SALE`
`result` ОБЯЗАТЕЛЬНО	`DECLINED`
`status` ОБЯЗАТЕЛЬНО	`DECLINED`
`order_id` ОБЯЗАТЕЛЬНО	ID транзакции в системе мерчанта
`trans_id` ОБЯЗАТЕЛЬНО	ID транзакции в платежной системе
`trans_date` ОБЯЗАТЕЛЬНО	Дата транзакции в платежной системе. Время UTC
`amount` ОПЦИОНАЛЬНО	Сумма транзакции Поле опционально и по умолчанию выключено. Для включения просьба написать запрос в ваш групповой чат.
`ext1`, `ext2`, `ext3`, `ext4`, `ext5`, `ext6`, `ext7`, `ext8`, `ext9`, `ext10` ОПЦИОНАЛЬНО	10 дополнительных полей Поля опционально и по умолчанию выключены. Для включения просьба написать запрос в ваш групповой чат.
`MID` ОПЦИОНАЛЬНО	Уникальный идентификатор банковского терминала PSP Paton. Под каждый платежный метод и мерчанта свой идентификатор. Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`card` ОПЦИОНАЛЬНО	Маска карты в формате ХХХХХХ****ХХХХ Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`card_hash` ОПЦИОНАЛЬНО	Уникальное зашифрованное значение номера карты, которое будет возвращаться в коллбеке при оплате, верификации, погашении и выплате средств на карту. Этот параметр даст вам возможность в вашей системе: Привязать карту под клиента. Проверить не использовал ли другой клиент эту же карту. Проверить какие кредиты, товары и услуги погашаются данной картой. Отслеживать мошенничество, когда клиент использует ту же карту с другого аккаунта, например, чтобы повторно воспользоваться акцией. Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`brand` ОПЦИОНАЛЬНО	`'brand' => 'VISA'` `'brand' => 'MASTER'` `'brand" => 'PROSTIR'` Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`fee_type` ОПЦИОНАЛЬНО	Признак каким образом взимается комиссия: `ACT` - по актам. `TRANSACTION` - потранзакционно. Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`fee` ОПЦИОНАЛЬНО	Сумма комиссии с мерчанта по транзакции в ГРН Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`currency` ОПЦИОНАЛЬНО	Валюта операции Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`decline_reason` ОБЯЗАТЕЛЬНО	Причина, по которой транзакция была отклонена
`hash` ОБЯЗАТЕЛЬНО	Зашифрованная подпись для проверки достоверности коллбека md5( strtoupper( strrev(email). client_pass. trans_id. strrev( substr(card,0,6). substr(card,-4) ) ) ) Внимание! Если при запросе на оплату не был указан `email`, то при проверке `hash` в подписи Callback следует указать пустое значение для `email`.

При ошибке в запросе

Response в случая ошибки в запросе

{
  "result": "ERROR",
  "error_message": "Error description"
}

При оплаті без 3DS СИНХРОННИЙ РЕЖИМ

При успешной оплате СИНХРОННИЙ РЕЖИМ

Response при успешном списании

{
  "action": "SALE",
  "result": "SUCCESS",
  "status": "SETTLED",
  "trans_id": "03346-89217-70541",
  "order_id": "ORDER-12345",
  "descriptor": "test",
  "trans_date": "2012-04-03 16:02:01"
}

Параметры	Описание
`action` ОБЯЗАТЕЛЬНО	`SALE`
`result` ОБЯЗАТЕЛЬНО	`SUCCESS`
`status` ОБЯЗАТЕЛЬНО	`SETTLED` `PENDING` только когда было указано `auth` = `Y`
`order_id` ОБЯЗАТЕЛЬНО	ID транзакции в системе мерчанта
`trans_id` ОБЯЗАТЕЛЬНО	ID транзакции в платежной системе
`trans_date` ОБЯЗАТЕЛЬНО	Дата транзакции в платежной системе. Время UTC
`descriptor` ОБЯЗАТЕЛЬНО	Это строка, которую владелец кредитной карты увидит в выписка из банка. В большинстве случаев это веб-сайт поддержки клиентов.
`amount` ОПЦИОНАЛЬНО	Сумма транзакции Поле опционально и по умолчанию выключено. Для включения просьба написать запрос в ваш групповой чат.
`ext1`, `ext2`, `ext3`, `ext4`, `ext5`, `ext6`, `ext7`, `ext8`, `ext9`, `ext10` ОПЦИОНАЛЬНО	10 дополнительных полей Поля опционально и по умолчанию выключены. Для включения просьба написать запрос в ваш групповой чат.
`MID` ОПЦИОНАЛЬНО	Уникальный идентификатор банковского терминала PSP Paton. Под каждый платежный метод и мерчанта свой идентификатор. Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`card` ОПЦИОНАЛЬНО	Маска карты в формате ХХХХХХ****ХХХХ Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`card_hash` ОПЦИОНАЛЬНО	Уникальное зашифрованное значение номера карты, которое будет возвращаться в коллбеке при оплате, верификации, погашении и выплате средств на карту. Этот параметр даст вам возможность в вашей системе: Привязать карту под клиента. Проверить не использовал ли другой клиент эту же карту. Проверить какие кредиты, товары и услуги погашаются данной картой. Отслеживать мошенничество, когда клиент использует ту же карту с другого аккаунта, например, чтобы повторно воспользоваться акцией. Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`brand` ОПЦИОНАЛЬНО	`'brand' => 'VISA'` `'brand' => 'MASTER'` `'brand" => 'PROSTIR'` Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`fee_type` ОПЦИОНАЛЬНО	Признак каким образом взимается комиссия: `ACT` - по актам. `TRANSACTION` - потранзакционно. Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`fee` ОПЦИОНАЛЬНО	Сумма комиссии с мерчанта по транзакции в ГРН Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`currency` ОПЦИОНАЛЬНО	Валюта операции Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.

Callback при успешном списании

array (
  'action' => 'SALE',
  'result' => 'SUCCESS',
  'status' => 'SETTLED',
  'order_id' => '1_691201',
  'trans_id' => '31176-65336-00444',
  'trans_date' => '2021-01-27 16:55:33',
  'descriptor' => NULL,
  'auth_code' => '990647',
  'hash' => '********************************',
)

Параметры	Описание
`action` ОБЯЗАТЕЛЬНО	`SALE`
`result` ОБЯЗАТЕЛЬНО	`SUCCESS`
`status` ОБЯЗАТЕЛЬНО	`SETTLED` `PENDING` только когда было указано `auth` = `Y`
`order_id` ОБЯЗАТЕЛЬНО	ID транзакции в системе мерчанта
`trans_id` ОБЯЗАТЕЛЬНО	ID транзакции в платежной системе
`trans_date` ОБЯЗАТЕЛЬНО	Дата транзакции в платежной системе. Время UTC
`descriptor` ОБЯЗАТЕЛЬНО	Это строка, которую владелец кредитной карты увидит в выписка из банка. В большинстве случаев это веб-сайт поддержки клиентов.
`auth_code` ОБЯЗАТЕЛЬНО	Код авторизации от банка
`amount` ОПЦИОНАЛЬНО	Сумма транзакции Поле опционально и по умолчанию выключено. Для включения просьба написать запрос в ваш групповой чат.
`ext1`, `ext2`, `ext3`, `ext4`, `ext5`, `ext6`, `ext7`, `ext8`, `ext9`, `ext10` ОПЦИОНАЛЬНО	10 дополнительных полей Поля опционально и по умолчанию выключены. Для включения просьба написать запрос в ваш групповой чат.
`MID` ОПЦИОНАЛЬНО	Уникальный идентификатор банковского терминала PSP Paton. Под каждый платежный метод и мерчанта свой идентификатор. Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`card` ОПЦИОНАЛЬНО	Маска карты в формате ХХХХХХ****ХХХХ Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`card_hash` ОПЦИОНАЛЬНО	Уникальное зашифрованное значение номера карты, которое будет возвращаться в коллбеке при оплате, верификации, погашении и выплате средств на карту. Этот параметр даст вам возможность в вашей системе: Привязать карту под клиента. Проверить не использовал ли другой клиент эту же карту. Проверить какие кредиты, товары и услуги погашаются данной картой. Отслеживать мошенничество, когда клиент использует ту же карту с другого аккаунта, например, чтобы повторно воспользоваться акцией. Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`brand` ОПЦИОНАЛЬНО	`'brand' => 'VISA'` `'brand' => 'MASTER'` `'brand" => 'PROSTIR'` Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`fee_type` ОПЦИОНАЛЬНО	Признак каким образом взимается комиссия: `ACT` - по актам. `TRANSACTION` - потранзакционно. Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`fee` ОПЦИОНАЛЬНО	Сумма комиссии с мерчанта по транзакции в ГРН Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`currency` ОПЦИОНАЛЬНО	Валюта операции Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`hash` ОБЯЗАТЕЛЬНО	Зашифрованная подпись для проверки достоверности коллбека md5( strtoupper( strrev(email). client_pass. trans_id. strrev( substr(card,0,6). substr(card,-4) ) ) ) Внимание! Если при запросе на оплату не был указан `email`, то при проверке `hash` в подписи Callback следует указать пустое значение для `email`.

При неуспешной оплате СИНХРОННИЙ РЕЖИМ

Response при неуспешном списании

{
  "action": "SALE",
  "result": "DECLINED",
  "status": "DECLINED",
  "trans_id": "03346-89214-54141",
  "order_id": "ORDER-12345",
  "trans_date": "2012-04-0316:02:01",
  "decline_reason": "Declined by processing"
}

Параметры	Описание
`action` ОБЯЗАТЕЛЬНО	`SALE`
`result` ОБЯЗАТЕЛЬНО	`DECLINED`
`status` ОБЯЗАТЕЛЬНО	`DECLINED`
`order_id` ОБЯЗАТЕЛЬНО	ID транзакции в системе мерчанта
`trans_id` ОБЯЗАТЕЛЬНО	ID транзакции в платежной системе
`amount` ОПЦИОНАЛЬНО	Сумма транзакции Поле опционально и по умолчанию выключено. Для включения просьба написать запрос в ваш групповой чат.
`ext1`, `ext2`, `ext3`, `ext4`, `ext5`, `ext6`, `ext7`, `ext8`, `ext9`, `ext10` ОПЦИОНАЛЬНО	10 дополнительных полей Поля опционально и по умолчанию выключены. Для включения просьба написать запрос в ваш групповой чат.
`MID` ОПЦИОНАЛЬНО	Уникальный идентификатор банковского терминала PSP Paton. Под каждый платежный метод и мерчанта свой идентификатор. Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`card` ОПЦИОНАЛЬНО	Маска карты в формате ХХХХХХ****ХХХХ Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`card_hash` ОПЦИОНАЛЬНО	Уникальное зашифрованное значение номера карты, которое будет возвращаться в коллбеке при оплате, верификации, погашении и выплате средств на карту. Этот параметр даст вам возможность в вашей системе: Привязать карту под клиента. Проверить не использовал ли другой клиент эту же карту. Проверить какие кредиты, товары и услуги погашаются данной картой. Отслеживать мошенничество, когда клиент использует ту же карту с другого аккаунта, например, чтобы повторно воспользоваться акцией. Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`brand` ОПЦИОНАЛЬНО	`'brand' => 'VISA'` `'brand' => 'MASTER'` `'brand" => 'PROSTIR'` Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`fee_type` ОПЦИОНАЛЬНО	Признак каким образом взимается комиссия: `ACT` - по актам. `TRANSACTION` - потранзакционно. Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`fee` ОПЦИОНАЛЬНО	Сумма комиссии с мерчанта по транзакции в ГРН Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`currency` ОПЦИОНАЛЬНО	Валюта операции Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`trans_date` ОБЯЗАТЕЛЬНО	Дата транзакции в платежной системе. Время UTC
`decline_reason` ОБЯЗАТЕЛЬНО	Причина, по которой транзакция была отклонена

Callback при неуспешном списании

array (
  'action' => 'SALE',
  'result' => 'DECLINED',
  'status' => 'DECLINED',
  'order_id' => '1_691201',
  'trans_id' => '31176-65336-00444',
  'trans_date' => '2021-01-27 16:55:33',
  'decline_reason' => 'Declined by processing',
  'hash' => '********************************',
)

Параметры	Описание
`action` ОБЯЗАТЕЛЬНО	`SALE`
`result` ОБЯЗАТЕЛЬНО	`DECLINED`
`status` ОБЯЗАТЕЛЬНО	`DECLINED`
`order_id` ОБЯЗАТЕЛЬНО	ID транзакции в системе мерчанта
`trans_id` ОБЯЗАТЕЛЬНО	ID транзакции в платежной системе
`trans_date` ОБЯЗАТЕЛЬНО	Дата транзакции в платежной системе. Время UTC
`amount` ОПЦИОНАЛЬНО	Сумма транзакции Поле опционально и по умолчанию выключено. Для включения просьба написать запрос в ваш групповой чат.
`ext1`, `ext2`, `ext3`, `ext4`, `ext5`, `ext6`, `ext7`, `ext8`, `ext9`, `ext10` ОПЦИОНАЛЬНО	10 дополнительных полей Поля опционально и по умолчанию выключены. Для включения просьба написать запрос в ваш групповой чат.
`MID` ОПЦИОНАЛЬНО	Уникальный идентификатор банковского терминала PSP Paton. Под каждый платежный метод и мерчанта свой идентификатор. Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`card` ОПЦИОНАЛЬНО	Маска карты в формате ХХХХХХ****ХХХХ Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`card_hash` ОПЦИОНАЛЬНО	Уникальное зашифрованное значение номера карты, которое будет возвращаться в коллбеке при оплате, верификации, погашении и выплате средств на карту. Этот параметр даст вам возможность в вашей системе: Привязать карту под клиента. Проверить не использовал ли другой клиент эту же карту. Проверить какие кредиты, товары и услуги погашаются данной картой. Отслеживать мошенничество, когда клиент использует ту же карту с другого аккаунта, например, чтобы повторно воспользоваться акцией. Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`brand` ОПЦИОНАЛЬНО	`'brand' => 'VISA'` `'brand' => 'MASTER'` `'brand" => 'PROSTIR'` Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`fee_type` ОПЦИОНАЛЬНО	Признак каким образом взимается комиссия: `ACT` - по актам. `TRANSACTION` - потранзакционно. Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`fee` ОПЦИОНАЛЬНО	Сумма комиссии с мерчанта по транзакции в ГРН Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`currency` ОПЦИОНАЛЬНО	Валюта операции Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`decline_reason` ОБЯЗАТЕЛЬНО	Причина, по которой транзакция была отклонена
`hash` ОБЯЗАТЕЛЬНО	Зашифрованная подпись для проверки достоверности коллбека md5( strtoupper( strrev(email). client_pass. trans_id. strrev( substr(card,0,6). substr(card,-4) ) ) ) Внимание! Если при запросе на оплату не был указан `email`, то при проверке `hash` в подписи Callback следует указать пустое значение для `email`.

При оплаті без 3DS АСИНХРОННИЙ РЕЖИМ

Промежуточный ответ АСИНХРОННИЙ РЕЖИМ

Response о принятии запроса в обработку

{
  "action": "SALE",
  "result": "ACCEPTED",
  "trans_id": "03346-89211-86461",
  "order_id": "ORDER-12345",
  "trans_date": "2012-04-03 16:02:01"
}

Параметры	Описание
`action` ОБЯЗАТЕЛЬНО	`SALE`
`result` ОБЯЗАТЕЛЬНО	`ACCEPTED`
`order_id` ОБЯЗАТЕЛЬНО	ID транзакции в системе мерчанта
`trans_id` ОБЯЗАТЕЛЬНО	ID транзакции в платежной системе
`trans_date` ОБЯЗАТЕЛЬНО	Дата транзакции в платежной системе. Время UTC

При успешной оплате АСИНХРОННИЙ РЕЖИМ

Callback при успешном списании

array (
  'action' => 'SALE',
  'result' => 'SUCCESS',
  'status' => 'SETTLED',
  'order_id' => '1_691201',
  'trans_id' => '31176-65336-00444',
  'trans_date' => '2021-01-27 16:55:33',
  'descriptor' => NULL,
  'auth_code' => '990647',
  'hash' => '********************************',
)

Параметры	Описание
`action` ОБЯЗАТЕЛЬНО	`SALE`
`result` ОБЯЗАТЕЛЬНО	`SUCCESS`
`status` ОБЯЗАТЕЛЬНО	`SETTLED` `PENDING` только когда было указано `auth` = `Y`
`order_id` ОБЯЗАТЕЛЬНО	ID транзакции в системе мерчанта
`trans_id` ОБЯЗАТЕЛЬНО	ID транзакции в платежной системе
`trans_date` ОБЯЗАТЕЛЬНО	Дата транзакции в платежной системе. Время UTC
`descriptor` ОБЯЗАТЕЛЬНО	Это строка, которую владелец кредитной карты увидит в выписка из банка. В большинстве случаев это веб-сайт поддержки клиентов.
`auth_code` ОБЯЗАТЕЛЬНО	Код авторизации от банка
`amount` ОПЦИОНАЛЬНО	Сумма транзакции Поле опционально и по умолчанию выключено. Для включения просьба написать запрос в ваш групповой чат.
`ext1`, `ext2`, `ext3`, `ext4`, `ext5`, `ext6`, `ext7`, `ext8`, `ext9`, `ext10` ОПЦИОНАЛЬНО	10 дополнительных полей Поля опционально и по умолчанию выключены. Для включения просьба написать запрос в ваш групповой чат.
`MID` ОПЦИОНАЛЬНО	Уникальный идентификатор банковского терминала PSP Paton. Под каждый платежный метод и мерчанта свой идентификатор. Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`card` ОПЦИОНАЛЬНО	Маска карты в формате ХХХХХХ****ХХХХ Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`card_hash` ОПЦИОНАЛЬНО	Уникальное зашифрованное значение номера карты, которое будет возвращаться в коллбеке при оплате, верификации, погашении и выплате средств на карту. Этот параметр даст вам возможность в вашей системе: Привязать карту под клиента. Проверить не использовал ли другой клиент эту же карту. Проверить какие кредиты, товары и услуги погашаются данной картой. Отслеживать мошенничество, когда клиент использует ту же карту с другого аккаунта, например, чтобы повторно воспользоваться акцией. Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`brand` ОПЦИОНАЛЬНО	`'brand' => 'VISA'` `'brand' => 'MASTER'` `'brand" => 'PROSTIR'` Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`fee_type` ОПЦИОНАЛЬНО	Признак каким образом взимается комиссия: `ACT` - по актам. `TRANSACTION` - потранзакционно. Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`fee` ОПЦИОНАЛЬНО	Сумма комиссии с мерчанта по транзакции в ГРН Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`currency` ОПЦИОНАЛЬНО	Валюта операции Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`hash` ОБЯЗАТЕЛЬНО	Зашифрованная подпись для проверки достоверности коллбека md5( strtoupper( strrev(email). client_pass. trans_id. strrev( substr(card,0,6). substr(card,-4) ) ) ) Внимание! Если при запросе на оплату не был указан `email`, то при проверке `hash` в подписи Callback следует указать пустое значение для `email`.

При неуспешной оплате АСИНХРОННИЙ РЕЖИМ

Callback при неуспешном списании

array (
  'action' => 'SALE',
  'result' => 'DECLINED',
  'status' => 'DECLINED',
  'order_id' => '1_691201',
  'trans_id' => '31176-65336-00444',
  'trans_date' => '2021-01-27 16:55:33',
  'decline_reason' => 'Declined by processing',
  'hash' => '********************************',
)

Параметры	Описание
`action` ОБЯЗАТЕЛЬНО	`SALE`
`result` ОБЯЗАТЕЛЬНО	`DECLINED`
`status` ОБЯЗАТЕЛЬНО	`DECLINED`
`order_id` ОБЯЗАТЕЛЬНО	ID транзакции в системе мерчанта
`trans_id` ОБЯЗАТЕЛЬНО	ID транзакции в платежной системе
`trans_date` ОБЯЗАТЕЛЬНО	Дата транзакции в платежной системе. Время UTC
`amount` ОПЦИОНАЛЬНО	Сумма транзакции Поле опционально и по умолчанию выключено. Для включения просьба написать запрос в ваш групповой чат.
`ext1`, `ext2`, `ext3`, `ext4`, `ext5`, `ext6`, `ext7`, `ext8`, `ext9`, `ext10` ОПЦИОНАЛЬНО	10 дополнительных полей Поля опционально и по умолчанию выключены. Для включения просьба написать запрос в ваш групповой чат.
`MID` ОПЦИОНАЛЬНО	Уникальный идентификатор банковского терминала PSP Paton. Под каждый платежный метод и мерчанта свой идентификатор. Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`card` ОПЦИОНАЛЬНО	Маска карты в формате ХХХХХХ****ХХХХ Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`card_hash` ОПЦИОНАЛЬНО	Уникальное зашифрованное значение номера карты, которое будет возвращаться в коллбеке при оплате, верификации, погашении и выплате средств на карту. Этот параметр даст вам возможность в вашей системе: Привязать карту под клиента. Проверить не использовал ли другой клиент эту же карту. Проверить какие кредиты, товары и услуги погашаются данной картой. Отслеживать мошенничество, когда клиент использует ту же карту с другого аккаунта, например, чтобы повторно воспользоваться акцией. Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`brand` ОПЦИОНАЛЬНО	`'brand' => 'VISA'` `'brand' => 'MASTER'` `'brand" => 'PROSTIR'` Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`fee_type` ОПЦИОНАЛЬНО	Признак каким образом взимается комиссия: `ACT` - по актам. `TRANSACTION` - потранзакционно. Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`fee` ОПЦИОНАЛЬНО	Сумма комиссии с мерчанта по транзакции в ГРН Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`currency` ОПЦИОНАЛЬНО	Валюта операции Если вы хотите использовать данный функционал, пожалуйста, сообщите нам для его включения.
`decline_reason` ОБЯЗАТЕЛЬНО	Причина, по которой транзакция была отклонена
`hash` ОБЯЗАТЕЛЬНО	Зашифрованная подпись для проверки достоверности коллбека md5( strtoupper( strrev(email). client_pass. trans_id. strrev( substr(card,0,6). substr(card,-4) ) ) ) Внимание! Если при запросе на оплату не был указан `email`, то при проверке `hash` в подписи Callback следует указать пустое значение для `email`.

При ошибке в запросе

Response в случая ошибки в запросе

{
  "result": "ERROR",
  "error_message": "Error description"
}

Ошибки запросов

Список ошибок, их причин и возможных решений.

Incorrect sign

Response: {"result":"ERROR","error_message":"Incorrect sign"}

Вариант 1

Неверно сформирована зашифрованная подпись.

Проверьте верность сформированной подписи. Если ошибку не нашли обратитесь в тех поддержку.

Вариант 2

Добавлены параметры, которые не входят в данный запрос.

Проверьте список передаваемых параметров. Если ошибку не нашли обратитесь в тех поддержку.

Вариант 3

Неверно зашифрована data.

Проверить используете ли вы UTF-8 и верный формат параметров.

Empty action

Response: {"result":"ERROR","error_message":"Empty action"}

Вариант 1

Параметр action заполнен не верно, пуст, или не на первом месте в списке параметров запроса.

Проверьте список передаваемых параметров. Если ошибку не нашли обратитесь в тех поддержку.

Вариант 2

Запрос отправляется методом GET, а не POST.

Отправить запрос методом POST.

Order already exists

Response: {"result":"ERROR","error_message":"Order already exists"}

Значение order_id должно быть уникальным. Данная ошибка говорит о том, что у вас уже была успешная транзакция с таким order_id.

Заменить значение order_id на новое уникальное.

Service error

Response: {"result":"ERROR","error_message":"Service error"}

Ситуация требует внимания сотрудников Platon.

Рекомендуем обратиться в тех саппорт Platon для проверки причины.

Previous transaction not completed

Response: {"result":"ERROR","error_message":"Previous transaction not completed"}

Ситуация требует внимания сотрудников Platon.

Рекомендуем обратиться в тех саппорт Platon для проверки причины.

Recurring not supported

Response: {"result":"ERROR","error_message":"Recurring not supported"}

rc_token заблокирован, подробнее о причинах можно узнать в разделе /wiki/spaces/docs/pages/1323303006

Рекомендуем удалить данный rc_token из вашей базы данных и повторить верификацию карты для получения rc_token и возможности проведения транзакций по новому токену.

Initial transaction too old

Response: {"result":"ERROR","error_message":"Initial transaction too old"}

card_token заблокирован, подробнее о причинах можно узнать в разделе /wiki/spaces/docs/pages/1323303006

Рекомендуем удалить данный card_token из вашей базы данных и повторить верификацию карты для получения card_token и возможности проведения транзакций по новому токену.

Account error

Response: {"result":"ERROR","error_message":"Account error"}

Вариант 1

Ваш IP адрес не добавлен в наш белый список.

Обратитесь в тех поддержку для добавления вашего IP в белый список.

Вариант 2

Данный функционал вам не подключен.

Обратитесь в тех поддержку для активации функционала.

Вариант 3

Запрос отправлен не на нужную ссылку.

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

Вариант 4

В запросе указан неверное или несуществующее значение параметра channel_id.

Проверьте передаваемое значение channel_id на достоверность или уточните у тех поддержки доступные у вас значение.

Card token not found for current client

Response: {"result":"ERROR","error_message":"Card token not found for current client"}

Отправка запроса по этому card_token отключена для данного API ключа так как card_token был получен на другом API ключе.

Обратитесь в тех поддержку для решения данной ситуации.

Incorrect hash

Response: {"result":"ERROR","error_message":"Incorrect hash"}

Вариант 1

Неверно сформирована зашифрованная подпись.

Проверьте верность сформированной подписи. Если ошибка не найдена обратитесь в тех поддержку.

Вариант 2

Добавлены параметры, которые не входят в данный запрос.

Проверьте список передаваемых параметров. Если ошибка не найдена обратитесь в тех поддержку.

Вариант 3

Запрос был отправлен не с того API ключа по которому был получен rc_token.

Рекомендуем заменить API ключ на тот, по которому был получен rc_token.

Duplicate request

Response: {"result":"ERROR","error_message":"Duplicate request"}

За одну минуту в систему вами было отправлено несколько одинаковых запросов.

Рекомендуем проверить ваш механизм отправки запросов на наличие задвоения.

Incorrect card_token value

Response: {"result":"ERROR","error_message":"Incorrect card_token value"}

Вариант 1

Запрос был отправлен менее чем через 10 минут после получения токена.

Рекомендуем настроить отправку запросов минимум через 10 минут после получения токена. Запрос по которому получена эта ошибка необходимо повторить.

Вариант 2

В параметр card_token внесено неверное значение.

Рекомендуем проверить верность внесенных данных в поле card_token полученного из коллбека ранее. Запрос по которому получена эта ошибка необходимо повторить.

Not found card token

Response: {"result":"ERROR","error_message":"Not found card token"}

Вариант 1

Запрос был отправлен менее чем через 10 минут после получения токена.

Рекомендуем настроить отправку запросов минимум через 10 минут после получения токена. Запрос по которому получена эта ошибка необходимо повторить.

Вариант 2

В параметр card_token внесено неверное значение.

Рекомендуем проверить верность внесенных данных в поле card_token полученного из коллбека ранее. Запрос по которому получена эта ошибка необходимо повторить.

102: Token is not active

'decline_reason' => '102: Token is not active'

rc_token заблокирован, подробнее о причинах можно узнать в разделе /wiki/spaces/docs/pages/1323303006

Рекомендуем удалить данный rc_token из вашей базы данных и повторить верификацию карты для получения rc_token и возможности проведения транзакций по новому токену.

Wrong credit_date

'error_message' => 'Wrong credit_date'

credit_date введен не согласно формата YYYY-MM-DD или указана будущая дата.

Рекомендуем указать в credit_date прошедшую дату или текущую.

Invalid pan

'error_message' => 'Invalid pan'

Invalid pan введен не верный номер карты.

Сверьте номер карты. Рекомендуем проверять номер карты на действительность перед отправкой в запросе используя алгоритм Луна.

Боевой режим

Пройдите контрольный список интеграции:

После добавления кнопки на ваш сайт/мобильное приложение необходимо пройти контрольный список интеграции для проверки корректности работы Google Pay API:

Для сайтов: https://developers.google.com/pay/api/web/guides/test-and-deploy/integration-checklist

Для мобильных приложений: https://developers.google.com/pay/api/android/guides/test-and-deploy/integration-checklist

Запросите доступ к рабочей версии Google Pay API:

Для возможности начать принимать реальные платежи необходимо запросить доступ в рабочей версии:

https://developers.google.com/pay/api/android/guides/test-and-deploy/request-prod-access

Получите доступ на Production в Google Pay:

https://developers.google.com/pay/api/android/guides

Для этого необходимо создать учетную запись в https://pay.google.com/business/console/ (используя гугл аккаунт, желательно корпоративный и общий)

Заполните информацию о компании.

В интеграциях выбрать Сайт, заполнить домен (пока домен тестового сайта), указать тип PaymentGateway и вложить 5 скринов процесса заказа и оплаты.

Сразу можете подавать заявку и для получения доступа с продовым доменом.

Просьба обратить внимание, что в прод режиме Google Pay будет работать только на проаппрувленых гуглом доменах.

https://developers.google.com/pay/api/android/guides/test-and-deploy/request-prod-access

Получение доступа занимает 2-3 дня. Если у сотрудников Google будут замечания - они отправят письмо на мейл, под которым вы зарегистируетесь.

После этого с вашей стороны необходимо переключиться на Production в интеграции с GooglePay:

Для этого: https://developers.google.com/pay/api/web/guides/test-and-deploy/deploy-production-environment

Установить environment: ‘PRODUCTION' вместо 'TEST’
Указать значение merchantId из бизнес аккаунта GooglePay (правый верхний угол)

И сообщить нам по готовности для переключения настроек с нашей стороны.

Дополнительно для мобильного приложения Android:

Рекомендуем подавать заявку в бизнес консоли с Google аккаунта, под которым вы зарегистрированы в Google Play и выкладываете приложения.

Если будете подавать заявку с другого аккаунта - дополнительно нужно будет связать аккаунты. Инструкция как связать https://support.google.com/googleplay/android-developer/answer/2528691

Для интеграции в моб приложении необходимо будет подписать приложение релизными ключами когда получите доступ на прод и будете преключаться https://developers.google.com/pay/api/android/guides/test-and-deploy/deploy-your-application

IA оплата Google Pay™

Зміст

Опис

Демо

Чекліст інтеграції

Вимоги

PSP Platon

Visa

Mastercard

Оплата частинами Monobank

Оплата частинами ПриватБанк

PCI DSS

Apple Pay

Google Pay

Privat24

Обмеження

Google Business Console

Google Pay API

API параметри

Приклад запиту

Тестування

Проверка платежей

Callback & Response

Telegram Bot

Особистий кабінет PSP Platon

Інструкція по використанню

Помилки доступу в кабінет

CSV файл

Банківський реєстр

API запит статуса

Callback и Response

URL для Callback

IP адреси

Очікувана відповідь на Callback

Помилки при відправці Callback

Перевідправка Callback

Довірені IP

Секретність API доступів

Секретність кабінету

Секретність посилання для Callback

Сторінка успішної оплати не гарантія успіху оплати

Звірка даних в Callback

Синхронный режим:

Асинхронный режим:

При оплаті з 3DS СИНХРОННИЙ РЕЖИМ

Промежуточный редирект плательщика на 3DS СИНХРОННИЙ РЕЖИМ

При успішній оплаті з 3DS СИНХРОННИЙ РЕЖИМ

При неуспешной оплате з 3DS СИНХРОННИЙ РЕЖИМ

При оплаті з 3DS АСИНХРОННИЙ РЕЖИМ

Промежуточный ответ АСИНХРОННИЙ РЕЖИМ

Промежуточный редирект плательщика на 3DS АСИНХРОННИЙ РЕЖИМ

При успешной оплате АСИНХРОННИЙ РЕЖИМ

При неуспешной оплате з 3DS АСИНХРОННИЙ РЕЖИМ

При ошибке в запросе

При оплаті без 3DS СИНХРОННИЙ РЕЖИМ

При успешной оплате СИНХРОННИЙ РЕЖИМ

При неуспешной оплате СИНХРОННИЙ РЕЖИМ

При оплаті без 3DS АСИНХРОННИЙ РЕЖИМ

Промежуточный ответ АСИНХРОННИЙ РЕЖИМ

При успешной оплате АСИНХРОННИЙ РЕЖИМ

При неуспешной оплате АСИНХРОННИЙ РЕЖИМ

При ошибке в запросе

Ошибки запросов

Вариант 1

Вариант 2

Вариант 3

Вариант 1

Вариант 2

Вариант 1

Вариант 2

Вариант 3

Вариант 4

Вариант 1

Вариант 2

Вариант 3

Вариант 1

Вариант 2

Вариант 1

Вариант 2

Боевой режим