FINORA Pago · Reference

Programa finora-pago.exe y dirección finora-pago://

ImplementedImplemented

This content is not available in your language yet.

Las dos puertas aceptan los mismos datos que POST /v1/cobros de la API local. Cuál conviene a tu caja: Tres formas de integrar tu caja.

Programa `finora-pago.exe`

Se instala por usuario en %LOCALAPPDATA%\Programs\finora-pago\finora-pago.exe.

Comandos

finora-pago.exe cobrar --monto 227.00 --referencia 8841 --json
finora-pago.exe cobrar --monto 64.90 --referencia 8842 --modo formal --json
finora-pago.exe cobrar --monto 15.00 --referencia 8843 --mostrar false --riel TARJETA --terminalId <TID_DEL_TERMINAL> --json
finora-pago.exe consultar <cobroId> --esperar --json
finora-pago.exe cancelar <cobroId> --json
finora-pago.exe salud --json

Comando	Qué hace
`cobrar`	Crea un cobro y espera siempre su veredicto
`consultar <cobroId>`	Devuelve el cobro; con `--esperar`, espera su veredicto
`cancelar <cobroId>`	Cancela un cobro en curso
`salud`	Lo mismo que `GET /v1/salud`

Argumentos de `cobrar`

Cada campo de la API local tiene su argumento con el mismo nombre: --monto, --referencia, --descripcion, --riel, --terminalId, --tipoCuenta, --mostrar true|false, --modo formal|inmersivo, --sandbox true|false. Los datos del medio van como --campo-<nombre> (--campo-telefono, --campo-banco, --campo-clave) y los del cliente como --pagador-<campo> (--pagador-documento, --pagador-tipoDocumento). Con --json, imprime el cobro en JSON.

Códigos de salida

Código	Significa
`0`	Aprobada
`1`	Rechazada, cancelada o vencida
`2`	En duda: no entregues ni vuelvas a cobrar
`3`	Error: datos inválidos, sin conexión con FINORA Merchant o la aplicación no responde

Ante un error, la salida es {"error": {"codigo": "…", "mensaje": "…"}}.

Comportamiento

Si FINORA Pago no está abierto, el programa lo abre en segundo plano y espera hasta 20 segundos a que responda.
Lee el puerto y el token local de la configuración de FINORA Pago del usuario. También acepta PAGO_PUERTO y PAGO_TOKEN_LOCAL como variables de entorno.

Dirección `finora-pago://`

FINORA Pago registra el esquema al instalarse. Tu caja abre la dirección como abriría una página web:

start "" "finora-pago://cobrar?monto=227.00&referencia=8841&callback=http%3A%2F%2F127.0.0.1%3A5000%2Fpago"
start "" "finora-pago://cobrar?monto=64.90&referencia=8842&modo=formal&sandbox=true"

Parámetro	Equivale a
`monto`, `referencia`, `descripcion`, `riel`, `terminalId`, `mostrar`, `modo`, `sandbox`	El campo del mismo nombre
`callback`	`callbackUrl`, codificado como URL
`ttl`	`ttlSegundos`
`campo.<nombre>=` o `campos[<nombre>]=`	Un dato del medio de pago
`pagador.<campo>=`	Un dato del cliente