Skip to main content
Pay-me Transit PinPAD permite que el sistema de un comercio inicie, consulte, cancele y extorne pagos procesados en un terminal físico. La integración utiliza HTTP/JSON sobre la red local. Esta documentación corresponde a la aplicación Pay-me PinPAD con package com.alignet.pinpad.ecr, instalada en el terminal Wiseasy P5L.
En esta guía, sistema central identifica al cliente HTTP del comercio o integrador. Puede ser un punto de venta, un sistema de caja, un backend o un Sistema de Control de Carril (SCC). El servidor HTTP es Pay-me PinPAD en el Wiseasy P5L.

​
Alcance de la integración

La interfaz local expone cinco operaciones: comprobar disponibilidad, autorizar y consultar pagos, y solicitar y consultar cancelaciones o extornos. Consulta la referencia de endpoints para ver métodos, rutas y respuestas HTTP. El contrato no requiere instalar una librería en el sistema central. Debes implementar un cliente HTTP capaz de enviar y recibir JSON, mantener abierta una solicitud síncrona y recuperar operaciones inciertas.

​
Flujo en cinco pasos

1

Comprobar conectividad

Ejecuta GET /health. Durante la configuración inicial, esta llamada también permite que Pay-me PinPAD confirme que el sistema central alcanza el terminal.
2

Crear la referencia

Genera y persiste un operationNumber único antes de iniciar el cobro.
3

Enviar la autorización

Ejecuta POST /authorize con el monto en unidades menores. Configura un timeout HTTP de al menos 100 a 110 segundos.
4

Interpretar el resultado

Confirma el pago únicamente si recibes HTTP 200, status: "APPROVED" y resultCode: "00".
5

Recuperar un resultado incierto

Ante HTTP 202, timeout o pérdida de conexión, consulta GET /payments/{operationNumber}. No inicies otro cobro.

​
Principios de implementación

  • Una operación real de cobro utiliza un único operationNumber.
  • amount es un String numérico que representa un entero positivo en unidades menores. Por ejemplo, "1500" equivale a S/ 15.00.
  • El cobro es síncrono. POST /authorize permanece abierto mientras el usuario presenta la tarjeta e ingresa el PIN cuando corresponde.
  • PENDING y UNKNOWN no significan rechazo. Debes consultar antes de tomar una decisión o iniciar otro cobro.
  • Pay-me PinPAD procesa una operación a la vez. Una referencia diferente recibida durante un cobro activo obtiene 409 POS_BUSY.
  • La cancelación detiene una autorización activa; el extorno revierte una venta que ya fue aprobada. No intercambies estos flujos.
  • El sistema central no recibe PAN completo, CVV, PIN, PIN Block, pistas ni datos EMV sensibles.

​
Contenido de esta guía

Arquitectura, red y seguridad

Comprende los componentes, la red local y la protección de datos.

Requisitos y responsabilidades

Prepara al comercio, al integrador y al terminal.

Configuración

Registra los parámetros de cada ambiente y terminal.

Autenticación

Aplica los controles de acceso admitidos por la interfaz local.

Referencia de endpoints

Revisa métodos, rutas y respuestas disponibles.

Solicitud de autorización

Implementa POST /authorize, sus validaciones y ejemplos.

Cancelación y extorno

Usa POST /reversals; Pay-me PinPAD cancela o extorna según el estado actual.

Respuestas, consulta y códigos

Interpreta estados de negocio, códigos HTTP y GET /payments/{operationNumber}.

Operación y recuperación

Controla timeouts, operaciones pendientes, idempotencia y concurrencia.

Solución de problemas

Diagnostica conectividad, errores operativos y resultados inciertos.

Ejemplos de integración

Usa ejemplos completos de cURL, Java, C#, Python y Node.js.

Certificación y producción

Valida escenarios, evidencias y criterios de salida.

Datos por validar

Revisa decisiones abiertas sin asumir valores no confirmados.