Getnet DocsGetnet Docs

Especificaciones de impresión de recibos

View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page
Connect to CursorUse these docs in CursorConnect to VS CodeUse these docs in VS Code

Las normas de cumplimiento normativo exigen que se impriman datos específicos en los recibos en función del tipo de transacción. Esta referencia describe los campos obligatorios y las reglas de formato.

1. Recibo de venta estándar

Debes imprimir los siguientes campos recibidos en el payload de notificación:

  1. Cabecera: Nombre del comercio, Código de comercio (comercio), Número de terminal (terminal).
  2. Detalles de la tarjeta: PAN enmascarado (tarjetaClienteRecibo).
  3. Transacción: Fecha, Hora, Importe, Moneda.
  4. Referencias: Código de autorización (Aut), ID de pedido (Ped).
  5. Recuadro de firma: Obligatorio por defecto, a menos que estén presentes indicadores (flags) de excepción específicos (ver más abajo).

2. Requisitos específicos de la tarjeta

AMEX (American Express)

Si el campo marcaTarjeta es 8 (AMEX), debes incluir datos adicionales:

  • Fecha de caducidad: Debes imprimir la fecha de caducidad de la tarjeta (p. ej., Cad: 12/49).
  • Logotipo: Se recomienda imprimir el logotipo de American Express en la cabecera del recibo si tu impresora soporta gráficos.

3. Requisitos EMV (Chip)

Si la respuesta contiene etiquetas (tags) EMV, estas deben imprimirse en el recibo para probar la verificación del chip:

  • Etiqueta de la aplicación (etiquetaApp): p. ej., VISA CLASSIC
  • AID (idapp): p. ej., A0000000031010
  • Núm. Trans. (conttrans): Contador de la transacción.
  • Cód. Resp. (codrespauto): Código de respuesta de la autorización.

4. Excepciones: Cuándo omitir la firma

La línea de firma (y la Copia para el comercio del recibo) puede omitirse solo si están presentes indicadores específicos en la respuesta.

Condiciones

  • reciboOpcional = TRUE:

    • Significado: El sistema indica que la impresión del recibo es opcional (p. ej., flujo de recibo digital).
    • Acción: Puedes omitir por completo la impresión de ambas copias (Comercio y Cliente).

  • ReciboSoloCliente = TRUE:

    • Significado: El sistema recomienda imprimir únicamente la copia para el cliente.
    • Acción: No imprimas el recuadro de firma. Opcionalmente, puedes omitir por completo la impresión de la Copia para el comercio.

  • autenticadoPorPin = TRUE:

    • Significado: El usuario verificó la transacción mediante PIN.
    • Acción: No imprimas el recuadro de firma. En su lugar, imprime el texto proporcionado en el objeto Literales (p. ej., Literales.autenticadoPorPin).

  • operContactLess = TRUE:

    • Significado: La tarjeta se acercó al lector (NFC).
    • Acción: Imprime el Símbolo de Contactless. Si tu impresora no soporta gráficos, imprime el texto proporcionado en el objeto Literales o un texto estándar como “Op. Contactless”.

5. Dynamic Currency Conversion (DCC)

Si la transacción involucró conversión de divisa, debes imprimir el texto exacto proporcionado en el objeto Literales para cumplir con las normativas financieras.

Diseño obligatorio:

  1. Aviso legal: Imprime el bloque Literales.literal (p. ej., “I accept that I have been offered a choice…”).
  2. Detalles del tipo de cambio: Itera e imprime las líneas de Literales.datosDCC:
    • linLitTrans: “TRANSACTION CURRENCY”
    • linLitDivisa: Importe en divisa extranjera (p. ej., USD 16.37)
    • linCambio: Tipo de cambio (p. ej., 1 USD = 0.85 EUR)
    • linMarkUp: Texto de la comisión (p. ej., INCLUDES 2.0% MARK-UP)

6. Recibos de devolución

Requisito obligatorio:

A diferencia de las ventas, los Recibos de devolución deben incluir siempre un recuadro de firma en la Copia para el cliente.

  • Motivo: El comercio debe firmar o sellar este recibo para confirmar al cliente que los fondos han sido devueltos.