Page Comparison

Зміст

Table of Contents

minLevel	1
maxLevel	2
indent	0px
absoluteUrl	true
style	circle

Опис

Оплата по технології 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

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 символа

payer_state

Status

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

String

Штат платника

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

payer_city

Status

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

String

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

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

payer_zip

Status

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

String

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

Max 32 символи

payer_email

Status

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

String

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

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

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

Max 255 символа

payer_phone

Status

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

String

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

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

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

CVV код

В форматі "ХХХ"
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.
    )
  )
)

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

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 запиту №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"
}

Параметр

Опис

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

Зашифрований токен картки

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" }

Параметр

Опис

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

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

Include Page

	Callback / Response - DEBIT
	Callback / Response - DEBIT

Versions Compared

Old Version 28

New Version 29

Key

Зміст

Опис

Вимоги

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

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

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

Callback

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

Проміжний редірект на 3DS по API запиту №2:

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

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