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

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

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

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

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

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

While we don't yet accept fiat payments, you can define the value of your transaction in fiat (USD,EUR,etc.) and we'll automatically use the current rate to convert the amount into the equivalent in your chosen coin. We use CoinPaprika to get rates for fiat.

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

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

    Примеры:
    https://trocador.app/anonpay/?ticker_to=xmr&network_to=Mainnet&address=XYZ
    http://trocadorfyhlu27aefre5u7zri66gudtzdyelymftvr4yjwcxhfaqsid.onion/anonpay/?ticker_to=xmr&network_to=Mainnet&address=XYZ
    trocador.i2p/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. You can also use a color in hex format without the '#'. E.g. Example: 000000ff for black with no transparency;
      -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
  • У вас есть веб-сайт под названием 'Свобода имеет значение', и вы например хотите получать пожертвования в Monero, используя нашу onion-ссылку. Также вы хотите, чтобы виджет имел светло-синюю/фиолетовую кнопку и предустановленную сумму в 0.01BTC.

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

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

    Чтобы проверить статус транзакции, вы можете использовать следующую URL-точку (clearnet, либо onion), и в ответ получите 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>
  • These are all possible swap statuses you will find when using AnonPay.


    • - anonpaynew: the trade is created, but no coin was selected for payment yet;
      - waiting: вы создали обмен, но депозит еще не был обнаружен;
      - confirming: депозит обнаружен, но еще не подтвержден;
      - sending: депозит подтвержден и поставщик отправляет монеты;
      - finished: уже есть хэш платежа для пользователя;
      - paid partially: there is already a payment hash to the user, but the amount is lower than asked;
      - failed: возможно, что с обменом что-то случилось, обратитесь в службу поддержки;
      - expired: время оплаты истекло;
      - halted: произошла какая-то проблема с обменом, пожалуйста, обратитесь в службу поддержки;
      - refunded: биржа утверждает, что вернула деньги пользователю;