Saltar a contenido

CONTEXT — GatewayPrismaQR glossary

Domain vocabulary only. Terms come from Prisma's Integradores Grandes Cuentas QR v0.27 (pages cited) and from the POS contract inherited from GatewayQR. Code identifiers are English; the Spanish term is the one domain experts use.

Term (domain) Code name Meaning
Gateway QR (Prisma / Payway / Decidir) PrismaGateway Prisma's QR switch. Holds intentions, talks to wallets and card brands, calls our callbacks (p.5, 7).
Sistema Propio / Integrador Grande Cuenta — Us. The integrator between the merchant's POS and Prisma's Gateway QR.
Billetera Wallet Mobile app that scans the QR and pays (MODO, Cuenta DNI, BSF, …). Identified by wallet / wallet_code.
Comercio Merchant Legal entity identified by CUIT. Owns branches.
Sucursal Branch Store of a merchant. Prisma field branch (≤ 25 chars, merchant-defined).
Caja Checkout Point of sale inside a branch. Prisma field checkout (≤ 25 chars, unique per branch). One fixed QR per checkout.
POS Pos The register software at a checkout that calls our POS API.
Terminal Terminal 8-char terminal_number sent to the card brand; owns the trace_number / ticket_number sequences.
Establecimiento Establishment Acquirer establishment id per merchant and payment method (establishment_id).
Medio de pago PaymentMethod Prisma payment_method_id (e.g. 1 Visa, 31 Visa Débito, 104 Mastercard, 112 Transferencias 3.0).
Intención de pago Intention Prisma record for one checkout's pending charge. The latest intention for a checkout supersedes the previous one (p.7).
BINs Bins First 6 or 8 digits of each card the wallet user can pay with, plus bank, sent to us by Prisma after the scan (p.19).
Intención completa CompleteIntention Our answer to the BINs: per payment method, the installment plans, CFT/TNA, establishment, terminal, trace, ticket and benefits. Must reach Prisma within 27 s (p.22).
Plan de cuotas InstallmentPlan Number of installments with total, per-installment amount, CFT and TNA. The 1-installment plan is always present.
Cuotas MiPyME — Government installment plans (plan 13 = 3 installments, plan 16 = 6).
Tarjeta de beneficio BenefitCard Loyalty card (e.g. Clarín 365) the wallet presents. Out of scope (Q13).
Recargo/descuento Adjustment Signed percentage of a plan (positive surcharge, negative discount), as fRecDescMPP in the POS. BeneficiosCenter is out of scope.
Cashback Cashback Cash withdrawal at the checkout. Only with Visa Débito (p.97).
Anulación forzada ForcedAnnulment Reversal of an approved payment requested by us (POST /forcedannulments).
Devolución forzada ForcedRefund Total refund of an approved payment requested by us (POST /forcedrefunds). Partial refunds do not exist.
Notificación Notification Prisma's push to us with the final result of a payment, annulment or refund.
Consulta StatusQuery Our pull to Prisma (GET /payments/qr, /annulments, /refunds) when a notification does not arrive.
Id de transacción (trxid) PaymentId Our id handed to the POS by POST /api/trxid; the handle for pay, annul and status.
Importe recargo/descuento adjustmentAmount importe_recdesc in the POS contract: negative for a discount, positive for a surcharge; importe + importe_recdesc == importe_final.
Comercio Merchant One per legal owner (CUIT). A chain with several partners is several merchants (e.g. ALMACOR-ESCANUELA, ALMACOR-PALPASELLI); the POS sends the name in comercio.
Plan de cuotas InstallmentPlan A plan the gateway holds per merchant and branch (method, bank, BIN range, installments, signed %, validity). The gateway is the only source of plans (Mode B of ADR-003); Mode A, the POS sending promotions, was removed on 2026-10-28 and a promos list in trxpago is ignored.
Rango de tarjeta CardRange POS dM_Banda row: BIN prefix from/to, ordered; maps a card to its plans (dM_TarPl).
Compensación Compensation Automatic cancel or annulment of a payment the POS was told did not go through (ADR-002).
RouterQR — Per-chain router some POS use in front of the gateways (two slots: MERCADOPAGO and DINI). Almacor calls the gateway directly over VPN.