Page Comparison

Panel

bgColor	#EAE6FF

Зміст

Table of Contents

minLevel	1
maxLevel	2
include
outline	false
indent	0px
style	circle
exclude
type	list
class
printable	false

Panel

bgColor	#EAE6FF

Опис

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

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

Panel

bgColor	#EAE6FF

Демо

Iframe

scrolling	no
src	https://devplaton.com.ua/invoices/demo_buttons/payment_C2A.php
width	570
frameborder	hide
height	55

Panel

bgColor	#EAE6FF

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

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

Panel

bgColor	#EAE6FF

Вимоги

Include Page

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

Panel

bgColor	#EAE6FF

API параметри

HTTP METHOD: POST

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

Параметр

Значення

Опис

Особливості

key

Status

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

String

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

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

payment

Status

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

C2A,CC

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

amount

Status

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

Number

Сума оплати

Tip

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

1000.00

Warning

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

1000
1000.0
1,000.0
1,000.00

currency

Status

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

UAH

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

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

description

Status

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

String

Опис оплати

Max 255 символів

order

Status

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

String

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

Max 32 символа

email

Status

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

String

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

phone

Status

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

Number

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

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

Max 255 символів

req_token

Status

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

1

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

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

first_name

Status

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

String

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

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

Max 32 символа

last_name

Status

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

String

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

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

Max 32 символа

url

Status

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

String

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

Max 1024 символа

sign

Status

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

String

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

Code Block

language	php

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

error_url

Status

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

String

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

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

Max 1024 символа

address

Status

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

String

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

Max 255 символа

zip

Status

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

String

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

Max 32 символа

city

Status

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

String

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

Max 32 символа

country

Status

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

String

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

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

state

Status

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

String

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

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

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

lang

Status

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

UK
EN

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

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

formid

Status

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

String

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

Max 255 символів

itn

Status

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

String

ІПН платника

ext1, ext2, ext3, ext4

Status

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

String

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

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

Panel

bgColor	#EAE6FF

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

Expand

title	Приклад запиту на PHP

Code Block

language	php

<?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>

Panel

bgColor	#EAE6FF

Тестування

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

Panel

bgColor	#EAE6FF

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

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

Expand

title	Альтернативний час платіжної сесії

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

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

10 хв
30 хв
75 хв

Panel

bgColor	#EAE6FF

Перевірка платежів

Expand

title	Список методів отримання статусу транзакції

Include Page

	Отримання результату транзакції
	Отримання результату транзакції

Panel

bgColor	#EAE6FF

Callback

Expand

title	Особливості роботи з Callback

Include Page

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

Expand

title	Безпека

Include Page

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

Include Page

	Callback / Response - C2A та С2AT
	Callback / Response - C2A та С2AT

Include Page

	Callback / Response - СС та CCT
	Callback / Response - СС та CCT

Expand

title	Приклад GET параметрів

Tip
Платника буде відправлено за посиланням вказаним вами в параметр `url` з додаванням `order` методом GET

url = https://www.google.com/

order = 12345

Клієнта відправить після успішної оплати на https://www.google.com/?order=12345

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

Note
При невдалій оплаті Callback не відправляється.

Panel

bgColor	#EAE6FF

Помилки запитів

Expand

title	Список помилок та рішень

Include Page

	Помилки та рішення при запитах
	Помилки та рішення при запитах

Versions Compared

Old Version 62

New Version Current

Key

Зміст

Опис

Демо

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

Вимоги

API параметри

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

Тестування

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

Перевірка платежів

Callback

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

Помилки запитів