Начало работы

• Введение
• Процесс оплаты
• Форма успешного выполнения платежа
• Форма "Платеж не выполнен"
• Форма "Статус платежа"

Введение

Для принятия платежей онлайн, вебсайт Продавца должен направить Покупателя в SCI Ezoex.com для выполнения платежа за продукты или услуги, заказанные им на вебсайте Продавца. После успешного выполнения платежа Покупатель перенаправляется обратно на вебсайт Продавца.

Полный процесс принятия платежей через SCI включает в себя следующие этапы:

1. Checkout page. Покупатель выбирает продукты или услуги в онлайн-магазине и решает приобрести их. Продавец отображает общую сумму стоимости покупки, и, в свою очередь, Покупатель начинает процесс оплаты заказа, нажимая на соответствующую ссылку. Вебсайт Продавца направляет Покупателя в SCI Ezoex.com
2. Invoice page. На этой странице Покупатель видит сумму платежа и адрес крипто кошелька для перевода монет. Данный этап позволяет Покупателю отменить платеж и он будет перенаправлен обратно на сайт Продавца.
3. Status processing page. После завершения платежа SCI отправляет форму «Статус платежа» на вебсайт Продавца. Покупателя не переводят обратно на вебсайт Продавца, поскольку эти данные передаются в фоновом режиме при помощи запроса POST через HTTP на страницу или модуль подтверждения платежа.
4. Result page. Если платеж выполнен успешно, пользователь увидит полные данные операции, включая Id операции. Нажав на ссылку «Продолжить», Покупатель переходит на страницу «Платеж успешно выполнен».
5. Success page. Эта страница находится на вебсайте Продавца, которая информирует Покупателя о том, что выполненный платеж был принят.
6. Failed page. Если платеж не был выполнен, Покупатель получает соответствующую применимую информацию об ошибке и, нажав на ссылку «Продолжить», переходит на страницу «Платеж не выполнен». Эта страница находится на вебсайте Продавца и информирует Покупателя о том, что платеж не был выполнен.

Процесс оплаты

Вам нужно направить Покупателя на вебсайт SCI Ezoex.com (и отправить POST форму запроса платежа) по следующему URL-адресу: https://ezoex.com/en/payonline

Payment Request Form - это форма в формате HTML для запроса платежа, которая генерируется вебсайтом Продавца и используется для передачи данных в SCI Ezoex.com

В таблице ниже указанные все приемлемые поля для формы HTML для надлежащего взаимодействия с SCI.

Пример формы

<form action="https://ezoex.com/en/payonline/" method="post">
<input type="hidden" name="SellerId" value="G95ExBbQekauE8Dna4V10w64IfbB17FEqaX">
<input type="hidden" name="CurrencyId" value="ETH">
<input type="hidden" name="Amount" value="0,002">
<input type="hidden" name="ClientId" value="c21186a8-87f4-46df-8eb4-b89ab4d41a91">
</form>

Форма успешного выполнения платежа – это форма в формате HTML, которая генерируется и отправляется SCI для отражения на странице успешного выполнения платежа Продавца (Success URL). Эта форма представляет собой набор скрытых полей, содержащих информацию о выполненном платеже. В таблице ниже приведены описания полей.

Note: Пожалуйста, не используйте эту форму для обработки платежа, это может быть не безопасно. Для обработки используйте форму "Статус платежа"

Пример формы

<form action="https://myshop.com/success.html" method="post">
<input type="hidden" name="ShopName" value="My Shop">
<input type="hidden" name="CurrencyId" value="ETH">
<input type="hidden" name="Amount" value="0,002">
<input type="hidden" name="ClientId" value="c21186a8-87f4-46df-8eb4-b89ab4d41a91">
</form>

Форма "Платеж не выполнен" – это форма в формате HTML, которая отправляется SCI для отражения на вебсайте Продавца (Fail URL) в случае невыполнения платежа. Эта форма представляет собой набор скрытых полей, содержащих ключевую информацию о платеже, которая должна была быть получена Продавцом.

Пример формы

<form action="https://myshop.com/fail.html" method="post">
<input type="hidden" name="ShopName" value="My Shop">
<input type="hidden" name="CurrencyId" value="ETH">
<input type="hidden" name="Amount" value="0,002">
<input type="hidden" name="ClientId" value="c21186a8-87f4-46df-8eb4-b89ab4d41a91">
</form>

Форма "Статус платежа" – это форма в формате HTML, которая отправляется SCI на страницу или модуль подтверждения платежа Продавца (Status URL). Эта форма представляет собой набор скрытых полей, содержащих информацию о выполненном платеже. В таблице ниже приведены описания полей.

Note: SCI будет отправлять данную форму при изменении количества подтверждений транзакции до тех пор пока Платеж не получит статус "Paid"

Формирование подписи

Для генерирования цифровой подписи (Sign) Вам необходимо объединить следующие параметры Формы «Статус платежа» в следующем порядке

//ShopName:CurrencyId:Amount:ClientId:TxId:Status
$shopName=$_POST['ShopName'];
$currencyId=$_POST['CurrencyId'];
$amount=$_POST['Amount'];
$clientId=$_POST['ClientId'];
$sciSign=$_POST['Sign'];
$txId=$_POST['TxId'];
$status=$_POST['Status'];

$apisecret='xxx'; 
$str=$shopName.':'.$currencyId.':'.$amount.':'.$clientId.':'.$txId.':'.$status;
$sign=hash_hmac('sha512',$str,$apisecret); 
if($sign == $sciSign){
    //Process payment
}

Пример формы

<form action="https://myshop.com/status.html" method="post">
<input type="hidden" name="ShopName" value="My Shop">
<input type="hidden" name="CurrencyId" value="ETH">
<input type="hidden" name="Amount" value="0,002">
<input type="hidden" name="ClientId" value="c21186a8-87f4-46df-8eb4-b89ab4d41a91">
<input type="hidden" name="Sign" value="3ddbf164e965f996b28a6aea68276cb744a17de8888b64ad5b243336e1b3b28fda78857009042d4a3b1ac77ba6a220cac40211f06c1001db6db467cddaf8afdc">
<input type="hidden" name="TxId" value="0x65dd491b24a67d6a80a7e6ccec1246d28e4caab327d8ea322333ba17144c2c8f">
<input type="hidden" name="Confirmations" value="2">
<input type="hidden" name="Status" value="WaitConfirm">
</form>