Page Comparison

Зміст

Table of Contents

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

Опис

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

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

Демо

Iframe

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

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

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

Вимоги

Expand

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

У вашого сайту має бути валідний SSL сертифікат.

Для перевірки валідності та терміну дії вашого SSL сертифіката рекомендуємо скористатися сервісом за посиланням.

Expand

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

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

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

Include Page

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

Expand

title	TLS 1.2

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

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

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

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

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

Info
Валідна пошта.

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

phone

Status

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

Number

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

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

req_token

Status

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

1

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

Для отримання card_token і його подальшого використання в інших методах.

url

Status

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

String

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

Max 1024 символи

first_name

Status

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

String

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

Max 32 символи

last_name

Status

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

String

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

Max 32 символи

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

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

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

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

state

Status

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

String

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

Стандарт 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 полі

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

Expand

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

Code Block

language	php

<?php 
  $data['client_key'] = '***';
  $data['client_pass'] = '***';
  $data['payment'] = 'C2A';
  $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>

Тестування

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

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

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

Expand

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

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

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

10 хв
30 хв
75 хв

Callback

Expand

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

Include Page

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

Expand

title	Безпека

Include Page

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

Include Page

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

Expand

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

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

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

order = 12345

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

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

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

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

Expand

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

Include Page

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

Versions Compared

Old Version 11

New Version Current

Key

Зміст

Опис

Демо

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

Вимоги

API параметри

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

Тестування

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

Callback

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

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