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. |