Inqud Logo
Inqud Sandbox and Production environments separated by an isolation wall
Icono de matrazModo Sandbox

Inqud Sandbox

Un entorno de pruebas independiente donde puedes desarrollar y verificar tu integración con Inqud usando fondos de prueba en lugar de dinero real. Crea cobros, envía pagos salientes y recibe webhooks antes de pasar a producción.

Panel de comerciante de Inqud Sandbox con saldo de prueba

¿Qué es Inqud Sandbox?

Inqud Sandbox es un entorno de pruebas aislado para pagos cripto pensado para equipos que integran Inqud en su producto. Funciona como un sandbox de pasarela de pago: creas cobros, ejecutas pagos salientes y recibes webhooks sin tocar la plataforma real ni fondos reales.

Sandbox tiene sus propias URL, cuentas, tokens de API y saldos. Cada URL de producción tiene su versión de Sandbox en el dominio sandbox.inqud.com.

Los equipos usan Sandbox para desarrollar y depurar integraciones, probar el manejo de los estados de pago y hacer demos de su producto sin riesgo financiero.

  • API
  • Panel de comerciante
  • Página de pago alojada
  • On-ramp
  • Pagos recurrentes
Por qué Sandbox

¿Por qué probar tu integración
primero en Sandbox?

  • Sin riesgo para fondos reales

    Los tokens y monedas de prueba no tienen valor real. Los errores en montos, monedas o direcciones de billetera no cuestan nada.

  • Valida el comportamiento de la API

    Prueba solicitudes, respuestas, webhooks y firmas en Sandbox antes de pasar a producción.

  • Detecta errores a tiempo

    Simula pagos salientes fallidos o pendientes y solicitudes no válidas para corregir problemas antes de que los encuentren tus clientes.

  • Empieza sin KYB

    Tus desarrolladores pueden crear y probar la integración mientras tu empresa completa la verificación KYB.

¿Qué puedes probar en Inqud Sandbox?

Cómo empezar

  1. 01

    Crea una cuenta de Sandbox

    Regístrate en
    https://app.sandbox.inqud.com. No necesitas KYB, así que puedes empezar a desarrollar justo después de registrarte.

  2. 02

    Genera tokens de API

    En el panel de Sandbox, abre la sección de tokens de API y genera un par de tokens: y . Estos tokens solo funcionan en Sandbox.

  3. 03

    Conecta tu integración

    Configura la URL base de la API como y firma tus solicitudes con los tokens de Sandbox. A partir de aquí, la API de pagos de Sandbox sigue la misma guía de integración que producción.

  4. 04

    Obtén fondos de prueba

    Consigue monedas nativas de testnet para las comisiones de red en faucets públicos. Para recibir USDT o USDC de prueba en tu saldo de Sandbox, contacta con tu gestor de cuenta de Inqud o con soporte.

Sandbox frente a Production

Sandbox y Production comparten el mismo contrato de API, pero funcionan como entornos separados. Así se diferencia el entorno de pruebas de la pasarela de pago del entorno real.

Las cuentas, los tokens de API y los saldos son independientes. Las credenciales de un entorno no se pueden usar en el otro.

SandboxProduction
PropósitoDesarrollo, pruebas y demosPagos reales
FondosTokens de prueba y monedas de testnetFondos reales
KYBNo requeridoRequerido
URL base de la API
Panel de comerciantehttps://app.sandbox.inqud.comhttps://app.inqud.com
Tokens de APIPar de tokens de SandboxPar de tokens de Production
RedesTestnets EVM públicasRedes blockchain reales
MonedasParte de las monedas de producciónTodas las monedas compatibles

Prueba tus solicitudes API antes de lanzar

Las pruebas de API en Sandbox son más útiles cuando recorres todas las llamadas que tu producto hará en producción. Antes del lanzamiento, comprueba lo siguiente:

Límites de solicitudes

Sandbox permite 10 solicitudes POST y 300 solicitudes GET por minuto. Si tus pruebas necesitan más, pide a soporte que aumente el límite.

  • 10
    solicitudes POST / min
  • 300
    solicitudes GET / min
  • Autenticación

    CadasolicitudsefirmaconelpardetokensdeSandboxenlosencabezadosy.

  • Cuerpos de las solicitudes

    Todos los campos obligatorios están completos y los valores coinciden con los formatos de la referencia de la API.

  • Respuestas y errores

    Tu sistema lee correctamente las respuestas exitosas y gestiona las respuestas de error sin interrumpir el flujo.

  • Métodos de pago disponibles

    No todas las monedas y redes de producción están habilitadas en Sandbox, así que primero solicita a la API de Sandbox la lista de métodos de pago disponibles y diseña tus pruebas en función de ella.

Prueba tus webhooks

Los webhooks avisan a tu sistema de que un pago ha llegado o de que su estado ha cambiado, por eso merecen una atención especial. En Sandbox, el contenido de los webhooks y la verificación de firma funcionan igual que en producción.

Inqud Sandbox
  1. 01
    Paga un checkout

    desde tu saldo de USDT o USDC de prueba

  2. 02
    EstadoExitoso

    al instante, sin esperar confirmaciones en la blockchain

WebhookPOST, firmado conX-Payload-Digest
Tu endpoint
  1. 03
    recibe el webhook
  2. 04
    verifica la firma
  3. 05
    lee el estado correctamente
  4. 06
    actualiza el pedido o el saldo en tu sistema

Comprueba que tu endpoint recibe el webhook, verifica la firma, lee el estado correctamente y actualiza el pedido o el saldo en tu sistema. La forma más rápida de activar este flujo es pagar un checkout de criptoadquisición con tu saldo de USDT o USDC de prueba: obtienes toda la cadena, del cobro al webhook y la liquidación, sin esperar confirmaciones en la blockchain.

Depósitos y pagos salientes de prueba

Inqud Sandbox funciona en testnets EVM públicas, así que puedes probar pagos cripto en redes que se comportan como blockchains reales.

  • EthereumSepolia
  • BNB ChainTestnet
  • PolygonAmoy
  • ArbitrumSepolia
  • OptimismSepolia
  • BaseSepolia

Depósitos

Los depósitos están disponibles en Ethereum Sepolia, BNB Smart Chain Testnet, Polygon Amoy, Arbitrum Sepolia, Optimism Sepolia y Base Sepolia. Para cubrir las comisiones de red solo necesitas la moneda nativa de la testnet, como Sepolia ETH o BNB de prueba, que puedes obtener en faucets de terceros.

Obtener monedas de testnet
  • USDTPolygon Amoy−50.00Exitoso
  • USDCBase Sepolia−25.00Pendiente
  • Tarjeta •••• 0002Número de tarjeta de prueba−10.00Fallido

Pagos salientes

Los pagos salientes funcionan con USDT y USDC de prueba en las mismas redes. Son tokens de prueba emitidos por Inqud, y tu gestor de cuenta o el equipo de soporte los acreditará en tu saldo de Sandbox cuando lo solicites.

Para los pagos a tarjeta, la documentación incluye números de tarjeta de prueba que devuelven un resultado exitoso, fallido o pendiente. Así puedes comprobar cómo el sandbox de pagos cripto gestiona cada resultado que podrían encontrar tus clientes.

De Sandbox a Production

Cuando tu integración funciona en Sandbox, pasar a producción requiere tres pasos:

  1. 01

    Cambia la URL base de la API

    CambialaURLbasedelaAPIdea.

  2. 02

    Completa KYB y obtén tokens

    Completa el KYB y genera tokens de API de producción en https://app.inqud.com; después, sustituye con ellos los tokens de Sandbox.

  3. 03

    Lanza en redes reales

    Cambia a redes y monedas reales.

.env
# Inqud API · Sandbox
INQUD_API_BASE_URL=https://api.sandbox.inqud.com01
INQUD_TOKEN_API_ID=<sandbox token id>02
INQUD_TOKEN_API_SECRET=<sandbox token secret>02

El contrato de API es el mismo en ambos entornos, así que el código de tu integración no necesita otros cambios.

Sin embargo, el entorno en sí es diferente: producción usa fondos reales, admite más monedas y redes, y tiene su propia cuenta y saldos.

Preguntas frecuentesFAQ

No. Sandbox no exige KYB, así que puedes registrarte en https://app.sandbox.inqud.com y empezar a desarrollar de inmediato. El KYB solo es necesario para producción.

No. Sandbox funciona con USDT y USDC de prueba emitidos por Inqud y con monedas nativas de testnets públicas. Ninguno de ellos tiene valor real.

Sí. Sandbox y producción usan cuentas separadas y pares de tokens de API separados. Los tokens de Sandbox no funcionan en producción, y los de producción no funcionan en Sandbox.

Sí. Los depósitos están disponibles en seis testnets EVM, como Ethereum Sepolia, Polygon Amoy y Base Sepolia. Los pagos salientes funcionan con USDT y USDC de prueba, y los números de tarjeta de prueba te permiten comprobar pagos a tarjeta exitosos, fallidos y pendientes.

Sí. El contenido de los webhooks y la verificación de firma en Sandbox son los mismos que en producción. Puedes comprobar que tu endpoint recibe webhooks, verifica firmas y procesa cada estado de pago.

La API es la misma: los formatos de solicitud y respuesta, el contenido de los webhooks y la verificación de firma no cambian. Lo que difiere son los entornos: Sandbox usa fondos de prueba y testnets EVM, admite solo una parte de las monedas y redes de producción y tiene límites de 10 solicitudes POST y 300 GET por minuto, que soporte puede aumentar si lo solicitas.

Cambias la URL base de la API a https://api.inqud.com, sustituyes los tokens de Sandbox por tokens de producción y pasas a redes y monedas reales. Para obtener tokens de producción, debes completar el KYB.

Comprueba la autenticación, los campos obligatorios de tus solicitudes, el manejo de respuestas y errores, la entrega de webhooks y la verificación de firma, los depósitos y los pagos salientes. También conviene reproducir pagos salientes fallidos y pendientes para que tu sistema esté preparado para cualquier resultado.

Guías simples para desarrolladoresGuías

Avanza en el proceso de integración con nuestras guías concisas y estructuradas.

Documentación

Centro de ayuda

Contáctanos con cualquier pregunta. Estaremos encantados de ayudarte.

Centro de ayudaIr al centro de ayuda

Empieza a desarrollar en Sandbox.

No necesitas KYB para registrarte.