...
API ENDPOINT: https://secure.platononline.com/payment/auth
Описание параметров запроса:
...
Параметр | Значение | Описание | Особенности | Обязательно |
|---|
key
| String | API ключ мерчанта | Ключ предоставляется на почту мерчанту | Да |
payment
| P24
| Код платежного метода | | Да |
data
| amount
| Number | Сумма платежа | | Tip |
|---|
Верный вариант 1000.00 |
| Warning |
|---|
Неверные варианты 1000
1000.0
1,000.0
1,000.00 |
| Да |
currency
| UAH
| Валюта платежа | | Info |
|---|
Оплата возможна только в национальной валюте гривне |
| Да |
description
| String | Описание платежа | | Note |
|---|
Для кириллических символов необходимо использовать формат UTF-8 |
Max 5000 символов | Да |
url
| String | Ссылка по которой будет отправлен клиент после успешной оплаты | Max 255 символов | Да |
sign
| String | Контрольная подпись | | Code Block |
|---|
| md5(
strtoupper(
strrev(key).
strrev(payment).
strrev(data).
strrev(url).
strrev(pass)
)
) |
| Да |
lang
| UK,
RU,
EN
| Язык отображения формы | В приоритете настройка языка браузера плательщика | Нет |
email
| String | Почта плательщика | Max 255 символа | Нет |
first_name
| String | Имя плательщика | Max 32 символа | Нет |
last_name
| String | Фамилия плательщика | Max 32 символа | Нет |
phone
| Number | Номер телефона плательщика | | Note |
|---|
Если ваше юр. лицо открыто в Приватбанк и вы передаете в запросе телефон плательщика, то: 1) обязательный формат телефона 380… 2) номер телефона должен соответствовать финансовому номеру привязанному к карте |
| Нет |
address
| String | Адресс Адрес плательщика | Max 32 символа | Нет |
zip
| String | Почтовый код плательщика | Max 32 символа | Нет |
city
| String | Город плательщика | Max 32 символа | Нет |
country
| String | Двухзначный код страны плательщика | Стандарт ISO 3166-1 alpha-2 | Нет |
state
| String | Код штата, провинции или области плательщика | | Note |
|---|
Обязательный параметр для стран US, CA, AU |
Стандарт ISO 3166-2 | Нет |
customer_wallet
| String | Номер електронного кошелька пользователя | Поле обязательно для типов бизнеса связаных связанных с виртуальными активами | Нет |
order
| String | ID платежа в системе мерчанта | Max 32 символа | Нет |
formid
| String | Параметр дополнительной настройки |
| Нет |
ext1-ext10
| String | Дополнительные поля | Max 1024 символа в каждом ext поле | Нет |
...
| Expand |
|---|
| title | Пример POST параметров в Callback при успешной оплате |
|---|
|
| Code Block |
|---|
| array (
'id' => '12345-12345-12345',
'order' => '12345678',
'status' => 'SALE',
'description' => 'description 12345',
'amount' => '99.99',
'currency' => 'UAH',
'date' => '2020-02-14 11:11:11',
'ip' => '172.172.17.172',
'sign' => 'qwerty123uiop456asdfgh789jkl012z',
'number' => '411156*89',
'email' => NULL,
'name' => ' ',
'phone' => NULL,
'ext1' => '12345678',
) |
Параметр | Описание |
|---|
id
| Уникальный ордер ID транзакции в Platon | order
| Ордер ID транзакции в системе мерчанта. Если параметр не передавался система Platon присвоит его самостоятельно | status
| SALE
| number
| Маска карты в формате ХХХХХХ*ХХ | description
| Описание | amount
| Сумма списания | currency
| Валюта транзакции | name
| Сума передаваемых параметров first_name и last_name | email
| E-mail плательщика | phone
| Телефон плательщика | date
| Время проведения транзакции в формате UTC (YYYY-MM-DD HH-MM-SS) | ip
| IP адрес плательщика | ext1-ext10
| Дополнительные поля от 1 до 10 | sign
| Зашифрованная подпись для проверки достоверности коллбека | Code Block |
|---|
md5(
strtoupper(
$pass.
$order_id
)
) |
|
|
| Expand |
|---|
| title | Пример GET параметров |
|---|
|
| Tip |
|---|
Плательщик будет отправлен по ссылке указанной в “url” url с добавлением “order” order методом GET |
| Code Block |
|---|
| array (
'token' => '12345678',
) |
|
...
Callback при неуспешной оплате
...
| Info |
|---|
При неуспешной оплате коллбек не отправляется |
...
Ошибки запросов
...
В ходе проведения запрос вы можете получить разные ошибки. Пожалуйста, ознакомьтесь со списком возможных ошибок, их причин и возможности решения.
...
| Expand |
|---|
| title | Список ошибок и их решение |
|---|
|
Ошибка | Причины | Решение |
|---|
Response: {"result":"ERROR","error_message":"Incorrect sign"}
| Неверно сформирована зашифрованная подпись. | Проверьте верность сформированной подписи. Если ошибку не нашли обратитесь в тех поддержку. | Добавлены параметры, которые не входят в данный запрос. | Проверьте список передаваемых параметров. Если ошибку не нашли обратитесь в тех поддержку. | Неверно зашифрована data. | Проверить используете ли вы UTF-8 и верный формат параметров. | Response: {"result":"ERROR","error_message":"Empty action"}
| Параметр action заполнен не верно, пуст, или не на первом месте в списке параметров запроса. | Проверьте список передаваемых параметров. Если ошибку не нашли обратитесь в тех поддержку. | Response: {"result":"ERROR","error_message":"Order already exists"}
| Значение order_id должно быть уникальным. Данная ошибка говорит о том, что у вас уже была успешная транзакция с таким order_id. | Заменить значение order_id на новое уникальное. | Response: {"result":"ERROR","error_message":"Service error"}
| Ситуация требует внимания сотрудников Platon. | Рекомендуем обратиться в тех саппорт Platon для проверки причины. | Response: {"result":"ERROR","error_message":"Previous transaction not completed"}
| Ситуация требует внимания сотрудников Platon. | Рекомендуем обратиться в тех саппорт Platon для проверки причины. |
|