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

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

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

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

• Частично оплачено. Если ваш клиент недоплатил какую-то часть суммы. Например в заявке было указано 100 рублей 49 копеек, а клиент оплатил ровно 100 рублей. Чаще всего такая ситуация бывает с P2P методами. Иногда бывает так что вместо 10 тысяч рублей была оплачена всего 1 тысяча, поскольку клиент запутался в нулях.

• Переплата. Если ваш клиент переплатил какую-то часть суммы. Например в заявке было указано 100 рублей 49 копеек, а клиент заплатил 101 рубль. Иногда бывают и более серьезные переплаты.

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

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

Название	Обяз.	Формат	Описание
account		string(1-255)	Номер карты плательщика
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_recipient_system		string(1-255)	Платежная система получателя, например Payeer EUR
ext_recipient		string(1-255)	Аккаунт конечного клиента в платежной системе получателя, например P121321
ext_c_to		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",
  "account": "51xxxx",
  "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_recipient": "TJcP****JxoCr",
  "ext_recipient_system": "Tether USDT TRC20",
  "ext_c_to": "USDT-TRC20"  
}'

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',
        'account'              => '51xxxxx',
        '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_recipient'        => 'TJcP****JxoCr',
        'ext_recipient_system" => 'Tether USDT TRC20',
        'ext_c_to'             => 'USDT-TRC20',
    ],
    'headers' => [
        'Authorization' => 'Bearer ' . $yourApiToken,
    ]
]);