➕Создание заявки на вывод

Любой вывод средств начинается с создания заявки на вывод. Сразу после создания заявка будет находиться в статусе "Обработка" до тех пор, пока не осуществится вывод.

В случае успешного вывода, заявка перейдет в один из статусов, соответствующих реальной сумме вывода:

• Оплачено. Оплата произошла копейка в копейку, согласно сумме в заявке. Обычно именно так и происходит.

• Частично оплачено. Иногда бывает так, что невозможно осуществить оплату в полном объеме. Например у клиента лимит 600к в месяц, при этом 550к из этого лимита уже было использовано. Если создать заявку на перевод 100к этому клиенту, а перевод будет выполняться двумя платежами по 50к рублей, то первые 50к пройдут, а вторые уже заблокируются. В этом случае платеж будет закрыт со статусом "частично оплачено", а остаток средств будет возвращен к вам на баланс.

Наша система поддерживает множество различных методов вывода и детали по каждому из них описаны в соответствующем разделе.

Внимание!!! Когда речь идет об обменных операциях, вы обязаны предоставить расширенные данные по операции. Они предоставляются независимо от метода вывода.

Название	Обяз.	Формат	Описание
ext_txn		string(1-255)	Идентификатор операции на вашем сайте.
ext_date		string(1-255)	Дата и время операции, пример "2020-01-01T00:00:00"
ext_phone		string(1-255)	Номер телефона конечного клиента
ext_photo		string(1-255)	Ссылка на верификационное фото клиента. Рекомендуем защитить ссылку паролем, который будет знать только наша служба поддержки
ext_last_name		string(1-255)	Фамилия конечного клиента
ext_first_name		string(1-255)	Имя конечного клиента
ext_middle_name		string(1-255)	Отчество конечного клиента
ext_email		string(1-255)	Email конечного клиента
ext_ip		string(1-255)	IP-адрес конечного клиента
ext_user_agent		string(1-255)	User-agent конечного клиентам
ext_sender_system		string(1-255)	Платежная система отправителя средств, например Payeer EUR
ext_sender		string(1-255)	Аккаунт клиента в платежной системе отправителя, например P121321
ext_c_from		string(1-255)	Код валюты платежной системы согласно bestchange, например PEUR (см.Описание формата экспортного файла курсов – информационная статья

Внимание! Если вы не можете передать значение каких-то ext_*** - полей, то не нужно передавать их вовсе. Пустые значения полей будут отбиваться ошибкой валидации.

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

Допустим вы являетесь обменным пунктом obmen.ru. К вам обратился клиент 22 декабря 2022 г в 09:00 по МСК по вопросу обмена 1000 рублей ( с карты 516872*****1234, банк СберБанк ) на 10 USDT TRC20 ( кошелек TJcP****JxoCr ) . В вашей системе эта сделка зарегистрирована под номером V-123. Клиент: Семенов Борис, телефон [phone], email - [e-mail], user_agent - Mozilla/5.0 (Linux; Android 8.1.0;Redmi 5 Plus) AppleWebKit/537.36 (KHTML, like Gecko)Chrome/76.0.3809.132 MobileSafari/537.36, ip- 141.101.155.45

CURL

curl --request POST \
  --url https://{{your_api_domain}}/api/v2/deposit/card \
  --header 'Authorization: Bearer {{your_api_token}}' \
  --header 'Content-Type: application/json' \
  --data '{
  "order_id": "IN_V-123",
  "site_account": "sber",
  "amount": "1000.00",
  "method": "card",
  "ext_txn": "V-123",
  "ext_ip": "141.101.155.45",
  "ext_date": "2022-12-22T09:00:00",
  "ext_phone": "79252605905",
  "ext_photo": "https://obmen.ru/photos/3e625939-ed2a-4ea1-8fab-08a048948777.jpg",
  "ext_last_name": "Семенов",
  "ext_first_name": "Борис",
  "ext_middle_name": "Алексеевич",
  "ext_email": "[e-mail]",
  "ext_user_agent": "Mozilla/5.0 (Linux; Android 8.1.0; Redmi 5 Plus) AppleWebKit/537.36 (KHTML, like Gecko)Chrome/76.0.3809.132 Mobile Safari/537.36",
  "ext_sender": "516872*****1234",
  "ext_sender_system": "СберБанк",
  "ext_c_from": "RUB"  
}'

PHP + Guzzle

$httpClient = new \GuzzleHttp\Client();
$response = $httpClient->post('https://{{your_api_domain}}/api/v2/deposit/card', [
    'json' => [
        'order_id'             => 'IN_V-123',
        'site_account'         => 'sber',
        'amount'               => '100.00',
        'method'               => 'card',
        'ext_txn'              => 'V-123',
        'ext_ip'               => '141.101.155.45',
        'ext_date'             => '2022-12-22T09:00:00',
        'ext_phone'            => '79252605905',
        'ext_photo'            => 'https://obmen.ru/photos/3e625939-ed2a-4ea1-8fab-08a048948777.jpg',
        'ext_last_name'        => 'Семенов',
        'ext_first_name'       => 'Борис',
        'ext_middle_name'      => 'Алексеевич',
        'ext_email'            => '[e-mail]',
        'ext_user_agent'       => 'Mozilla/5.0 (Linux; Android 8.1.0; Redmi 5 Plus) AppleWebKit/537.36 (KHTML, like Gecko)Chrome/76.0.3809.132 Mobile Safari/537.36',
        'ext_sender'           => '516872*****1234',
        'ext_sender_system"    => 'СберБанк',
        'ext_c_from'           => 'USDT-TRC20',
    ],
    'headers' => [
        'Authorization' => 'Bearer ' . $yourApiToken,
    ]
]);