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


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

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

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

Демо страницы оплаты можно посмотреть по этой ссылке

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

Parameter Required Description
ShopId required Id магазина (ex: c4cfc3ed-d402-48fa-a99f-704fe0cc840f)
Amount required Сумма платежа (ex: 0.1234)
ShopOrderId required Номер счета на сайте продавца. Должен быть уникальным
SuccessUrl optional Сюда перенаправляется пользователь в случае успешной оплаты
ErrorUrl optional Сюда перенаправляется пользователь в случае неуспешной оплаты
StatusUrl optional URL для коллбека со статусом платежа

Пример формы

<form action="https://cashmost.com/payments/create/" method="post">
    <input type="hidden" name="ShopId" value="c4cfc3ed-d402-48fa-a99f-704fe0cc840f">
    <input type="hidden" name="Amount" value="0.002">
    <input type="hidden" name="ShopOrderId" value="123456">
</form>

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

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

Parameter Description
ShopId Id магазина (ex: c4cfc3ed-d402-48fa-a99f-704fe0cc840f)
Amount Сумма оплаченная покупателем (ex: 0.1234)
ShopOrderId Номер счета на сайте продавца.

Пример формы

<form action="https://myshop.com/success.html" method="post">
    <input type="hidden" name="ShopId" value="c4cfc3ed-d402-48fa-a99f-704fe0cc840f">
    <input type="hidden" name="Amount" value="0.002">
    <input type="hidden" name="ShopOrderId" value="123456">
</form>

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

Parameter Description
ShopId Id магазина (ex: c4cfc3ed-d402-48fa-a99f-704fe0cc840f)
Amount Сумма заказа (ex: 0.1234)
ShopOrderId Номер счета на сайте продавца.

Пример формы

<form action="https://myshop.com/fail.html" method="post">
    <input type="hidden" name="ShopId" value="c4cfc3ed-d402-48fa-a99f-704fe0cc840f">
    <input type="hidden" name="Amount" value="0.002">
    <input type="hidden" name="ShopOrderId" value="123456">
</form>

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

Parameter Description
ShopId Id магазина (ex: c4cfc3ed-d402-48fa-a99f-704fe0cc840f)
Amount Сумма оплаченная покупателем (ex: 0.1234)
ShopOrderId Номер счета на сайте продавца.
TransactionId Id транзакции в системе cashmost.com
Status Created, Cancelled, Payed, NotPayed
Comment optional
Sign HASH-строка, составленная из информации, содержащейся в данной форме.
Подписанная секретным ключем в стандартном формате HMAC-SHA512 для защиты

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

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

//ShopId:Amount:ShopOrderId:TransactionId:Status
$shopId=$_POST['ShopId'];
$amount=$_POST['Amount'];
$shopOrderId=$_POST['ShopOrderId'];
$sciSign=$_POST['Sign'];
$transactionId=$_POST['TransactionId'];
$status=$_POST['Status'];

$secret='xxx'; 
$str=$shopId.':'.$amount.':'.$shopOrderId.':'.$transactionId.':'.$status;
$sign=hash_hmac('sha512',$str,$secret); 
if($sign == $sciSign){
    //Process payment
}

Пример формы

<form action="https://myshop.com/status.html" method="post">
    <input type="hidden" name="ShopId" value="c4cfc3ed-d402-48fa-a99f-704fe0cc840f">
    <input type="hidden" name="Amount" value="0.002">
    <input type="hidden" name="ShopOrderId" value="c21186a8-87f4-46df-8eb4-b89ab4d41a91">
    <input type="hidden" name="Sign" value="3ddbf164e965f996b28a6aea68276cb744a17de8888b64ad5b243336e1b3b28fda78857009042d4a3b1ac77ba6a220cac40211f06c1001db6db467cddaf8afdc">
    <input type="hidden" name="TransactionId" value="123456789">
    <input type="hidden" name="Status" value="Payed">
    <input type="hidden" name="Comment" value="">
</form>