Documentación de la API

Este documento detalla cómo usar nuestro sistema AnonPay y proporciona algunos ejemplos para ilustrar mejor su uso. Hay dos formas de utilizar AnonPay, como enlace directo o como enlace para generar primero la transacción y luego mostrarla al usuario final. Ambas formas usan los mismos parametros descritos a continuacion.

  • El método directo es más sencillo y no implica ningún proceso de backend en su sitio web, pero los datos de la transacción, como la dirección, el importe y otros, podrían ser modificados por el usuario, por lo que siempre debe confirmar que ha recibido el pago en la dirección correcta.
  • Con el método indirecto, usted crea primero la transacción con todos los detalles deseados y recibe su ID, y sólo entonces se lo muestra a su usuario. Esto previene que ellos cambien algo y le da a usted una manera de chequear el estado de su transaccion ya que usted ya tiene el ID de la transaccion. Las transacciones creadas por este método tienen 72 horas para iniciarse antes de ser eliminadas de nuestra base de datos.

Si necesita un mayor control sobre sus transacciones y se siente cómodo programando (o haciéndolo manualmente), debería utilizar el método indirecto. Por lo demás, el método directo es más sencillo y más fácil de integrar en su proyecto.

Las transacciones que utilizan AnonPay tienen actualmente un límite equivalente a 5BTC por transacción, para minimizar los retrasos y el riesgo KYC.

Cuando la moneda elegida por el usuario es la misma que la moneda elegida por usted, no hay que realizar ninguna transacción, por lo que simplemente se informa a su usuario de la cantidad y la dirección a la que debe transferir. Trocador no cobra comisiones por esto y si eliges recibir un correo electrónico cuando se complete la transacción, recibirás un correo electrónico cuando se cree la transacción informándote de esto, ya que no tenemos forma de saber si el usuario te transfiere las monedas o cuándo lo hace.

Si bien todavía no aceptamos pagos fiat, puede definir el valor de su transacción en fiat (USD, EUR, etc.) y usaremos automáticamente la tasa actual para convertir el monto al equivalente en la moneda elegida. Usamos CoinPaprika para obtener tasas de fiat.

Para una manera aún más sencilla de utilizar AnonPay, use nuestro Generador de pagos.

  • Como se utiliza el método GET, los parámetros deben añadirse después de la parte '/anonpay/' de la url, utilizando '?' para el primero que se use y '&' para el resto. El orden de los parámetros no es importante.

    Ejemplos
    https://trocador.app/anonpay/?ticker_to=xmr&network_to=Mainnet&address=XYZ

    • Parámetros de Referidos
      -ticker_to: El ticker de la moneda que desea obtener, por ejemplo, btc, xmr, eth, etc.;
      -network_to: La red de la moneda que desea recibir. P.ej. Mainnet, ERC20, BEP20, etc.;
      -address: La dirección en la que desea recibir. Por ejemplo, 89Jb5....D1LdB12 para nuestra dirección Monero.;

    • Parámetros opcionales:
      -amount: Para pagos es la cantidad de la moneda que quieres recibir y quedará bloqueada. Para donaciones es la cantidad preestablecida de la moneda que el usuario donará;
      -memo: Si la red de la moneda que desea recibir utiliza Memo/ExtraID usted debe proporcionarlo usando este parámetro o usar '0' para no Memo;
      -donation: True activará el modo de donación, si no, pasará por defecto al modo de pago;
      -direct: False hará que la url funcione como una API y devolverá una respuesta JSON con el ID de la transacción creada. Más detalles abajo;
      -ticker_from: Si quieres puedes definir la moneda preseleccionada que el usuario transferirá, ticker_to es el ticker de la moneda;
      -network_from: Si quieres puedes definir la moneda preseleccionada que el usuario transferirá, network_to es la red de la moneda;
      -name: El nombre que desea que aparezca en el widget. Los caracteres especiales deben estar codificados en url ( 'A B' is 'A%20B');
      -description: Una descripción que aparecerá en la pantalla de checkout para el pago/donación. Los caracteres especiales deben estar codificados en url ( 'A B' is 'A%20B');
      -referral: Si tiene un código de indicación de nuestro programa de afiliados, puede utilizarlo aquí;
      -buttonbgcolor: El color del botón, debe estar en formato hexadecimal sin el '#'. Por ejemplo, ff0000 para rojo;
      -textcolor: El color del texto del botón, debe estar en formato hexadecimal sin el '#'. Por ejemplo, ffffff para blanco;
      -bgcolor: True dará a la página un fondo gris, de lo contrario será transparente/blanco. Si no va a usar AnonPay en un iframe, esto es recomendado. También puedes utilizar un color en formato hexadecimal sin el '#'. Ejemplo: 000000ff para negro sin transparencia;
      -email: Un correo electrónico en el que recibirá confirmación cuando se complete la transacción;
      -fiat_equiv: Si desea que su transacción sea denominada en moneda fiat, proporciona una abreviatura de moneda válida (por ejemplo, USD o EUR). Ten en cuenta que recibirás en tu moneda elegida y tus clientes pagarán en cripto, todavía no aceptamos pagos en moneda fiat;
      -remove_direct_pay: Si no quieres que el usuario te pague directamente a través de AnonPay con la moneda que elegiste recibir, marcar este parámetro como Verdadero. Esto es útil si tiene otro método preferido para recibir en su moneda elegida y desea usar AnonPay solo para otras monedas;
      -min_logpolicy: si desea transaccionar una moneda solo en exchanges con un mínimo de calificación de almacenamiento de registros A, B o C, proporcione este parámetro (Opcional);
      -editable: Permite al usuario cambiar el monto a pagar cuando se marca como Verdadero;
      -webhook: si proporciona una URL en este parámetro, cada vez que cambie el estado de la transacción, recibirás en esta URL una solicitud POST que le enviará los datos de la transacción; esto evita tener que pedir muchas veces a nuestro servidor para verificar la transacción (Opcional);
      -simple_mode: Cuando se marca como Verdadero, la pantalla de pago se simplificará para que las personas que no estén tan familiarizadas con las criptomonedas la utilicen más fácilmente.;

  • Desea recibir 1,4LTC como pago por una suscripción anual a su sitio web 'Super News' y recibir un correo electrónico cuando se confirme el pago.

    • Párametros
      ticker_to: ltc
      network_to: Mainnet
      amount: 1.4
      name: Super%20News
      description: Annual%20Subscription
      email: mail@supernews.com
      address: ltc1q....fgsw

    • URL resultante:
      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
  • Tienes un sitio web llamado 'Freedom Matters' y quieres recibir donaciones en Monero. También quieres que el widget tenga un botón de color azul claro/púrpura y una cantidad predefinida de 0.01BTC.

    • Párametros
      ticker_to: xmr
      network_to: Mainnet
      amount: 0.01
      donation: True
      name: Freedom%20Matters
      address: 89Jb....dB12
      buttonbgcolor: 3315ff

    • URL resultante:
      https://trocador.app/anonpay/?ticker_to=xmr&network_to=Mainnet&amount=0.01&name=Freedom%20Matters&donation=True&buttonbgcolor=3315ff&address=83r6YnuwnsVXNvHmurMFYf3Urufw54rKic1Ka5ysgSv5Wvp1UrCi5UnB2vfQnxmmTp1W2JYqk452QAgqV83SpqK8D7xy7gd
  • Si decide utilizar nuestro método indirecto, construya una url igual que si utilizara el método directo, pero añada el parámetro 'direct=False'. Cuando llames a esa URL, recibirás una respuesta JSON con el 'ID' único de la transacción generada y su URL.

    Para verificar el estado de la transacción, puede usar el siguiente endpoint de URL y recibirá un JSON con su estado: 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>
  • Estos son todos los posibles estados de intercambio que encontrarás al usar AnonPay.


    • - anonpaynew: el intercambio está creado, pero aún no se ha seleccionado ninguna moneda para el pago;
      - waiting: creaste el intercambio, pero no se detectó ningún depósito;
      - confirming: se detectó el depósito y aún está pendiente de confirmación;
      - sending: depósito confirmado y el proveedor está enviando las monedas;
      - finished: ya hay un hash de pago para el usuario;
      - paid partially: ya hay un hash de pago para el usuario, pero la cantidad es menor a la solicitada;
      - failed: algo podría haber sucedido con el intercambio, por favor, ponte en contacto con soporte;
      - expired: el tiempo de pago ha expirado;
      - halted: hubo algún problema con el intercambio, por favor, contacta con soporte;
      - refunded: la plataforma de intercambio afirma haber reembolsado al usuario;