Un breve resumen de la API de comercios de HissPay. La referencia completa es la documentación oficial v1.13.0 (2026-10-27), publicada actualmente en chino simplificado.
La documentación de integración completa y actualizada está en https://mch.hisspay.com/docs/ (v1.13.0 · 2026-10-27, actualización continua). Esta página solo la resume; ante cualquier diferencia prevalece la documentación oficial.
HissPay ofrece cobros (a sus clientes) y pagos (a una cuenta beneficiaria) mediante HTTPS POST con cuerpo JSON. Pasarela de producción: https://transaction.hisspay.com; pasarela sandbox: https://sandbox-api.hisspay.com.
| Operación | Ruta |
|---|---|
| Crear pedido de cobro | POST /transaction/payin/v1/apply |
| Consultar pedido de cobro | POST /transaction/payin/v1/query |
| Crear pedido de pago | POST /transaction/payout/v1/apply |
| Consultar pedido de pago | POST /transaction/payout/v1/query |
| Consultar saldo | POST /transaction/payout/v1/balance |
Monedas del catálogo de productos: AUD, EUR, GBP, INR, JPY, THB, USD, USDT. Figurar en el catálogo no equivale a estar activado: los códigos de producto, rangos de importe y comisiones de su cuenta llegan con su aviso de activación.
Antes de integrar: su cuenta de comercio está aprobada; ha creado una aplicación API en el portal de comercios (mch.hisspay.com → claves de aplicación) y tiene su appId y appSecret; los productos de cobro y pago están contratados; las IP públicas de salida de su servidor están en la lista blanca para pagos; y dispone de una URL HTTPS pública para notificaciones. Pruebe primero de extremo a extremo en el sandbox.
Cada solicitud lleva las cabeceras appId, timestamp (milisegundos Unix, a menos de 30 segundos de la hora de la plataforma), nonce (al menos 10 caracteres, nunca reutilizado) y sign. sign es el SHA-256 en hexadecimal minúscula de los campos del cuerpo más appId, timestamp y nonce, ordenados por nombre como pares key=value unidos con &, con el appSecret añadido directamente al final. No es HMAC. No envíe valores null ni ponga el appSecret en un navegador o una app.
POST /transaction/payin/v1/apply crea un pedido de cobro y devuelve payUrl para el pagador. Confirme el pago solo con una notificación verificada o una consulta, nunca con la página de retorno del navegador.
POST /transaction/payout/v1/apply es asíncrono: code=0 significa aceptado, no pagado. Un tiempo de espera agotado o el código 500 significan que el resultado no está confirmado: consulte primero el pedido original y siga las reglas de la documentación completa antes de volver a enviar nada.
El cobro en USDT usa currency=USDT y un código de producto por red asignado por la plataforma; los importes tienen como máximo 4 decimales. El resultado se confirma por notificación o consulta.
Tailandia (THB): cobro mediante QR PromptPay y pago por transferencia bancaria tailandesa. Códigos de banco para cobro: SCB, KBANK, KTB, BAY, GSB, TTB; para pago: SCB, KBANK, KTB, BAY, GSB, TTB, BBL (los bancos disponibles para su cuenta figuran en su aviso de activación). Rango predeterminado por operación: 500.00–49999.00 THB.
POST /transaction/payin/v1/query y POST /transaction/payout/v1/query aceptan merchantOrderNo u orderNo. Máximo 5 consultas por segundo por appId; consulte cada 3–5 segundos con espera progresiva.
POST /transaction/payout/v1/balance devuelve por moneda balance (contable), balanceActive (disponible) y balanceFreeze (retenido).
La plataforma envía un POST JSON a su notifyUrl con las mismas cuatro cabeceras de firma. Verifique la firma, procese de forma idempotente por pedido y responda exactamente SUCCESS u OK. Las notificaciones no confirmadas se reintentan un número limitado de veces.
Use payStatus junto con paymentStatus e isFinal. Un payStatus=0 en la consulta de cobro no significa que el pago haya fallado.
code=0 significa que la llamada a la API tuvo éxito; el resultado del pago es un estado del pedido aparte. Todos los códigos de error y su tratamiento recomendado están en la documentación completa.
Cree un comercio sandbox, ejecute el paquete quickstart y la autocomprobación de 5 minutos de la guía del sandbox y después siga la lista de comprobación para pasar a producción.
Al abrir una cuenta en línea, obtiene credenciales de prueba y códigos de producto; una vez validado en el entorno sandbox, puede pasar a producción con un solo clic.
HissPay proporciona tecnología para integrar pagos, gestionar pedidos, enviar notificaciones y realizar conciliaciones. La entidad de pago autorizada contratada procesa los pagos y realiza la compensación y liquidación. HissPay no recibe, mantiene ni maneja fondos de las transacciones.
Las tarifas mostradas incluyen los costes de procesamiento de la entidad de pago autorizada y la tarifa tecnológica de HissPay; no corresponden íntegramente a HissPay. El desglose, la facturación y las condiciones figuran en los contratos y el tarifario firmados por el comercio.