FAQ técnicas

Registra una cuenta y solicita una clave de API al equipo de AhoraCrypto. La Payment Intent API requiere además un storeId, que es único por cliente y también lo proporciona AhoraCrypto.

Todos los endpoints de la API se sirven desde https://api.ahoracrypto.com.

Cada solicitud debe incluir la cabecera x-api-key con tu clave de API. Las solicitudes sin una clave válida devuelven 401 Unauthorized.

Consulta la página de Redes para ver la lista completa. Usa siempre el símbolo de la red exactamente como aparece ahí como valor del campo network.

Cualquiera de las dos. Al crear un Payment Intent defines la cantidad de crypto o el importe en fiat, y el sistema calcula el otro. Si se envían ambos, el importe en fiat tiene prioridad y la cantidad de crypto se recalcula.

Solo cuando el estado del Payment Intent es 4 (Listo para pagar). Mientras el estado no esté listo (por ejemplo, si hay una validación KYC pendiente) no se puede llamar al endpoint de instrucciones. Consulta el estado en cualquier momento con el endpoint de estado.

Proporciona una ipnUrl al crear el Payment Intent. Se llama mediante GET con los parámetros paymentIntentId y paymentIntentStatus cada vez que cambia el estado. También puedes consultar el endpoint de estado en cualquier momento.

Sí. Si un usuario debe completar el KYC antes de comprar, la llamada de creación devuelve una kycUrl donde puede finalizar la verificación. Proporciona una kycCallbackUrl para devolver al usuario a tu flujo una vez completado el KYC.

La dirección IP forma parte de los datos que se envían a las pasarelas de pago, que la requieren para verificar la autenticidad de la transacción. Cualquier dato que proporciones, como el país, debe ser preciso y nunca inferido a partir de otros datos. Si no se conoce un valor, omítelo.

Sí. Usa el React SDK oficial (ahoracrypto-react-sdk), que también admite Capacitor para crear apps de iOS y Android. Para páginas web sencillas, usa el Web Widget.