Resumen de Gateway Pay

Operación consolidada de todas las empresas.

Arquitectura

La llave de cada empresa determina el tenant; el cliente nunca envía IdEmpresa.

ERP / Backend App→DYR Gateway Pay→AZUL / CardNET

Empresas

Crea cada compañía, define su base ERP, genera su API Key y controla el acceso.

Procesadores

Selecciona una empresa para configurar sus credenciales.

Transacciones

Últimos cargos procesados por el motor.

Pruebas end-to-end

Selecciona una empresa para probar el flujo.

Simular cliente + tarjeta + cobro

Prueba el flujo visual y el cifrado sin llamar a AZUL/CardNET.

SIN COBRO

Procesador configurado (opcional)

Monto

Moneda

Genera un token ficticio solo en memoria y verifica que Data Protection pueda protegerlo. No crea una transacción en el procesador.

Prueba real desde RD$1

Guarda un token de prueba, activa Autopay, crea el pendiente, cobra y consulta el resultado.

COBRO TEST

Procesador TEST / Certificación

Token / DataVault de prueba

Marca

Últimos 4

Monto

ITBIS dentro del monto

Moneda

Importante: este botón sí envía el cargo al ambiente TEST/certificación del procesador. El monto inicia en RD$1.00; si el proveedor exige un mínimo mayor, aumenta el monto. Gateway Pay bloquea configuraciones PROD en esta pantalla.

Resultado del flujo

Cliente → token → Autopay → pendiente → proceso → procesador → consulta.

Ejecuta una simulación o una prueba real.

Documentación API cliente / ERP

Consulta endpoints, ejemplos y archivos listos para Postman/OpenAPI.

OpenAPI YAML Postman

Autenticación

Cada empresa usa su llave generada aquí. Enviar desde servidor:

X-DYR-Gateway-Key: dyrgp_...

Base URL actual:

No incrustes esta llave dentro de Flutter, JavaScript público ni una app móvil. La app debe llamar a tu backend/ERP y ese servidor llama a Gateway Pay.

Flujo recomendado

Configurar en la empresa el Connection String ERP y su CompaniaID.
Gateway Pay puede localizar/sincronizar el cliente directamente desde dbo.Clientes.
Guardar el token emitido por AZUL/CardNET.
Activar Autopay con ese método.
Enviar cada factura/paquete pendiente.
Consultar el estado por SourceType + SourceId.

GET/api/v1/company

Valida la API Key y devuelve la empresa/tenant asociado.

GET/api/v1/customers/{ClienteID}

Busca el cliente en Gateway Pay y, si no existe, lo resuelve desde la base ERP configurada para la empresa.

POST/api/v1/customers

Registra o sincroniza un cliente del ERP. Si Name va vacío y la búsqueda ERP está activa, toma el nombre desde dbo.Clientes.

POST/api/v1/customers/{ClienteID}/payment-methods

Guarda únicamente el token del proveedor; nunca PAN/CVC.

PUT/api/v1/customers/{ClienteID}/autopay

Activa Autopay y define el método.

POST/api/v1/autopay/pending

Encola una factura, paquete u otro cargo.

GET/api/v1/autopay/status/{SourceType}/{SourceId}

Consulta proceso, aprobación y autorización.

GET/api/v1/transactions?customerCode={ClienteID}&take=100

Lista transacciones de la empresa autenticada; admite filtros por cliente y fechas UTC.

GET/api/v1/transactions/{Id}

Consulta una transacción específica, siempre aislada por la API Key de la empresa.

Ejemplo: registrar cliente

POST /api/v1/customers
X-DYR-Gateway-Key: dyrgp_...
Content-Type: application/json

{
  "customerCode": "000123",
  "name": "CLIENTE PRUEBA",
  "email": "cliente@correo.com"
}

Ejemplo: consultar un cobro

GET /api/v1/autopay/status/FACTURA/FT01-000123
X-DYR-Gateway-Key: dyrgp_...

La respuesta incluye estado del pendiente/proceso, gateway, código de autorización, código del proveedor y mensaje.

Super Admin