Page Comparison

Содержание

Зміст

Table of Contents

minLevel	1
maxLevel	2
indent	0px
absoluteUrl	true
style	circle

Описание

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

Также, получить преимущество при оплате используя пониженный тариф по Дебету.

Tip

Внимание! Данный запрос выполняется в несколько этапов:

Инициализация (API запрос №1)
Подтверждение (API запрос №2)
Редирект плательщика на 3DS

Требования к сайту

Expand

title	PCI DSS или PCI Compliance

Наличие у мерчанта PCI DSS сертификата или PCI Compliance (сканирования).

Note
Согласуйте первоначально с вашим менеджером PSP Platon.

Expand

title	SSL сертификат

У вашего сайта должен быть SSL сертификат.

Для проверки валидности и срока действия вашего SSL сертификата рекомендуем воспользоваться сервисом по ссылке.

Expand

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

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

Скачайте подходящие под стиль вашего сайта варианты логотипов.

Include PageЛоготипи для розміщенняЛоготипи для розміщення

Expand

title	TLS 1.2

Необходима поддержка протокола TLS не ниже версии 1.2

API параметры №1

HTTP METHOD: POST

API ENDPOINT: https://secure.platononline.com/p2p-debit/

Параметр

Значение

Описание

Особенности

action

Опис

Оплата по технології C2A дебет з обробкою карткових даних.

Info
Обов'язкова наявність у мерчанта PCI DSS.

Tip

Увага! Цей запит виконується в декілька етапів:

Ініциалізація (API запит №1)
Підтвердження (API запит №2)
Редірект платника на 3DS

Вимоги

Include Page

	Вимоги до сайтів та додатків
	Вимоги до сайтів та додатків

API параметри №1

HTTP METHOD: POST

API ENDPOINT: https://secure.platononline.com/p2p-debit/

Параметр

Значення

Опис

Особливості

action

Status

colour	Green
title	Обов'язковий

DEBIT_PREPARE

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

async

Status

colour	Yellow
title	не Обов'язковий

Y
N

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

Стандартне значення "N" можна не передавати

channel_id

Status

colour	Yellow
title	не Обов'язковий

String

Додатковий платіжний канал

Відправка коштів на окремий платіжний термінал

client_key
async

Status

colour	Green
title	ОБЯЗАТЕЛЬНО

DEBIT_PREPARE

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

Обов'язковий

String

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

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

order_id
channel_id

Status

colour	YellowGreen
title	не ОБЯЗАТЕЛЬНО

Y
N

Включить асинхронный режим

В асинхронном режиме обязательное использование коллбеков.
По умолчанию значение "N"

Обов'язковий

String

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

Max 32 символи

order_amount
order_id

Status

colour	YellowGreen
title	не ОБЯЗАТЕЛЬНО

String

Дополнительный платежный канал

Позволяет отправить платежи на другой банковский терминал

client_key

Status

colour	Green
title	ОБЯЗАТЕЛЬНО

String

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

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

Обов'язковий

Number

Сума оплати

Tip

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

1000.00

Warning

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

1000
1000.0
1,000.0
1,000.00

order_currency
Max 32 символа

Status

colour	Green
title	ОБЯЗАТЕЛЬНО

String

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

	Обов'язковий

UAH

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

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

order_amountdescription

Status

colour	Green
title	ОБЯЗАТЕЛЬНООбов'язковий

NumberString

Сумма платежаОпис оплати

Tip

Верный вариант

1000.00

Warning

Неверные варианты

1000
1000.0
1,000.0
1,000.00

order_currency

Note
Для криличних символів треба використовувати формат UTF-8

Max 255 символов

payer_first_name

Status

colour	Green
title	ОБЯЗАТЕЛЬНООбов'язковий

UAH

Валюта платежа

Info
Оплата возможна только в национальной валюте гривне

order_descriptionString

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

Max 32 символів без пробілів
Вкажіть "NA" якщо немає даних

payer_last_name

Status

colour	Green
title	ОБЯЗАТЕЛЬНООбов'язковий

String

Описание платежа

Note
Для кириллических символов необходимо использовать формат UTF-8

Max 255 символов

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

Max 32 символів без пробілів
Вкажіть "NA" якщо немає даних

payer_address

Status

colour	Green
title	ОБЯЗАТЕЛЬНООбов'язковий

StringИмя

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

Max 32 символа без пробелов
Укажите 256 символів
Вкажіть "NA" , если нет данныхякщо немає даних

payer_last_namecountry

Status

colour	Green
title	ОБЯЗАТЕЛЬНООбов'язковий

String

Фамилия плательщика

Max 32 символа без пробелов
Укажите "NA", если нет данных

payer_addressКраїна платника

Стандарт ISO 3166-1 alpha-2
В форматі "ХХ"
2 символа

payer_state

Status

colour	Green
title	ОБЯЗАТЕЛЬНООбов'язковий

String

Адрес плательщика

Max 256 символа
Укажите "NA", если нет данныхШтат платника

Стандарт ISO 3166-2
В форматі "ХХ"
2 символа

payer_countrycity

Status

colour	Green
title	ОБЯЗАТЕЛЬНООбов'язковий

String

Страна плательщика

Стандарт ISO 3166-1 alpha-2
В формате "ХХ"
2 символа

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

Max 32 символи
Вкажіть "NA" якщо немає даних

payer_zip

Status

colour	Green
title	ОБЯЗАТЕЛЬНООбов'язковий

String

Штат плательщика

Note
Обязательный параметр для стран US, CA, AU

Стандарт ISO 3166-2
В формате "ХХ"
2 символа

payer_city
Поштовий індекс платника

Max 32 символи

payer_email

Status

colour	Green
title	ОБЯЗАТЕЛЬНООбов'язковий

String

Город плательщика

Max 32 символа
Укажите "NA", если нет данных

payer_zip

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

Info
Обов'язково валідна пошта

Info
Без пробілів.

Max 255 символа

payer_phone

Status

colour	Green
title	ОБЯЗАТЕЛЬНООбов'язковий

String

Почтовый индекс плательщика

Max 32 символаНомер телефону платника

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

payer_emailip

Status

colour	Green
title	ОБЯЗАТЕЛЬНООбов'язковий

String

Почта плательщика

Info
Обязательно валидная почта.

Info
Отсутствие пробелов.

Max 255 символа

payer_phoneNumber

IP-адреса платника

В форматі "ХХХ.ХХХ.ХХХ.ХХХ"

Note
IPv6 на даний момент не підтримується

card_number

Status

colour	Green
title	ОБЯЗАТЕЛЬНООбов'язковий

String

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

Info
Обязательный формат телефона 380…

Укажите "NA", если нет данных

payer_ipNumber

Повний номер картки

В форматі "ХХХХХХХХХХХХХХХХ"
16 символів

card_exp_month

Status

colour	Green
title	ОБЯЗАТЕЛЬНООбов'язковий

NumberIP-адрес плательщика

Місяць терміну дії картки

В формате "ХХХ.ХХХ.ХХХ.ХХХформаті "ХХ"

Note
IPv6 на данный момент не поддерживается

card_number2 символа

card_exp_year

Status

colour	Green
title	ОБЯЗАТЕЛЬНООбов'язковий

NumberПолный номер карты

Рік терміну дії картки

В формате форматі "ХХХХХХХХХХХХХХХХХХХХ"
16 символов4 символа

card_exp_monthcvv2

Status

colour	Green
title	ОБЯЗАТЕЛЬНООбов'язковий

NumberМесяц

окончания срока действия картыCVV код

В формате форматі "ХХХХХ"
2 3 символа

cardreq_exp_yeartoken

Status

colour	Green
title	ОБЯЗАТЕЛЬНООбов'язковий

Number

Год окончания срока действия карты

В формате "ХХХХ"
4 символа

card_cvv2Y
N

Для формування card_token

Стандартне значення "N"

term_url_3ds

Status

colour	Green
title	ОБЯЗАТЕЛЬНООбов'язковий

Number

Проверочный код на карте

В формате "ХХХ"
3 символа

req_tokenString

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

Max 255 символів

signature

Status

colour	Green
title	ОБЯЗАТЕЛЬНООбов'язковий

Y
N

Для получения card_token

По умолчанию "N"

term_url_3ds

Status

colour	Green
title	ОБЯЗАТЕЛЬНО

String

Ссылка по которой будет отправлен клиент после успешной / не успешной оплаты после 3DS

Max 255 символов

signature

Status

colour	Green
title	ОБЯЗАТЕЛЬНО

String

Контрольная подпись

String

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

Code Block

language	php

sha1(
  $pass.
  strtolower(
    implode(
      '',
      $action.
      $client_key.
      $order_id.
      $order_amount.
      $order_currency.
      $order_description.
      $card_number.
      $card_exp_month.
      $card_exp_year.
      $card_cvv2.
      $payer_first_name.
      $payer_last_name.
      $payer_phone.
      $payer_address.
      $payer_country.
      $payer_state.
      $payer_city.
      $payer_zip.
      $payer_email.
      $payer_ip.
      $term_url_3ds.
    )
  )
)

Note
Значення в hash мають відповідати послідовності полів в самому запиті.

API

параметры

параметри №2

HTTP METHOD: POST

API ENDPOINT: https://secure.platononline.com/p2p-debit/

Параметр

ЗначениеЗначення

ОписаниеОпис

ОсобенностиОсобливості

action

Status

colour	Green
title	ОбязательноОбов'язковий

DEBIT_RUN

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

client_key

Status

colour	Green
title	ОбязательноОбов'язковий

String

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

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

trans_id

Status

colour	Green
title	ОбязательноОбов'язковий

String

ID платежа оплати в системе системі PSP Platon

Уникальный ордер ID транзакции в Platon

card_cvv2

Status

colour	Green
title	ОбязательноОбов'язковий

Number

Проверочный CVV код на карте

В формате форматі "ХХХ"
3 символасимволи

signature

Status

colour	Green
title	ОбязательноОбов'язковий

StringКонтрольная

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

Code Block

language	php

sha1(
  $pass.
  strtolower(
    implode(
      '',
      $action,
      $client_key,
      $trans_id,
      $card_cvv2
    )
  )
)

Примеры запроса

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

Expand

title	Пример запроса Приклад запиту на PHP

Code Block

language	php

<?php
  $pass='***************'; //Client's password
  $params['action']='DEBIT_PREPARE';
  $params['client_key']='******'; //Client's KEY 
  $params['order_id']='Platon_test_37254'.rand(100, 999);
  $params['order_amount']='10.00';
  $params['order_currency']='UAH';
  $params['order_description']='test_by_Platon';
  $params['card_number'] = '1111111111111111';
  $params['card_exp_month'] = '11';
  $params['card_exp_year'] = '1111';
  $params['card_cvv2'] = '111';
  $params['payer_first_name']='Jack';
  $params['payer_last_name']='Anderson';
  $params['payer_phone']='380962111111';
  $params['payer_address']='NA';
  $params['payer_country']='UA';
  $params['payer_state']='NA';
  $params['payer_city']='NA';
  $params['payer_zip']='01001';
  $params['payer_email']='test@test.com';
  $params['payer_ip']='111.111.111.111';
  $params['term_url_3ds']='https://google.com';
  $params['signature'] = sha1($pass . strtolower(implode('', $params)));
  
  $url = 'https://secure.platononline.com/p2p-debit/';
  
  $tempData = array();
    foreach ($params as $key => $value) {
      $tempData[] = $key.'='.urlencode($value);
    }
    
  $crq = curl_init();
    curl_setopt($crq, CURLOPT_URL, $url);
    curl_setopt($crq, CURLOPT_HEADER, 0);
    curl_setopt($crq, CURLOPT_RETURNTRANSFER, 1);
    curl_setopt($crq, CURLOPT_SSL_VERIFYHOST, 0);
    curl_setopt($crq, CURLOPT_SSL_VERIFYPEER, 0);
    curl_setopt($crq, CURLOPT_POSTFIELDS, implode('&', $tempData));
    $result = curl_exec($crq);
    if (curl_errno($crq)) {
      echo 'ERROR: '.curl_error($crq);
    }
    curl_close($crq);

  echo $result;
  $moda = json_decode($result, true);

  $pars['action']='DEBIT_RUN';
  $pars['client_key']='*******';
  $pars['trans_id']=$moda['trans_id'];
  $pars['card_cvv2']='111';
  $pars['signature']= sha1($pass . strtolower(implode('', $pars)));
  
  $temp = array();
    foreach ($pars as $key => $value) {
      $temp[] = $key.'='.urlencode($value);
    }
  $crq = curl_init();
    curl_setopt($crq, CURLOPT_URL, $url);
    curl_setopt($crq, CURLOPT_HEADER, 0);
    curl_setopt($crq, CURLOPT_RETURNTRANSFER, 1);
    curl_setopt($crq, CURLOPT_SSL_VERIFYHOST, 0);
    curl_setopt($crq, CURLOPT_SSL_VERIFYPEER, 0);
    curl_setopt($crq, CURLOPT_POSTFIELDS, implode('&', $temp));
    $res = curl_exec($crq);
    if (curl_errno($crq)) {
      echo 'ERROR: '.curl_error($crq);
    }
    curl_close($crq);
  
  echo $res;
  $respRedirect = json_decode($res, true);
  echo $respRedirect['redirect_url'];
  
  header('Location: '.$respRedirect['redirect_url']);
  
?>

Callback

Expand

title	Особенности работы с Особливості роботи з Callback

Include Page

	Робота з Callback
	Робота з Callback

Expand

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

Include Page

	Безпека
	Безпека

Промежуточная инициализация плательщикапо API запросу

Проміжна ініциалізація по API запиту №1:

Expand

title	Промежуточный Проміжний Responce инициализации транзакции ініциалізації по API запросу запиту №1

Code Block

language	json

{
  "action":"DEBIT_PREPARE",
  "result":"SUCCESS",
  "status":"INIT",
  "order_amount":"10.00",
  "order_commission":null,
  "order_currency":"UAH",
  "descriptor":null,
  "order_id":"Platon_test_37254615",
  "trans_id":"33999-98398-18623",
  "trans_date":"2021-12-20 11:30:39"
}

Промежуточный редирект плательщика

Проміжний редірект на 3DS по API

запросу

запиту №2:

Expand

title	Промежуточный Проміжний Responce для редиректа плательщика редіректа на 3DS по API запросу запиту №2

Code Block

language	json

{
  "action":"DEBIT_RUN",
  "result":"SUCCESS",
  "status":"3DS",
  "redirect_url":"https:\/\/www.liqpay.ua\/apipay\/3ds\/request\/1640462_33031267_eUjiyjdkjUoAFjE60CpfSmg6t0nbpEZ4vJMBfIUJ\/?return_to=https%3A%2F%2Fsecure.platononline.com%2F3ds%2F173b0c33%3Foperation_type%3Ddebit2card%26trans_id%3D34000-10530-30053%26hash%3D1430b568b390d9fdgdga7030e3c22e4f74894",
  "redirect_params":null,
  "redirect_method":"GET",
  "order_id":"Platon_test461",
  "trans_id":"34000-10530-30053",
  "trans_date":"2021-12-20 11:50:57"
}

При

успешной оплате

успішній оплаті:

{

Expand

title	Responce при успешном списании

Code Block

успішній оплаті

Code Block

{
  "action":"DEBIT_RUN",
  "result":"SUCCESS",
  "status":"SETTLED",
  "actionorder_id":"DEBIT_RUN4385302",
  "resulttrans_id":"SUCCESS28261-34099-19648",
  "statustrans_date":"SETTLED2020-02-25 06:50:09",
  "order_id":"4385302",
  "trans_id":"28261-34099-19648",
  "trans_date":"2020-02-25 06:50:09",
  "card_token":"8ef3111ac1093f6ccb817acef7f0845601d0994689a5f57949f94b0d086c7fe2"
} "card_token":"8ef3111ac1093f6ccb817acef7f0845601d0994689a5f57949f94b0d086c7fe2"
}

Параметр	Опис
`action`	`DEBIT_RUN`
`result`	`SUCCESS`
`status`	`SETTLED`
`order_id`	Унікальний ордер ID транзакції в системі мерчанта
`trans_id`	Унікальний ордер ID транзакції в системі PSP Platon
`trans_date`	Час проведення транзакції в форматі UTC (YYYY-MM-DD HH-MM-SS)
`card_token`	Зашифрований токен картки

Expand

title	Callback при успешном списанииуспішній оплаті

Code Block

language	php

array (
  'action' => 'DEBIT_RUN',
  'result' => 'SUCCESS',
  'status' => 'SETTLED',
  'order_id' => '4385323',
  'trans_id' => '28261-47789-28578',
  'trans_date' => '2020-02-25 07:12:58',
  'card_token' => '8ef3111ac1093f6ccb817acef7f0845601d0994689a5f57949f94b0d086c7fe2',
  'hash' => '********************************',
)

Параметр	ОписаниеОпис
`action`	`DEBIT_RUN`
`result`	`SUCCESS`
`status`	`SETTLED`
`order_id`	Уникальный Унікальний ордер ID транзакции транзакції в системе системі мерчанта
`trans_id`	Уникальный Унікальний ордер ID транзакции транзакції в системе системі PSP Platon
`trans_date`	Время проведения транзакции в формате Час проведення транзакції в форматі UTC (YYYY-MM-DD HH-MM-SS)
`card_token`Зашифрованный токен карты для последующих транзакций по card_token	Зашифрований токен картки
`hash`	Зашифрованная подпись для проверки достоверности коллбека

При неуспешной оплате

Зашифрований підпис для перевірки достовірності коллбеку

При невдалій оплаті:

{

Expand

title	Responce при неуспешном списании

Code Block

невдалій оплаті

Code Block

{
  "action":"DEBIT_RUN",
  "result":"DECLINED",
  "status":"DECLINED",
  "order_id":"4092002",
  "actiontrans_id":"DEBIT_RUN28076-29879-99538",
  "resulttrans_date":"DECLINED2020-02-03 20:49:47",
  "statusdecline_reason":"DECLINED",Declined by  "order_id":"4092002",
  "trans_id":"28076-29879-99538",
  "trans_date":"2020-02-03 20:49:47",
  "decline_reason":"Declined by processing"
}processing"
}

Параметр	Опис
`action`	`DEBIT_RUN`
`result`	`DECLINED`
`status`	`DECLINED`
`order_id`	Унікальний ордер ID транзакції в системі мерчанта
`trans_id`	Унікальний ордер ID транзакції в системі PSP Platon
`trans_date`	Час проведення транзакції в форматі UTC (YYYY-MM-DD HH-MM-SS)
`decline_reason`	Опис помилки

Expand

title	Callback при неуспешном списанииневдалій оплаті

Code Block

language	php

array (
  'action' => 'DEBIT_RUN',
  'result' => 'DECLINED',
  'status' => 'DECLINED',
  'order_id' => '4385323',
  'trans_id' => '28261-47789-28578',
  'trans_date' => '2020-02-25 07:12:58',
  "decline_reason":"Declined by processing"
  'hash' => '********************************',
)

Параметр	ОписаниеОпис
`action`	`DEBIT_RUN`
`result`	`DECLINED`
`status`	`DECLINED`
`order_id`	Уникальный Унікальний ордер ID транзакции транзакції в системе системі мерчанта
`trans_id`	Уникальный Унікальний ордер ID транзакции транзакції в системе системі PSP Platon
`trans_date`	Время проведения транзакции в формате Час проведення транзакції в форматі UTC (YYYY-MM-DD HH-MM-SS)
`decline_reason`	Описание ошибкиОпис помилки
`hash`Зашифрованная	подпись для проверки достоверности коллбекаЗашифрований підпис для перевірки достовірності коллбеку

Versions Compared

Old Version 27

New Version 28

Key

Зміст

Описание

Требования к сайту

API параметры №1

Опис

Вимоги

API параметри №1

API

параметри №2

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

Callback

Проміжна ініциалізація по API запиту №1:

Проміжний редірект на 3DS по API

запиту №2:

При

успішній оплаті:

При невдалій оплаті: