Online payments (Shopping Cart Interface (SCI)) – это часть системы Ezoex.com, которая позволяет осуществлять криптовалютные платежи со счета Покупателя на аккаунт Продавца. Она используется для обработки платежей за продукты или услуги, предлагаемые Продавцом. В SCI и на вебсайте Продавца используются простые формы в формате HTML для передачи необходимой информации между SCI и вебсайтом Продавца, что позволяет Покупателю выполнять перевод платежа, а Продавцу – получать и надлежащим образом обрабатывать полученный платеж.
Manage SCI keysДля принятия платежей онлайн, вебсайт Продавца должен направить Покупателя в SCI Ezoex.com для выполнения платежа за продукты или услуги, заказанные им на вебсайте Продавца. После успешного выполнения платежа Покупатель перенаправляется обратно на вебсайт Продавца.
Полный процесс принятия платежей через SCI включает в себя следующие этапы:
Вам нужно направить Покупателя на вебсайт SCI Ezoex.com (и отправить POST форму запроса платежа) по следующему URL-адресу: https://ezoex.com/en/payonline
Payment Request Form - это форма в формате HTML для запроса платежа, которая генерируется вебсайтом Продавца и используется для передачи данных в SCI Ezoex.com
В таблице ниже указанные все приемлемые поля для формы HTML для надлежащего взаимодействия с SCI.
Parameter | Required | Description |
---|---|---|
ShopName |
required | Название магазина (ex: My Shop) |
SellerId |
required | SCI api key Продавца. Генерируется во время создания ключа |
CurrencyId |
required | строка (ex: BTC) |
Amount |
required | Сумма платежа (ex: 0.1234) |
ClientId |
required | Номер счета на сайте продавца. Должен быть уникальным |
<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: Пожалуйста, не используйте эту форму для обработки платежа, это может быть не безопасно. Для обработки используйте форму "Статус платежа"
Parameter | Description |
---|---|
ShopName |
Название магазина (ex: My Shop) |
CurrencyId |
строка (ex: BTC) |
Amount |
Сумма оплаченная покупателем (ex: 0.1234) |
ClientId |
Номер счета на сайте продавца. |
<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) в случае невыполнения платежа. Эта форма представляет собой набор скрытых полей, содержащих ключевую информацию о платеже, которая должна была быть получена Продавцом.
Parameter | Description |
---|---|
ShopName |
Название магазина (ex: My Shop) |
CurrencyId |
строка (ex: BTC) |
Amount |
Сумма заказа (ex: 0.1234) |
ClientId |
Номер счета на сайте продавца. |
<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"
Parameter | Description |
---|---|
ShopName |
Название магазина (ex: My Shop) |
CurrencyId |
строка (ex: BTC) |
Amount |
Сумма оплаченная покупателем (ex: 0.1234) |
ClientId |
Номер счета на сайте продавца. |
TxId |
Id транзакции в блокчейне |
Confirmations |
Количество подтверждений в блокчейне |
Status |
Created, Cancelled, WaitConfirm, Paid |
Sign |
HASH-строка, составленная из информации, содержащейся в данной форме, подписанная секретным ключем в стандартном формате HMAC-SHA512 для защиты |
Для генерирования цифровой подписи (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>