Перейти к содержанию

Создание операции выплаты


Описание

Используется для создания операции выплаты.

POST (Уровень доступа: Базовый, PCI/DSS)

https://api.intellectmoney.ru/personal/payout/createOperation

Заголовки запроса

Параметр Свойства Описание
Accept STRING OPTIONAL application/json Заголовок, указывающий формат данных, которые клиент хочет получить от сервера.
Content-Type STRING OPTIONAL application/json application/xml Заголовок, указывающий формат данных в теле запроса.
Authorization STRING REQUIRED Bearer {token} Заголовок, используемый для аутентификации клиента с помощью Bearer токена.
Подробнее об использование Bearer токена.
Sign STRING REQUIRED Заголовок с подписью для аутентификации запроса.

Сигнатура подписи:
UserToken::PreferenceType::Pan::Account::BankId::Amount::Currency::RecipientName::EshopId::SignSecretKey

Тело запроса

Параметр Свойства Описание
UserToken STRING REQUIRED Токен пользователя.
Для получения использовать метод GetUserToken.
PreferenceType STRING REQUIRED const Способ выплаты.
Допустимые значения:
  1. OutBankCard - банковская карта.
  2. OutSbp - СБП.
Pan STRING CONDITION max 20 Номер банковской карты получателя.
Условия:
  • Передается обязательно если параметр PreferenceType = OutBankCard.
  • Не передается в остальных случаях.
Account STRING CONDITION Номер телефона получателя.
Условия:
  • Передается обязательно если параметр PreferenceType = OutSbp.
  • Не передается в остальных случаях.
BankId STRING CONDITION Номер банка СБП.
Условия:
  • Передается обязательно если параметр PreferenceType = OutSbp.
  • Не передается в остальных случаях.
Amount STRING REQUIRED max 13 Сумма выплаты.
Формат: десятичное число с двумя знаками после точки, не использовать запятые и пробелы.
Currency STRING REQUIRED const Валюта выплаты.
Допустимые значения:
  1. RUB - для платежей в рублях.
  2. TST - для тестовых платежей.
RecipientName STRING OPTIONAL max 255 ФИО получателя.
EshopId STRING OPTIONAL max 6 Номер магазина.
Можно найти в личном кабинете, в разделе магазины.
Description STRING OPTIONAL max 255 Основание выплаты.

Тело ответа

Поле Тип Описание
OperationState OperationState Статус выполнения операции.
OperationId GUID Идентификатор операции.
EshopId INT Номер магазина.
Result PayoutOperationData Результат выполнения запроса.
Примеры кода
C#
var client = new HttpClient();

var request = new HttpRequestMessage(HttpMethod.Post, "https://api.intellectmoney.ru/personal/payout/createOperation");

request.Headers.Add("Accept", "application/json");
request.Headers.Add("Content-Type", "application/json");
request.Headers.Add("Authorization", "Bearer 9d97820c61424eb6ac0db414ccb7ac60");
request.Headers.Add("Sign", "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855");

var collection = new List<KeyValuePair<string, string>>();
collection.Add(new("UserToken", "YdUlqkFcVo62XmY6B9VLJXCoAeA/0fJPxD4/kUUGmwHf5kgBa12MrKUyJd8uO0za"));
collection.Add(new("PreferenceType", "OutBankCard"));
collection.Add(new("Pan", "212121******2121"));
collection.Add(new("Amount", "100.00"));
collection.Add(new("Currency", "RUB"));
collection.Add(new("RecipientName", "Иванов Иван Иванович"));
var content = new FormUrlEncodedContent(collection);
request.Content = content;
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());
PHP
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => 'https://api.intellectmoney.ru/personal/payout/createOperation',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => '',
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 0,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_POSTFIELDS => 'UserToken=YdUlqkFcVo62XmY6B9VLJXCoAeA/0fJPxD4/kUUGmwHf5kgBa12MrKUyJd8uO0za&PreferenceType=OutBankCard&Pan=212121******2121&Amount=100.00&Currency=RUB&RecipientName=Иванов Иван Иванович',
    CURLOPT_HTTPHEADER => array(
        'Accept: application/json',
        'Content-Type: application/json',
        'Authorization: Bearer 9d97820c61424eb6ac0db414ccb7ac60',
        'Sign: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855',
   ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;
Пример ответов
JSON
{
    "OperationState": {
        "Code": 0,
        "Desc": "Успешно обработана"
    },
    "Result": {
        "State": {
            "Code": 0,
            "Desc": "Успешно обработан"
        },
        "PayoutOperationId": "aaaaaaaa-bbbb-4ccc-8ddd-eeeeeeeeeeee",
        "PayoutOperationState": "Created"
    }
}
JSON
{
    "OperationState": {
        "Code": 2,
        "Desc": "Не переданы реквизиты для выплаты"
    },
    "Result": false
}