ADVCash
ip-адрес для подключения 188.166.193.161
Подключение сервиса ADVCash
Для работы данной интеграции необходимо подключить API в личном кабинете ADVCash. Для этого после входа в личный кабинет перейдите в раздел Бизнесу и выберите создать новый API
в качестве ip адреса укажите 188.166.193.161 (международный IP), задайте пароль и поставьте галочки на тех пунктах, что хотите использовать и нажмите сохранить
! Внимание, для пункта Выполнение транзакций требуется верификация. В процессе от вас потребуется подтвердить создание API через почту, указанную при регистрации.
Когда все будет готово, можете переходить в salebot и подключить эту интеграцию к своему проекту. Для этого вам потребуются:
Пароль указанный при создании api
Имя api
Почта, указанная при регистрации учетной записи
После всех этих действий можете использовать следующий функционал:
adv_cash_get_balances(): возвращает баланс по всем кошелькам
adv_cash_send_money(recipient, amount, currency, note): отправка перевода по id кошелька или мейлу аккаунта внутри платежной системы, возвращает id транзакции recipient - email учетной записи, на которую нужно выполнить перевод или кошелек внутри системы ADV Cash, amount - сумма перевода, currency - валюта перевода (3 символа ISO 4217, раздел “Валюты” в документации API), note - необязательный параметр, содержит текстовый комментарий к платежу (по умолчанию пуст)
adv_cash_send_money_to_card(card_number, expiry_month, expiry_year, phone, amount, currency, note): card_number - номер карты в виде строки, expiry_month - месяц, до которого действует карта (в виде числа), expiry_year - год, до которого действует карта (в виде числа), phone - телефонный номер держателя карты в виде строки, для РФ начинается с 8, а не +7(!), amount - сумма перевода, currency - валюта перевода (3 символа ISO 4217, раздел “Валюты” в документации API), note - необязательный параметр, содержит текстовый комментарий к платежу (по умолчанию пуст)
adv_cash_find_transaction(transaction_id): id транзакции из прошлых функций используется здесь, получаем полную информацию о транзакции, включая статус transaction_id - идентификатор транзакции
adv_cash_currency_exchange(amount, from_currency, to_currency, action, note): внутренний обмен валюты, позволяет переводить деньги между своими кошельками amount - сумма, при указании есть тонкости, связанные с параметром action, from_currency - из какой валюты нужно сделать перевод (3 символа ISO 4217, раздел “Валюты” в документации API), to_currency - в какую валюту нужно сделать перевод (3 символа ISO 4217, раздел “Валюты” в документации API), action - необязательный параметр, если не использовать, то будет применен параметр 'BUY', note - необязательный параметр, содержит текстовый комментарий к платежу (по умолчанию пуст)
!!! Важно !!!
Если параметр action не использовать самостоятельно, то по умолчанию будет применен 'BUY'. В таком случае будет куплено указанное в amount количество валюты из параметра to_currency за валюту из параметра from_currency.
Если вы хотите поменять фиксированное число валюты from_currency на валюту to_currency, то используйте в параметре action значение 'SELL'.
adv_cash_check_currency_exchange(amount, from_currency, to_currency, action): получение курса обмена валют, можно использовать для проверки хватит ли средств на обмен с желаемыми параметрами. amount - сумма, при указании есть тонкости, связанные с параметром action, from_currency - из какой валюты нужно сделать перевод (3 символа ISO 4217, раздел “Валюты” в документации API), to_currency - в какую валюту нужно сделать перевод (3 символа ISO 4217, раздел “Валюты” в документации API), action - необязательный параметр, если не использовать, то будет применен параметр 'BUY'
adv_cash_get_tariffs(): Получение информации о комиссий при выводе средств
adv_cash_create_crypto_invoice(amount, currency, ecurrency, receiver, note): создание инвойса на вывод с внутреннего кошелька на крипто-кошелек, вернет все параметры инвойса, включая id amount - сумма вывода, currency - валюта, которую тратим на покупку выводимой крипты из какой валюты нужно сделать перевод (3 символа ISO 4217, раздел “Валюты” в документации API), ecurrency - криптовалюта, которую хотим получить на криптокошелек (раздел “Электронные валюты” в документации API), receiver - идентификатор или кошелек получателя в сторонней платежной системе, note - необязательный параметр, содержит текстовый комментарий к платежу (по умолчанию пуст)
Созданный инвойс при выполнении купит криптовалюту на указанную сумму обычной валюты и отправит ее на указанный криптокошелек
adv_cash_find_crypto_invoice(invoice_id): поиск инвойса на вывод с внутреннего кошелька на крипто-кошелек, для получения статуса invoice_id - идентификатор инвойса, полученный при создании
adv_cash_confirm_crypto_invoice(invoice_id, receiver, destination_tag): подтверждение инвойса на вывод с внутреннего кошелька на крипто-кошелек, для выполнения платежа invoice_id - идентификатор инвойса, полученный при создании, receiver - идентификатор или кошелек получателя в сторонней платежной системе (нужно указывать тот же, что при создании), destination_tag - Тег Ripple
adv_cash_validate_send_money_to_email(amount, currency, email) - проверка есть ли пользователь с указанным мейлом среди пользователей платежки. amount - сумма currency - валюта email - проверяемый email Если пользователя с таким email не существует, то в ответ придет None, иначе придет ответ вида USER WITH EMAIL [test.testov@gmail.com] IS ALREADY REGISTERED. Также может быть получена ошибка от сервера платежки
adv_cash_send_money_to_email(amount, currency, email, note) - по сути отправка денег по email незарегистрированному пользователю. отличие от прошлой функции в необязательном параметре note - Примечание к транзакции. Если пользователь уже клиент, то придет ответ вида USER WITH EMAIL [test.testov@gmail.com] IS ALREADY REGISTERED и тогда для отправки денег нужно использовать другую функцию. В случае успеха функция вернет id транзакции и на указанный email уйдет письмо с ссылкой на регистрацию и получатель сможет получить деньги только зарегистрировавшись. Внимание!!! Эта функция не позволит добавить получателя как реферала.
Last updated
