Для карт (внутрибанк)

Метод запроса

POST

URL запроса

/v2/merchant/transactions/internal-card

Параметры запроса

Название	Формат	Описание
extId	string	Идентификатор транзакции клиента
currency	string(3-4)	Код валюты ISO 4217 (RUB, UZS и т.д.)
amount	decimal(20, 2)	Сумма (Максимум 2 знака после точки)
maxAmountIncrement (опционально)	int	Дельта, на которую может быть увеличена сумма
bank	string(1-255)	Название банка. Обязательное поле
callbackUrl (опционально)	string(1-255)	Адрес колбэка для транзакции
clientDetails.ip (опционально)	string	IP-адрес клиента
clientDetails.clientId (опционально)	string	Идентификатор клиента
clientDetails.lastName (опционально)	string	Фамилия клиента
clientDetails.firstName (опционально)	string	Имя клиента
clientDetails.secondName (опционально)	string	Отчество клиента
clientDetails.userAgent (опционально)	string	User-Agent браузера/устройства
clientDetails.email (опционально)	string	Электронная почта клиента

Пример запроса

CURL

curl --request POST \
  --url https://{{domain}}/v2/merchant/transactions \
  --header 'Authorization: Bearer {{your_api_token}}' \
  --header 'X-Signature: {{sign}}' \
  -d '{
  "extId": "123456789",
  "currency": "RUB",
  "amount": 100,
  "maxAmountIncrement": 5,
  "bank": "СберБанк",
  "callbackUrl": "https://webhook.site/#!/view/151a4e3c",
  "clientDetails": {
        "clientId": "777",
        "ip": "127.0.0.1",
        "lastName": "Test_Last",
        "firstName": "Test_First",
        "secondName": "Test_Second",
        "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/132.0.0.0 Safari/537.36",
        "email": "[email protected]"
    }
}'

PHP + GuzzleHttp

$httpClient = new \GuzzleHttp\Client();
$response = $httpClient->post('https://{{domain}}/v2/merchant/transactions', [
    'headers' => [
        'Authorization' => 'Bearer {{your_api_token}}',
        'X-Signature'   => '{{sign}}'
    ],
    'body' => "{\n  \"extId\": \"123456789\",\n  \"currency\": \"RUB\",\n  \"amount\": 100,\n  \"maxAmountIncrement\": 5,\n  \"bank\": \"СберБанк\"\n  \"callbackUrl\": \"https://webhook.site/#!/view/151a4e3c\"\n}"
]);

Параметры ответа

Название	Формат	Описание
id	int	Номер транзакции
cardNumber	string(1-255)	Номер карты
amount	decimal	Сумма транзакции
amountInUsdt	decimal	Сумма транзакции в USDT
commissionInUsdt	decimal	Коммисия в USDT
totalAmountInUsdt	decimal	Сумма транзакции c учётом комиссии в USDT (amountInUsdt - commissionInUsdt)
currency	string(3,4)	Код валюты ISO 4217 (RUB, UZS и т.д.)
currencyRate	decimal	Курс валюты
expiresAt	string(1-255)	Срок действия транзакции по карте (15 min)
owner	string(1-255)	Владелец карты
bankName	string(1-255)	Название банка
paymentMethod	string(1-255)	Метод проведения транзакции

Пример ответа

{
  "id": 1557,
  "cardNumber": "1111111111111111",
  "amount": 4000,
  "amountInUsdt": 43.11,
  "commissionInUsdt": 4.31,
  "totalAmountInUsdt": 38.8,
  "currency": "RUB",
  "currencyRate": 92.79,
  "expiresAt": "2024-08-30T01:18:57",
  "owner": "Иванов И.И.",
  "bankName": "Сбер",
  "paymentMethod": "Card"
}