Вступление
Этот раздел описывает InternetCashPAY Платежный шлюз API.
InternetCashPAY API легко реализовать в вашем бизнес-программном обеспечении. Наш API хорошо отформатирован URL-адреса, принимает запросы скручиваемости, возвращает ответы JSON.
You can use the API in test mode, which does not affect your live data. The API key is use to authenticate the request and determines the request is valid payment or not. For test mode just use the sandbox URL and In case of live mode use the live URL from section Инициировать платеж .
Поддерживаемые валюты
В этом разделе описываются валюты, поддерживаемые InternetCashPAY
InternetCashPAY allows to make transaction with below currencies. Any new currency may update in future.
| Название валюты | Символ валюты | Код валюты |
|---|---|---|
| USD | $ | USD |
| EUR | € | EUR |
| GBP | £ | GBP |
| AED | Dh | AED |
| RUB | ₽ | RUB |
| USDT TRC20 | ₮ | USDT |
| CRC | ₡ | CRC |
| UAH | ₴ | UAH |
| BTC | ₿ | BTC |
Получить ключ API
Этот раздел описывает, как вы можете получить ключ API.
Войти в свой InternetCashPAY Торговый счет. If you don't have any ? Кликните сюда
Следующий шаг - найти API ключ Меню в боковой панели приборной панели. Нажмите на меню.
Ключи API можно найти там, что Открытый ключ и секретный ключ. Используйте эти клавиши для инициирования запроса API. Каждый раз, когда вы можете генерировать новую клавишу API, нажав Генерировать ключ API кнопка. Помните, не делитесь этими ключами ни с кем.
Инициировать платеж
В этом разделе описывается процесс первоначального платежа.
Чтобы инициировать платеж, следующую в следующем примере кода и будьте осторожны с подтверждениями. Вам нужно будет продать запрос с этими следующими конечными точками API.
Живая конечная точка: https://internetcashpay.com/payment/initiate
Тестовая точка: https://internetcashpay.com/sandbox/payment/initiate
Тестовый режим почты: test_mode@mail.com
Тестовый режим Код подтверждения: 222666
Способ запроса: POST
Запрос к конечной точке со следующими параметрами ниже.
| Имя парамента | Тип параметра | Описание |
|---|---|---|
| public_key | string (50) | Необходимый Ваш ключ от общественного API |
| identifier | string (20) | Необходимый Идентификатор в основном для выявления оплаты на вашем конце |
| currency | string (4) | Необходимый Код валюты, должен быть в верхнем регистре. например USD, EUR |
| amount | decimal | Необходимый Сумма платежа. |
| details | string (100) | Необходимый Детали вашего платежа или транзакции. |
| ipn_url | string | Необходимый URL мгновенного уведомления об оплате. |
| success_url | string | Необходимый Усознание успеха оплаты URL. |
| cancel_url | string | Необходимый Отказ отменить URL Redirect URL. |
| site_logo | string/url | Необходимый Ваш бизнес сайт логотип. |
| checkout_theme | string | По желанию Оформить заказ на тему темный / свет. |
| customer_name | string (30) | Необходимый Имя покупателя. |
| customer_email | string (30) | Необходимый Действительное клиента электронной почты. |
<?php
$parameters = [
'identifier' => 'DFU80XZIKS',
'currency' => 'USD',
'amount' => 100.00,
'details' => 'Purchase T-shirt',
'ipn_url' => 'http://example.com/ipn_url.php',
'cancel_url' => 'http://example.com/cancel_url.php',
'success_url' => 'http://example.com/success_url.php',
'public_key' => 'jkUiYUS9875VDLFJLDSAFJLDKSisad',
'site_logo' => 'http://example.com/logo_path/logo.png',
'checkout_theme' => 'dark',
'customer_name' => 'John Doe',
'customer_email' => 'john@mail.com',
]
//live end point
$url = 'http://example.com/payment/initiate';
//test end point
$url = 'http://example.com/sandbox/payment/initiate';
$ch = curl_init();
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POSTFIELDS, $parameters);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
curl_close($ch);
//$result contains the response back.
?>
//Error Response.
{
"error": "true",
"message": "Invalid api key"
}
//Success Response.
{
"success": "ok",
"message": "Payment Initiated. Redirect to url.",
"url":"http://example.com/initiate/payment/checkout?payment_id=eJSAASDxdrt4DASDASVNASJA7893232432cvmdsamnvASF"
}Проверьте платеж и IPN
В этом разделе описывается процесс, чтобы получить уведомление о мгновенном платеже.
Чтобы инициировать платеж, следующую в следующем примере кода и будьте осторожны с подтверждениями. Вам нужно будет продать запрос с этими следующими конечными точками API.
Конечная точка: Ваше деловое приложение IPN URL.
Способ запроса: POST
Вы получите следующие параметры ниже.
| Имя парамента | Описание |
|---|---|
| status | Статус успеха оплаты. |
| identifier | Идентификатор в основном для выявления оплаты на вашем конце. |
| signature | Хеш-сигнатура, чтобы подтвердить ваш платеж на вашем конце. |
| data | Данные содержат некоторую основную информацию с зарядами, суммой, валютой, идентификатором платежного транзакции и т. Д. |
<?php
//Receive the response parameter
$status = $_POST['status'];
$signature = $_POST['signature'];
$identifier = $_POST['identifier'];
$data = $_POST['data'];
// Generate your signature
$customKey = $data['amount'].$identifier;
$secret = 'YOUR_SECRET_KEY';
$mySignature = strtoupper(hash_hmac('sha256', $customKey , $secret));
$myIdentifier = 'YOUR_GIVEN_IDENTIFIER';
if($status == "success" && $signature == $mySignature && $identifier == $myIdentifier){
//your operation logic
}
?>