Primeros pasos
¿Qué es PAYWISE?
PAYWISE es una pasarela de pagos para aceptar QRIS (todos los bancos y billeteras de Indonesia) y criptomonedas en su sitio web o app. Los estados de pago se actualizan automáticamente y los fondos pueden retirarse a una cuenta bancaria o a una billetera BEP20. Los fondos QRIS también pueden retirarse como USDT (TRC20/ERC20).
¿Cómo empiezo?
1) Regístrese como comercio. 2) Complete el perfil de su negocio. 3) Agregue su sitio web. 4) Cree una clave API (empiece con sandbox para probar). 5) Configure su webhook. 6) Cuando la integración funcione, cree una clave de producción y empiece a cobrar.
¿Cuál es la diferencia entre sandbox y producción?
Sandbox es para pruebas: sus pagos no se pueden pagar de verdad y usted elige el resultado (pagado / fallido / vencido), con los mismos webhooks que en producción. Producción procesa pagos reales. Las claves de sandbox (pw_test_…) y de producción (pw_live_…) están separadas y nunca ven las transacciones de la otra.
¿Cuánto cuesta?
QRIS 2% y USDT 3% de cada pago exitoso, descontado automáticamente antes de que pueda retirarse. Sin costo de alta ni cuota mensual. Cada retiro tiene una comisión fija (vea Retiros).
¿Con qué apps pueden pagar mis clientes?
QRIS: cualquier app de banca móvil o billetera de Indonesia que lea códigos QRIS, como GoPay, OVO, DANA, ShopeePay, LinkAja y las apps de los bancos. Cripto: cualquier billetera o exchange que pueda enviar USDT u otra de las monedas aceptadas.
¿Puedo usar una cuenta para varios sitios web?
Sí. Agregue cada sitio en la página Sitios web y webhook. No necesita una cuenta distinta para cada sitio.
¿Puedo obtener una tarifa más baja?
Sí, para grandes volúmenes. Cuéntenos su volumen diario o mensual esperado en Telegram y le enviaremos nuestra mejor oferta.
Pagos
¿Cuáles son los montos mínimo y máximo de QRIS?
Un pago QRIS va de Rp1.000 a Rp10.000.000.
¿Cuánto tiempo es válido un código QR?
10 minutos por defecto. Con la API puede fijar un tiempo menor con expires_in (en segundos). Después, el pago vence y el código QR ya no se puede pagar.
¿Qué significan los estados de pago?
Pendiente: esperando el pago. Pagado: el pago está confirmado. Fallido: el pago no pudo procesarse. Vencido: se acabó el tiempo antes de que el cliente pagara.
El cliente dice que pagó pero el estado sigue pendiente. ¿Qué hago?
Abra el pago en el panel y pulse Comprobar estado: PAYWISE consulta directamente al proveedor. Si sigue pendiente, pida al cliente su comprobante (referencia, hora, monto) y contacte con soporte indicando la referencia PW… del pago.
¿Cómo funcionan los pagos en USDT?
En la página de pago el cliente elige una moneda: USDT en BEP20, TRC20 (desde 20 USDT), Polygon o Solana, o BTC, ETH, BNB, SOL, TRX o LTC. Envía exactamente el pay_amount mostrado, en esa moneda y esa red, a la dirección indicada (la comisión de red y de conversión está incluida y la paga el cliente). Las otras monedas se convierten a USDT: usted siempre recibe el monto en USDT. Una moneda enviada por la red equivocada puede perderse.
¿Qué pasa si un cliente envía menos USDT?
El pago no se marca como pagado. Cuando se acaba su tiempo, vence, y nuestro equipo hace seguimiento con el cliente (completar o reembolsar). Si su cliente pregunta, contacte con soporte con la referencia PW… del pago.
¿Por qué no puedo crear pagos nuevos ahora?
PAYWISE a veces pausa un método de pago por poco tiempo, por ejemplo durante una caída del proveedor o del banco, o por mantenimiento. Los pagos ya abiertos no se ven afectados. La página Estado del sistema muestra cuándo vuelve.
Liquidación y fondos disponibles
¿Cuándo puedo retirar los pagos QRIS?
Los fondos QRIS quedan disponibles según este horario (UTC+7): pagado 20:00–07:59 → disponible a las 09:00 (pagos antes de medianoche: al día siguiente); pagado 08:00–11:59 → disponible a las 13:00; pagado 12:00–15:59 → disponible a las 17:00; pagado 16:00–19:59 → disponible a las 21:00. Un comercio puede tener horarios propios; la hora exacta de sus fondos aparece en las páginas Inicio y Retiros.
¿Cuándo puedo retirar los pagos en USDT?
Los fondos en USDT están disponibles en cuanto el pago se paga.
¿Por qué mis fondos disponibles son menores que el total de pagos?
Los fondos disponibles son el dinero después de la comisión, cuya liquidación ya llegó y que aún no se ha retirado. El dinero que espera su lote de liquidación se muestra aparte como "pendiente de liquidación".
¿Se combinan los fondos QRIS y USDT?
No. Cada método tiene sus propios fondos en su propia moneda: QRIS en rupias (retiro a cuenta bancaria) y USDT en USDT (retiro a billetera BEP20). Nunca se combinan. Los fondos QRIS solo se convierten si usted elige Retirar fondos QRIS a USDT.
¿La liquidación funciona también fines de semana y festivos?
Sí. Puede recibir pagos las 24 horas, y el horario de liquidación de arriba se aplica todos los días, incluidos sábados, domingos y festivos.
Retiros
¿Cuáles son los límites y comisiones de retiro?
QRIS (a cuenta bancaria): de Rp15.000 a Rp25.000.000 por retiro, comisión Rp3.000. USDT (a billetera BEP20): de 10.00 USDT a 10,000.00 USDT por retiro, comisión 1.00 USDT. El monto que ingresa es el que llega; la comisión se suma y se descuenta de sus fondos disponibles. Los retiros QRIS de Rp5.000.000 o más no tienen comisión (con Retiro parcial: cada parte de Rp5.000.000 o más).
¿Y si quiero retirar más del máximo?
Elija Retiro parcial en la página de retiro QRIS. Un monto mayor que Rp25.000.000 se divide automáticamente en varios retiros (p. ej. 50 millones = 20 + 20 + 10 millones), con una comisión de Rp3.000 por retiro.
¿Puedo retirar fondos QRIS como USDT?
Sí. En la página de retiro QRIS elija Retirar fondos QRIS a USDT, seleccione la red TRC20 o ERC20 e ingrese la dirección de su billetera. De Rp500.000 a Rp250.000.000 por retiro, sin comisión de retiro. El tipo de cambio y el USDT estimado se muestran antes de confirmar. El monto en USDT se redondea hacia abajo a USDT enteros. Estos retiros solo pueden solicitarse entre 09:00 y 18:00 (UTC+7).
¿Cuánto tarda un retiro?
Los retiros QRIS a cuenta bancaria se envían automáticamente, normalmente en minutos. Los retiros de QRIS a USDT los procesa nuestro equipo a mano entre 09:00 y 18:00 (UTC+7). Puede seguir el estado en Retiros y recibirá un aviso cuando termine.
¿Por qué se rechazó o falló mi retiro?
Lo más común: el número de cuenta o el banco no coinciden, la cuenta de destino está inactiva o la dirección de la billetera BEP20 es incorrecta. Un retiro fallido o rechazado siempre vuelve a sus fondos disponibles. Use Comprobar cuenta antes de enviar para confirmar el nombre del titular.
¿Qué es el código de retiro?
Un código que se envía a su email cada vez que solicita un retiro, como protección adicional. Sin él no se puede solicitar ningún retiro, aunque alguien haya entrado en su cuenta.
¿Quién de mi equipo puede retirar?
Solo el propietario de la cuenta y los miembros con el rol Finanzas. Los desarrolladores y los miembros de solo lectura no pueden solicitar retiros.
¿Por qué están pausados los retiros?
PAYWISE a veces pausa los retiros por poco tiempo, por ejemplo por mantenimiento o una caída del banco. Un aviso en la página de retiros explica el motivo. Sus fondos no se ven afectados y podrá retirar en cuanto se reanude.
Mi comisión de retiro es distinta de la que aparece aquí.
Las comisiones de este Centro de ayuda son las estándar. Si acordó otra tarifa con PAYWISE, se aplica la suya, y la página de retiro siempre la muestra antes de confirmar.
Integración
¿Cómo conecto mi sitio web?
Use la API REST (documentación completa en la página Desarrolladores), el plugin de WooCommerce o el SDK de PHP / Node.js. Cree un pago con POST /api/v1/transactions, envíe al cliente a la página de pago (checkout_url) o muestre usted el QR, y espere el webhook.
¿Qué es un webhook y cómo lo verifico?
Un webhook es un aviso que PAYWISE envía a su servidor cuando cambia un estado (payment.paid, payment.failed, payment.expired y withdrawal.*). Cada webhook va firmado: la cabecera X-PAYWISE-Signature es el HMAC-SHA256 del cuerpo sin procesar con su secreto de webhook. Verifíquela siempre antes de entregar un pedido. Para más seguridad, verifique X-PAYWISE-Signature-V2 (que también firma la hora de envío X-PAYWISE-Timestamp) y rechace webhooks de más de 5 minutos, para que un webhook copiado no pueda reenviarse.
Mi webhook falló. ¿Qué pasa?
PAYWISE lo reintenta automáticamente varias veces. También puede reenviarlo desde la página del pago. Asegúrese de que su servidor responda con HTTP 2xx y no bloquee las IP de envío de PAYWISE.
¿Cómo evito pedidos duplicados?
Envíe un merchant_reference único para cada pedido. Si se vuelve a enviar una solicitud con el mismo merchant_reference (por ejemplo tras un timeout), PAYWISE devuelve el mismo pago en lugar de crear otro.
¿Cómo mantengo segura mi clave API?
Guarde las claves API solo en su servidor, nunca en una app ni en código visible para los visitantes. Configure las IP permitidas en la página Claves API y revoque las claves que ya no use.
¿Hay un límite de solicitudes a la API?
Sí: 60 solicitudes por minuto por clave API por defecto. Por encima, la API responde HTTP 429; espere un momento y vuelva a intentarlo. Contacte con soporte si necesita un límite mayor.
¿Desde qué IP llegan los webhooks?
Están en la página Sitios web y webhook. Si su servidor o firewall solo acepta direcciones conocidas, permita estas.
¿Puedo probar la API sin escribir código?
Sí. Use el API Playground del panel para enviar solicitudes con su clave de sandbox, o descargue la colección de Postman o el archivo OpenAPI desde la página Desarrolladores.
Notificaciones y reportes
¿Qué notificaciones recibiré?
Por ejemplo: pago recibido, resumen diario, fondos disponibles, resultados de retiros, su estado de cuenta mensual, webhooks fallidos y anuncios de PAYWISE. Cada miembro del equipo recibe solo lo que corresponde a su rol, y algunas notificaciones pueden desactivarse en la página Notificaciones.
¿Puedo recibir notificaciones en el teléfono?
Sí. Instale la app de PAYWISE directamente desde nuestra web (sin tienda de apps) y permita las notificaciones. Se le avisará en cuanto llegue un pago.
¿Cómo descargo mis transacciones o un estado de cuenta?
En la página Transacciones, exporte sus transacciones como archivo CSV. La página Reportes muestra sus totales por periodo, con exportación CSV y un estado de cuenta mensual en PDF.
Cuenta y seguridad
¿Por qué me piden un código al iniciar sesión?
PAYWISE usa verificación en dos pasos: un inicio de sesión desde un dispositivo nuevo pide un código enviado a su email. Puede marcar un dispositivo personal como de confianza para que no se lo pida cada vez.
¿Puede mi equipo usar el panel?
Sí. Invite a miembros del equipo con el rol adecuado (por ejemplo finanzas, desarrollador o solo lectura). Cada rol solo puede hacer lo que tiene permitido.
Olvidé mi contraseña.
Haga clic en "¿Olvidó su contraseña?" en la página de inicio de sesión, ingrese su email y siga el enlace que le enviaremos.
¿Qué hago si veo actividad sospechosa en mi cuenta?
Cambie su contraseña de inmediato y, en la página de seguridad, cierre todas las demás sesiones y revise la actividad de inicio de sesión. Contacte con soporte por cualquier pago o retiro que no reconozca.
Ninguna pregunta coincide. Pruebe otras palabras o contacte con soporte.
¿Todavía necesita ayuda?
Nuestro equipo de soporte está en Telegram y por email. Los comercios con sesión iniciada también pueden abrir un ticket en Soporte.
Siga el canal de Telegram de PAYWISE
Novedades, anuncios y calendario de mantenimiento, directo en su Telegram.


