1. Регистрация на сайте: Начинаете с создания аккаунта на платформе, для этого пишите в наш официальный ТГ аккаунт.
2. Создание кассы:
Перейдите в меню "Кассы".
Создайте кассу для вашего домена.
Пройдите процесс модерации и ожидайте результата.
3. Получение ключей:
После успешной модерации вам будут доступны client_id и client_secret, которые отображаются в настройках кассы.
4. Инициация оплаты:
Чтобы начать процесс оплаты, перенаправьте клиента на форму с нужными параметрами:
https://twinpay.cloud/payments/create?client_id=<CLIENT_ID>&amount=1.00
Обязательно укажите переменные:
client_id — полученный ранее ключ.
amount — сумма для оплаты (десятичное число с точкой, например, 8.44).
Опционально:
order_id — идентификатор заказа (целое число).
user_id — идентификатор пользователя.
description — краткое описание платежа (до 512 символов).
URL для успешной и неуспешной оплаты (success_url, fail_url).
currency — код валюты по ISO 4217 (по умолчанию USD).
country, client_email, client_ip — дополнительные необязательные параметры.
Параметр json для получения JSON-ответа (если установлен).
Коды валют: USD - 840, RUB - 643, EUR - 978, UAH - 980.
Обработка платежа:
После завершения оплаты ваш Callback URI получит POST-запрос с данными о платеже в формате JSON, включая:
order_id, id, status, amount, amount_fee, actual_amount, client_id, description, card, comment, signature.
Пример генерации подписи:
$signature = base64_encode(sha1($amount ."|". $client_id ."|". $client_secret));
Обработка PHP:
$post = json_decode($_POST["payment"]);
$order_id = $post->order_id; Нотификации отправляются с определенных IP-адресов.
Повторная отправка Callback:
Для повторной отправки Callback зайдите в информацию о платеже в вашем кабинете и нажмите кнопку "Отправить Callback".
Тестовая среда:
Для тестирования свяжитесь с технической поддержкой для активации метода TEST_EUR.
Генерируйте тестовые ссылки с кодом валюты EUR (978).
Тестовые номера карт:
Успешный платеж: 4141999977771111.
Отмена платежа: 4141999977772222.