View Source

Зміст

Опис

Цей метод дозволяє отримати переваги при оплаті використовуючи понижений тариф по C2A.

З боку платника проводиться як звичайна оплата.

Демо

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

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

Вимоги

API параметри

HTTP METHOD: POST

API ENDPOINT: https://secure.platononline.com/payment/auth

Параметр

Значення

Опис

Особливості

key

String

API ключ мерчанта

Ключ надається на пошту мерчанту

payment

C2A,CC

Код платіжного методу

amount

Number

Сума оплати

Вірний варіант

1000.00

Невалідний варіант

1000
1000.0
1,000.0
1,000.00

currency

UAH

Валюта оплати

Оплата можлива лише в національній валюті гривні

description

String

Опис оплати

Max 255 символів

order

String

ID оплати в системі мерчанта

Max 32 символа

email

String

Пошта платника

phone

Number

Номер телефону платника

Обов'язковий формат телефона 380…

Max 255 символів

req_token

1

Створення токену картки

Для отриманняcard_token

first_name

String

Ім'я платника

Тільки латиниця

Max 32 символа

last_name

String

Прізвище платника

Тільки латиниця

Max 32 символа

url

String

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

Max 1024 символа

sign

String

Контрольний підпис

md5(
  strtoupper(
    strrev($client_key).
    strrev($payment).
    strrev($amount).
    strrev($currency).
    strrev($description).
    strrev($url).
    strrev($client_pass)
  )
)

error_url

String

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

При відсутності посилання помилка буде відображена на платіжній формі.

Max 1024 символа

address

String

Адреса платника

Max 255 символа

zip

String

Поштовый код платника

Max 32 символа

city

String

Місто платника

Max 32 символа

country

String

Двозначний код країни платника

Стандарт ISO 3166-1 alpha-2

state

String

Код штата, провінції або області платника

Обов'язковий параметр для країн US, CA, AU

Стандарт ISO 3166-2

lang

UK
EN

Мова платіжної форми

В пріорітеті налаштування браузера клієнта

formid

String

Параметр додаткового налаштування

Max 255 символів

itn

String

ІПН платника

Обов'язково, якщо amount більше або рівний 30000 грн.

ext1, ext2, ext3, ext4

String

Додаткові поля

Max 1024 символа в кожному ext полі

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

<?php 
  $data['client_key'] = '***';
  $data['client_pass'] = '***';
  $data['payment'] = 'C2A,CC';
  $data['amount'] = '400.30';
  $data['currency'] = 'UAH';
  $data['description'] = 'Test DEBIT operation by Platon';
  $data['url'] = 'https://www.google.com.ua';
  $data['order'] = 'ABC123';
  $data['req_token'] = '1';
  $sign = md5(
            strtoupper(
              strrev($data['client_key']).
              strrev($data['payment']).
              strrev($data['amount']).
              strrev($data['currency']).
              strrev($data['description']).
              strrev($data['url']).
              strrev($data['client_pass'])
            )
          );
?>

<!DOCTYPE html>
<html>
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
    <title>debi</title>
  </head>
  <body onload="javascript:document.forms[0].submit()">
    <form action="https://secure.platononline.com/payment/auth" method="post">
      <input type="hidden" name="key" value="<?=$data['client_key']?>" /> 
      <input type="hidden" name="payment" value="<?=$data['payment']?>" />
      <input type="hidden" name="amount" value="<?=$data['amount']?>" />
      <input type="hidden" name="req_token" value="1" />
      <input type="hidden" name="currency" value="<?=$data['currency']?>" />
      <input type="hidden" name="description" value="<?=$data['description']?>" />
      <input type="hidden" name="url" value="<?=$data['url']?>" />
      <input type="hidden" name="order" value="<?=$data['order']?>" />
      <input type="hidden" name="sign" value="<?=$sign?>" />
    </form>
  </body>
</html>

Тестування

Для тестування використайте наші тестові реквізити.

Час платіжної сесії

Стандартно у платника буде 15 хв для проведення оплати. Це означає, що на 15 хвилину та 1 секунду оплата стане не доступною та приведе до помилки. Відлік починається з моменту відкриття платіжної форми.

Стандартний проміжок часу 15 хв є результатом багатоьох тестів та більш чим необхідно достатній для проведення оплати.

Якщо у вас є потреба в іншому проміжку, по вашому запиту можна налаштувати час платіжної сесії з наявних варіантів: