Response

La respuesta del servicio de autorización aplica para ambos canales:

Ecommerce
POS

Esta estructura permite identificar si la petición fue procesada, el resultado enviado por la marca, los identificadores de trazabilidad y el estado interno de la operación.

Encabezados HTTP de respuesta

Las respuestas HTTP del servicio deben incluir los siguientes encabezados de seguridad:

Strict-Transport-Security: max-age=63072000; includeSubDomains; preload
Content-Security-Policy: child-src *; frame-ancestors *;
X-Frame-Options: SAMEORIGIN
X-Content-Type-Options: nosniff
Referrer-Policy: strict-origin, same-origin
Permissions-Policy: screen-wake-lock=*

Encabezado	Valor	Propósito
`Strict-Transport-Security`	`max-age=63072000; includeSubDomains; preload`	Obliga a utilizar HTTPS durante el periodo configurado.
`Content-Security-Policy`	`child-src ; frame-ancestors ;`	Define los orígenes permitidos para contenido embebido y framing.
`X-Frame-Options`	`SAMEORIGIN`	Limita la carga de la página en frames al mismo origen.
`X-Content-Type-Options`	`nosniff`	Evita que el navegador intente inferir un tipo de contenido diferente.
`Referrer-Policy`	`strict-origin, same-origin`	Controla la información de referencia enviada durante la navegación.
`Permissions-Policy`	`screen-wake-lock=*`	Permite el uso de Screen Wake Lock según la lista de orígenes configurada.

Estos encabezados deben configurarse en el servidor, API gateway, CDN o proxy inverso que entrega la respuesta. frame-ancestors * permite que cualquier origen inserte la página en un frame y puede entrar en conflicto con X-Frame-Options: SAMEORIGIN. Valida esta combinación con el equipo de seguridad antes de usarla en producción.

Response exitoso

La respuesta HTTP principal contiene los encabezados de seguridad y el cuerpo JSON de la operación:

HTTP/1.1 200 OK
Content-Type: application/json
Strict-Transport-Security: max-age=63072000; includeSubDomains; preload
Content-Security-Policy: child-src *; frame-ancestors *;
X-Frame-Options: SAMEORIGIN
X-Content-Type-Options: nosniff
Referrer-Policy: strict-origin, same-origin
Permissions-Policy: screen-wake-lock=*

{
  "success": "true",
  "transaction": {
    "tk_transaction_identifier": "42c2ff66-3eb0-4a69-9848-430fc722f6bc",
    "processor_response": {
      "message": {
        "code": "00",
        "description": "Pago exitoso"
      },
      "brand_transaction_identifier": "306190611475347",
      "authorization_identification_response": "087657",
      "retrieval_reference_code": "619016007284",
      "system_trace_audit": "007284",
      "response_code": "00",
      "date_settlement": "0710"
    },
    "meta": {
      "status": {
        "code": "success_operation",
        "message_ilgn": [
          {
            "locale": "es_PE",
            "value": "Petición procesada correctamente"
          }
        ]
      },
      "metrics": {
        "aggregate": {
          "start": "1783616336421",
          "end": "1783616348410",
          "duration": {
            "milliseconds": "11988"
          }
        }
      }
    }
  }
}

Descripción de campos

Campo	Tipo	Descripción
`success`	string	Indica si la operación fue procesada por el servicio. Valores: `true` o `false`.
`transaction.tk_transaction_identifier`	string UUID	Identificador único de la transacción en el sistema.
`transaction.processor_response.message.code`	string	Código de respuesta de la marca. `00` indica operación aprobada.
`transaction.processor_response.message.description`	string	Descripción legible del resultado de la operación.
`transaction.processor_response.brand_transaction_identifier`	string	Identificador de la transacción asignado por la marca.
`transaction.processor_response.authorization_identification_response`	string	Código de autorización de la operación. Normalmente contiene 6 dígitos.
`transaction.processor_response.retrieval_reference_code`	string	RRN, Retrieval Reference Number. Se utiliza para consultas, trazabilidad y conciliación.
`transaction.processor_response.system_trace_audit`	string	STAN, System Trace Audit Number. Identificador de auditoría de la transacción.
`transaction.processor_response.response_code`	string	Código ISO de respuesta. `00` indica aprobación.
`transaction.processor_response.date_settlement`	string	Fecha estimada de liquidación en formato `MMDD`.
`transaction.meta.status.code`	string	Estado interno de la operación. Ejemplos: `success_operation`, `invalid_request`.
`transaction.meta.status.message_ilgn`	array	Lista de mensajes localizados asociados al resultado de la operación.
`transaction.meta.status.message_ilgn[].locale`	string	Locale del mensaje. Ejemplo: `es_PE`.
`transaction.meta.status.message_ilgn[].value`	string	Mensaje descriptivo del resultado de la operación.
`transaction.meta.metrics.aggregate.start`	string	Marca de tiempo de inicio del procesamiento.
`transaction.meta.metrics.aggregate.end`	string	Marca de tiempo de fin del procesamiento.
`transaction.meta.metrics.aggregate.duration.milliseconds`	string	Tiempo total de procesamiento en milisegundos.

Interpretación de respuesta exitosa

Una autorización se considera aprobada cuando los principales campos de respuesta tienen los siguientes valores:

Campo	Valor esperado	Interpretación
`success`	`true`	La petición fue procesada por el servicio.
`processor_response.message.code`	`00`	La marca respondió con aprobación.
`processor_response.response_code`	`00`	Código ISO de aprobación.
`meta.status.code`	`success_operation`	Estado interno exitoso.

Identificadores de trazabilidad

Los siguientes campos pueden utilizarse para seguimiento transaccional, consultas, conciliación, soporte operativo y validación con la marca.

Campo	Uso
`tk_transaction_identifier`	Identificador único interno de la transacción.
`brand_transaction_identifier`	Identificador asignado por la marca.
`authorization_identification_response`	Código de autorización de la transacción.
`retrieval_reference_code`	RRN utilizado para trazabilidad, consultas y conciliación.
`system_trace_audit`	STAN de la transacción.
`date_settlement`	Fecha estimada de liquidación.

Objeto `processor_response`

El objeto processor_response contiene la respuesta recibida desde el procesador o la marca.

{
  "processor_response": {
    "message": {
      "code": "00",
      "description": "Pago exitoso"
    },
    "brand_transaction_identifier": "306190611475347",
    "authorization_identification_response": "087657",
    "retrieval_reference_code": "619016007284",
    "system_trace_audit": "007284",
    "response_code": "00",
    "date_settlement": "0710"
  }
}

Campo	Descripción
`message.code`	Código de respuesta de la marca.
`message.description`	Descripción del resultado de la operación.
`brand_transaction_identifier`	Identificador de la transacción asignado por la marca.
`authorization_identification_response`	Código de autorización.
`retrieval_reference_code`	RRN de la transacción.
`system_trace_audit`	STAN de la transacción.
`response_code`	Código ISO de respuesta.
`date_settlement`	Fecha estimada de liquidación en formato `MMDD`.

Objeto `meta.status`

El objeto meta.status contiene el estado interno de la operación dentro del sistema.

{
  "status": {
    "code": "success_operation",
    "message_ilgn": [
      {
        "locale": "es_PE",
        "value": "Petición procesada correctamente"
      }
    ]
  }
}

Campo	Descripción
`code`	Código interno del estado de la operación.
`message_ilgn`	Lista de mensajes localizados.
`message_ilgn[].locale`	Locale del mensaje.
`message_ilgn[].value`	Descripción localizada del resultado.

Objeto `meta.metrics`

El objeto meta.metrics contiene información de tiempos de procesamiento de la operación.

{
  "metrics": {
    "aggregate": {
      "start": "1783616336421",
      "end": "1783616348410",
      "duration": {
        "milliseconds": "11988"
      }
    }
  }
}

Campo	Descripción
`aggregate.start`	Marca de tiempo de inicio del procesamiento.
`aggregate.end`	Marca de tiempo de fin del procesamiento.
`aggregate.duration.milliseconds`	Duración total del procesamiento en milisegundos.

Consideraciones

El campo success indica si la petición fue procesada por el servicio.
Una operación aprobada debe validar el código de respuesta de la marca y el estado interno de la operación.
El campo tk_transaction_identifier debe almacenarse para consultas posteriores.
El retrieval_reference_code y el system_trace_audit son relevantes para trazabilidad operativa.
El authorization_identification_response debe utilizarse como código de autorización de la operación.
El campo date_settlement permite identificar la fecha estimada de liquidación.
Los tiempos de meta.metrics pueden utilizarse para monitoreo, soporte y análisis de performance.

Primeros pasos

Ayuda y contacto

Encabezados HTTP de respuesta

Response exitoso

Descripción de campos

Interpretación de respuesta exitosa

Identificadores de trazabilidad

Objeto `processor_response`

Objeto `meta.status`

Objeto `meta.metrics`

Consideraciones

Relación con los canales de autorización

Ecommerce

POS

​Encabezados HTTP de respuesta

​Response exitoso

​Descripción de campos

​Interpretación de respuesta exitosa

​Identificadores de trazabilidad

​Objeto processor_response

​Objeto meta.status

​Objeto meta.metrics

​Consideraciones

​Relación con los canales de autorización

Ecommerce

POS

Encabezados HTTP de respuesta

Response exitoso

Descripción de campos

Interpretación de respuesta exitosa

Identificadores de trazabilidad

Objeto `processor_response`

Objeto `meta.status`

Objeto `meta.metrics`

Consideraciones

Relación con los canales de autorización