Базовые методы
Основные методы для получения информации о валютах и платежных шлюзах.
GET
/api/currencies
Получить список доступных валют
curl -X GET "https://payshark.cloud/api/currencies" \
-H "Accept: application/json" \
-H "Access-Token: your-api-key"$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://payshark.cloud/api/currencies",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
"Accept: application/json",
"Access-Token: your-api-key"
]
]);
$response = curl_exec($curl);
curl_close($curl);fetch('https://payshark.cloud/api/currencies', {
method: 'GET',
headers: {
'Accept': 'application/json',
'Access-Token': 'your-api-key'
}
}).then(response => response.json())
.then(data => console.log(data));Пример ответа:
{
"success": true,
"data": [
{
"currency": "rub",
"precision": 2,
"symbol": "₽",
"name": "Российский рубль"
}
]
}
GET
/api/payment-gateways
Получить список доступных платежных шлюзов
curl -X GET "https://payshark.cloud/api/payment-gateways" \
-H "Accept: application/json" \
-H "Access-Token: your-api-key"$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://payshark.cloud/api/payment-gateways",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
"Accept: application/json",
"Access-Token: your-api-key"
]
]);
$response = curl_exec($curl);
curl_close($curl);fetch('https://payshark.cloud/api/payment-gateways', {
method: 'GET',
headers: {
'Accept': 'application/json',
'Access-Token': 'your-api-key'
}
}).then(response => response.json())
.then(data => console.log(data));Пример ответа:
{
"success": true,
"data": [
{
"name": "Сбербанк",
"code": "sberbank",
"schema": "100000000111",
"currency": "rub",
"min_limit": "1000",
"max_limit": "100000",
"reservation_time": 10,
"detail_types": ["card", "phone", "account_number"]
}
]
}Merchant API - Создание сделки
Создание сделки через упрощенный Merchant API с получением платежной ссылки.
POST
/api/merchant/order
Создать новую сделку
Параметры запроса:
external_id *
string
ID сделки на вашей стороне (уникальный)
amount *
integer
Сумма сделки
merchant_id *
uuid
UUID мерчанта
payment_gateway
string
Код платежного шлюза
currency
string
Код валюты (альтернатива payment_gateway)
payment_detail_type
string
Тип реквизита: card, phone, account_number
callback_url
url
URL для уведомлений о смене статуса
curl -X POST "https://payshark.cloud/api/merchant/order" \
-H "Accept: application/json" \
-H "Access-Token: your-api-key" \
-H "Content-Type: application/json" \
-d '{
"external_id": "order_123",
"amount": 1000,
"merchant_id": "62cd94fa-bcc4-4311-86df-2668d8c8e04e",
"payment_gateway": "sberbank",
"payment_detail_type": "card",
"callback_url": "https://example.com/callback"
}'$data = [
'external_id' => 'order_123',
'amount' => 1000,
'merchant_id' => '62cd94fa-bcc4-4311-86df-2668d8c8e04e',
'payment_gateway' => 'sberbank',
'payment_detail_type' => 'card',
'callback_url' => 'https://example.com/callback'
];
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://payshark.cloud/api/merchant/order",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => json_encode($data),
CURLOPT_HTTPHEADER => [
"Accept: application/json",
"Access-Token: your-api-key",
"Content-Type: application/json"
]
]);
$response = curl_exec($curl);
curl_close($curl);const data = {
external_id: 'order_123',
amount: 1000,
merchant_id: '62cd94fa-bcc4-4311-86df-2668d8c8e04e',
payment_gateway: 'sberbank',
payment_detail_type: 'card',
callback_url: 'https://example.com/callback'
};
fetch('https://payshark.cloud/api/merchant/order', {
method: 'POST',
headers: {
'Accept': 'application/json',
'Access-Token': 'your-api-key',
'Content-Type': 'application/json'
},
body: JSON.stringify(data)
}).then(response => response.json())
.then(data => console.log(data));Пример ответа:
{
"success": true,
"data": {
"order_id": "4b3a163b-abc4-4311-86df-2668d8c8e04e",
"external_id": "order_123",
"merchant_id": "62cd94fa-bcc4-4311-86df-2668d8c8e04e",
"amount": "1000",
"currency": "rub",
"status": "pending",
"sub_status": "pending",
"payment_gateway": "sberbank",
"payment_gateway_name": "Сбербанк",
"payment_link": "https://payshark.cloud/payment/4b3a163b...",
"created_at": 1731375391,
"expires_at": 1731375451
}
}Статусы сделок
Подробное описание всех возможных статусов сделок в системе.
Основные статусы (status)
success
Операция успешно завершена
pending
Операция в ожидании обработки
fail
Операция завершилась неудачно
Подстатусы (sub_status)
accepted
Закрыт вручную
successfully_paid
Закрыт автоматически
waiting_for_payment
Ждет платежа
expired
Отменен по истечению времени
cancelled
Отменен вручную