ADVCash
ip-адрес для подключения 104.248.248.165
Для работы данной интеграции необходимо подключить API в личном кабинете ADVCash. Для этого после входа в личный кабинет перейдите в раздел Бизнесу и выберите создать новый API
в качестве ip адреса укажите 188.166.193.161, 167.99.129.189, 104.248.248.165, задайте пароль и поставьте галочки на тех пунктах, что хотите использовать и нажмите сохранить
! Внимание, для пункта Выполнение транзакций требуется верификация. В процессе от вас потребуется подтвердить создание API через почту, указанную при регистрации.
Когда все будет готово, можете переходить в salebot и подключить эту интеграцию к своему проекту. Для этого вам потребуются:
- 1.Пароль указанный при создании api
- 2.Имя api
- 3.Почта, указанная при регистрации учетной записи
После всех этих действий можете использовать следующий функционал:
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 [[email protected]] IS ALREADY REGISTERED. Также может быть получена ошибка от сервера платежки
adv_cash_send_money_to_email(amount, currency, email, note) - по сути отправка денег по email незарегистрированному пол ьзователю. отличие от прошлой функции в необязательном параметре note - Примечание к транзакции. Если пользователь уже клиент, то придет ответ вида USER WITH EMAIL [[email protected]] IS ALREADY REGISTERED и тогда для отправки денег нужно использовать другую функцию. В случае успеха функция вернет id транзакции и на указанный email уйдет письмо с ссылкой на регистрацию и получатель сможет получить деньги только зарегистрировавшись.
Внимание!!! Эта функция не позволит добавить получателя как реферала.
Last modified 7mo ago