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

Status

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

DEBIT_PREPARE

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

async

Status

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

Y
N

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

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

channel_id

Status

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

String

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

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

client_key

Status

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

String

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

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

order_id

Status

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

String

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

Max 32 символа

order_amount

Status

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

Number

Сумма платежа

Tip

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

1000.00

Warning

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

1000
1000.0
1,000.0
1,000.00

order_currency

Status

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

UAH

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

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

order_description

Status

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

String

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

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

Max 255 символов

payer_first_name

Status

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

String

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

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

payer_last_name

Status

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

String

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

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

payer_address

Status

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

String

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

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

payer_country

Status

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

String

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

Стандарт ISO 3166-1 alpha-2
В формате "ХХ"
2 символа
Укажите "NA", если нет данных

payer_state

Status

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

String

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

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

Стандарт ISO 3166-2
В формате "ХХ"
2 символа
Укажите "NA", если нет данных

payer_city

Status

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

String

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

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

payer_zip

Status

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

String

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

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

payer_email

Status

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

String

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

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

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

Max 255 символа

payer_phone

Status

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

String

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

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

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

payer_ip

Status

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

Number

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

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

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

card_number

Status

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

Number

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

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

card_exp_month

Status

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

Number

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

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

card_exp_year

Status

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

Number

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

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

card_cvv2

Status

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

Number

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

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

req_token

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

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

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.
    )
  )
)

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 платежа в системе Platon

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

card_cvv2

Status

colour	Green
title	Обязательно

Number

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

В формате "ХХХ"
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 запросу №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

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

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 транзакции в системе Platon
`trans_date`	Время проведения транзакции в формате UTC (YYYY-MM-DD HH-MM-SS)
`card_token`	Зашифрованный токен карты для последующих транзакций по card_token
`hash`	Зашифрованная подпись для проверки достоверности коллбека

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

Expand

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

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

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',
  'hash' => '********************************',
)

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

Versions Compared

Old Version 21

New Version 22

Key

Содержание

Описание

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

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

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

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

Callback

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

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

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

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