Документация по AnonPay

В этом документе подробно описывается, как использовать нашу AnonPay систему, и приводятся примеры для всех используемых запросов. На данный момент существует два способа использования AnonPay: в качестве прямой ссылки или в качестве ссылки для предварительного создания транзакции с последующей возможностью показать её конечному пользователю. В обоих способах используются одни и те же параметры, описанные ниже.

  • Прямой метод проще и не требует обработки на вашем веб-сайте, но некоторые детали транзакции, такие как адрес, сумма, могут быть изменены вашим пользователем, поэтому вы всегда должны подтверждать, что вы действительно получили платеж по правильному адресу.
  • При косвенном методе вы сначала создаете транзакцию со всеми желаемыми реквизитами и получаете ее идентификатор, и только затем отображаете ее своему пользователю. Это не позволяет пользователю что-либо менять и дает вам возможность проверить статус совершаемой транзакции, поскольку у вас уже есть идентификатор транзакции. Транзакции, созданные с использованием этого метода, должны выждать временной период в 72 часа, прежде чем они будут удалены из нашей базы данных.

Если вам необходимое контролировать все свои транзакции (или делать это вручную), вам следует использовать косвенный метод. В противном случае прямой метод проще и его легче интегрировать в ваш проект.

Транзакции с использованием AnonPay в настоящее время имеют лимит, эквивалентный 5 BTC на транзакцию, чтобы свести к минимуму задержки и риск прохождения KYC.

Когда монета, которую выбирает пользователь, совпадает с уже выбранной вами монетой, обмен отклоняется. Ваш пользователь информируется о сумме и адресе, на который он должен перевести средства. Trocador не взимает комиссию, и если вы согласились получить уведомления на электронную почту после завершения транзакции, то вы получите электронное письмо, когда транзакция будет создана, с информацией об этом, поскольку у нас нет возможности узнать, переведет ли пользователь монеты и когда переведёт.

Пока мы не принимаем фиатные платежи, но вы можете указать стоимость вашей транзакции в фиатной валюте (USD, EUR и т. д.), и мы автоматически используем текущий курс для конвертации суммы в эквивалент в выбранной вами монете. Для получения курсов фиатных валют мы используем CoinPaprika.

Для облегчения использования AnonPay воспользуйтесь нашим Платёжным генератором.

  • Поскольку спользуется метод GET, параметры должны быть добавлены после URL части адреса '/anonpay/', используя '?' для первого и '&' для последующих. Порядок параметров не важен.

    Примеры:
    https://trocador.app/anonpay/?ticker_to=xmr&network_to=Mainnet&address=XYZ

    • Требуемые параметры:
      -ticker_to: Тикер монеты, которую вы хотите получить. Например, btc, xmr, eth и т. д.;
      -network_to: Сеть монеты, которую вы хотите получить. Например, Основная сеть, ERC20, BEP20 и т. д.;
      -address: Адрес, на который вы хотите получить монеты. Например, 89Jb5....D1LdB12 для нашего адреса Monero;

    • Необязательные параметры:
      -amount: Для платежей это сумма, которую вы хотите получить, и она будет заблокирована. Для пожертвований это сумма, которую пользователь хочет пожертвовать;
      -memo: Если сеть монеты, которую вы хотите получить, использует мемо/дополнительный идентификатор, вам необходимо предоставить его с помощью этого параметра или использовать '0' для отказа от мемо/дополнительного идентификатора;
      -donation: Значение True активирует режим пожертвований, в противном случае по умолчанию используется режим оплаты;
      -direct: False заставит URL работать как API и вернет в ответ JSON с идентификатором созданной транзакции. Более подробная информация приведена ниже;
      -ticker_from: Если хотите, вы можете определить выбранную монету, которую пользователь будет переводить. Например, ticker_to это тикер монеты;
      -network_from: Если хотите, вы можете определить выбранную монету, которую пользователь будет переводить, так как network_to - это сеть монеты;
      -name: Имя, которое вы хотите отобразить на виджете. Специальные символы должны быть закодированы через URL ( 'A B' is 'A%20B');
      -description: Описание, которое появится на экране оформления заказа для оплаты/пожертвований. Специальные символы должны быть закодированы через URL ( 'A B' is 'A%20B');
      -referral: Если у вас есть реферальный код от нашей партнерской программы, вы можете использовать его здесь;
      -buttonbgcolor: Цвет кнопки должен быть в шестнадцатеричном формате без '#'. Например, ff0000 для красного;
      -textcolor: Цвет текста кнопки должен быть в шестнадцатеричном формате без '#'. Например, ffffff для белого;
      -bgcolor: Значение True сделает фон страницы серым, в противном случае она будет прозрачной/белой. Рекомендуется в том случае, если вы не будете использовать AnonPay в iframe. Вы можете использовать цвет в шестнадцатеричном формате без '#'. Например: 000000ff для черного цвета без эффекта прозрачности;
      -email: Электронный адрес почты на который вы получите подтверждение после завершения транзакции;
      -fiat_equiv: Если вы хотите, чтобы ваша транзакция была пересчитана в фиатной валюте, укажите действительную аббревиатуру валюты (например, USD или EUR). Обратите внимание, что вы получите средства в выбранной вами монете, а ваши клиенты будут платить в криптовалюте. На данный момент мы не принимаем фиатные платежи;
      -remove_direct_pay: Если вы не хотите, чтобы пользователь платил вам напрямую через AnonPay той монетой, которую вы выбрали для получения, вы можете установить этот параметр как True. Это полезно, если у вас есть другой более предпочтительный способ получения выбранной монеты, а вы хотите использовать AnonPay только для сторонних монет;
      -min_logpolicy: если вы хотите использовать только обменный сервис с минимальным рейтингом ведения журнала A, B, C или D, укажите этот параметр (необязательно);
      -editable: Позволяет пользователю изменить сумму к оплате, если установлено значение True;
      -webhook: если вы укажете в этом параметре URL-адрес, то каждый раз, когда статус транзакции измениться, вы будете получать POST-запрос, отправляющий вам новые данные о транзакции. Данный функционал позволяет избежать необходимости многократно обращаться к нашему серверу для проверки статуса транзакции (необязательно);
      -simple_mode: При установке значения True экран создания заказа будет значительно упрощен для удобства использования людьми, не знакомыми с криптовалютами;

  • Вы хотите получить 1.4LTC и электронное письмо после подтверждения о совершении оплаты за годовую подписку на ваш веб-сайт 'Супер Новости'.

    • Параметры:
      ticker_to: ltc
      network_to: Mainnet
      amount: 1.4
      name: Super%20News
      description: Annual%20Subscription
      email: mail@supernews.com
      address: ltc1q....fgsw

    • Результирующий URL-адрес:
      https://trocador.app/anonpay/?ticker_to=ltc&network_to=Mainnet&amount=1.4&name=Super%20News&description=Annual%20Subscription&email=mail@supernews.com&address=ltc1qzvcgmntglcuv4smv3lzj6k8szcvsrmvk0phrr9wfq8w493r096ssm2fgsw
  • У вас есть веб-сайт под названием 'Freedom Matters', и вы хотите получать пожертвования в Monero. Также вы хотите, чтобы на виджете была кнопка светло-голубого/фиолетового цвета и указана сумма 0.01BTC.

    • Параметры:
      ticker_to: xmr
      network_to: Mainnet
      amount: 0.01
      donation: True
      name: Freedom%20Matters
      address: 89Jb....dB12
      buttonbgcolor: 3315ff

    • Результирующий URL-адрес:
      https://trocador.app/anonpay/?ticker_to=xmr&network_to=Mainnet&amount=0.01&name=Freedom%20Matters&donation=True&buttonbgcolor=3315ff&address=83r6YnuwnsVXNvHmurMFYf3Urufw54rKic1Ka5ysgSv5Wvp1UrCi5UnB2vfQnxmmTp1W2JYqk452QAgqV83SpqK8D7xy7gd
  • Если вы решите использовать наш косвенный метод, создайте URL-адрес точно так же, как если бы вы использовали прямой метод, но добавьте параметр 'direct=False'. Когда вы вызовете этот URL, вы получите в ответ JSON с уникальным 'ID' сгенерированной транзакции и её URL.

    Чтобы проверить статус транзакции, вы можете использовать следующий URL-адрес конечной точки и получите в ответ JSON с его статусом: https://trocador.app/anonpay/status/<ID>

  • <iframe src="https://trocador.app/anonpay/?ticker_to=xmr&network_to=Mainnet&amount=0.1&address=83r6YnuwnsVXNvHmurMFYf3Urufw54rKic1Ka5ysgSv5Wvp1UrCi5UnB2vfQnxmmTp1W2JYqk452QAgqV83SpqK8D7xy7gd" width="300" height="290" scrolling="no" style="border:0;"></iframe>
  • Это все возможные статусы обмена, которые вы можете увидеть при использовании AnonPay.


    • - anonpaynew: сделка создана, но ни одна монета еще не выбрана для оплаты;
      - waiting: вы создали обмен, но депозит еще не был обнаружен;
      - confirming: депозит обнаружен, но еще не подтвержден;
      - sending: депозит подтвержден и поставщик отправляет монеты;
      - finished: уже есть хэш платежа для пользователя;
      - paid partially: уже существует хэш платежа для пользователя, но сумма ниже запрашиваемой;
      - failed: возможно, что с обменом что-то случилось, обратитесь в службу поддержки;
      - expired: время оплаты истекло;
      - halted: произошла какая-то проблема с обменом, пожалуйста, обратитесь в службу поддержки;
      - refunded: обменный сервис утверждает, что вернул деньги пользователю;