Skip to main content
Skip table of contents

API de Consulta

El API de Consulta permite consultar una transacción generada anteriormente por el API de Autorizacion.

REQUEST

Path

Method: GET

URL: {{base}}/charges/{{merchant_code}}/{{merchant_operation_number}}/{{transaction_id}}

Field

Description

Accepted Value

Type

merchant_code

Identificador del comercio

Cadena Alfanumérica

String

merchant_operation_number

Numero de operación

Cadena Alfanumérica

String

transaction_id

Identificador único de la transacción. Es usando solamente para realizar consultas de transacciones

Cadena Alfanumérica

String

Headers

Para todos los métodos de pagos, se enviará los siguientes parámetros en la cabecera de la petición:

Field

Description

Accepted Value

Type

Authorization

Token de identificación para uso del API creado previamente en API de Seguridad

Cadena alfanumérica

String

RESPONSE

Operación

Field

Description

Accepted Value

Type

Obligatorio

success

Indica si el proceso se realizó correctamente

Cadena Alfanumérica:

  • true

  • false

String

SI

merchant_code

Identificador del comercio

Cadena Alfanumérica

String

SI

operation

Objeto que contiene el detalle de la operación

 

Object

SI

operation.merchant_operation_number

Número de pedido de la operación que fue cancelado o extornado

Cadena numérica mayor o igual de 6 dígitos

String

SI

operation.amount

Monto de la operación

Cadena Numérica

String

SI

operation.currency

Código de la moneda de la operación

Cadena Numérica

String

SI

operation.created_at

Fecha y hora de la creación de la operación

Fecha y Hora

String

SI

operation.state

Estado actual de la operación

  • REGISTRADO

  • PENDIENTE

  • AUTORIZADO

  • CANCELADO

  • EXPIRADO

  • LIQUIDADO

  • DEPOSITADO

String

SI

operation.additional_fields

Datos adicionales de la operación que fue enviado al momento de realizar la autorización

 

JSON

SI

operation.transactions

Array que contiene el listado de transacciones realizadas sobre la operación

 

Array

SI

operation.transactions.[].transaction_id

Identificador unico de la transacción

Cadena Alfanumérica

String

SI

operation.transactions.[].state

Estado actual de la transacción

  • REGISTRADO

  • PENDIENTE

  • AUTORIZADO

  • CANCELADO

  • EXPIRADO

  • LIQUIDADO

  • DEPOSITADO

String

SI

operation.transactions.[].amount

Monto de la transacción

Cadena Numérica

String

SI

operation.transactions.[].currency

Código de la moneda de la operación

Cadena Numérica

String

SI

operation.transactions.[].created_at

Fecha y Hora de creación de la transacción

Fecha y Hora

String

SI

operation.transactions.[].authorize_at

Fecha y Hora de la autorización de la transacción

Fecha y Hora

String

SI

operation.transactions.[].expired_at

Fecha y Hora de expiración de la transacción

Fecha y Hora

String

SI

operation.transactions.[].payment_method

Objeto que contiene información sobre el método de pago usado en la transacción

 

Object

SI

operation.transactions.[].payment_method.method_name

Nombre del método de pago usado en la transacción

Cadena Alfanumérica

String

SI

operation.transactions.[].lifecycle

Array que contiene listado de los estado por la cual pasó la transacción

 

Array

SI

meta

Objeto que contiene metadados del flujo ejecutado

 

Object

SI

meta.status

Objeto que contiene el resultado del flujo ejecutado

 

Object

SI

meta.status.code

Código que representa el resultado del flujo ejecutado

Cadena numérica

String

SI

meta.status.message_ilgn

Objeto que contiene el mensaje resultante del flujo

 

Object

SI

meta.status.message_ilgn.[].locale

Localidad a nivel de lenguaje para el mensaje del flujo ejecutado

Cadena alfanumérica

String

SI

meta.status.message_ilgn.[].value

Mensaje resultante del flujo ejecutado

Cadena alfanumérica

String

SI

Ejemplo

JSON
{
    "success": true,
    "merchant_code":"b0deb6f3-e51a-48a7-9268-f1441d46f7bd",
    "operation": {
        "merchant_operation_number": "2391645",
        "amount": "15000",
        "currency": "604",
        "created_at": "2024-01-17T17:27:30.705256+00:00",
        "state": "AUTORIZADO",
        "additional_fields": null,
        "transactions": [
            {
                "transaction_id": "5hk8rwa3h3cq9oyfs3a28v1ms",
                "state": "AUTORIZADO",
                "amount": "15000",
                "currency": "604",
                "created_at": "2024-01-17T17:27:30.715473+00:00",
                "authorize_at": null,
                "expired_at": null,
                "payment_method": {
                    "method_name": "CARD"
                },
                "lifecycle": [
                    {
                        "lifecycle_id": "776b6c17-fe8a-4c43-b4be-4e200028f5dc",
                        "state": "REGISTRADO",
                        "date": "2024-01-17T17:27:30.715512+00:00"
                    },
                    {
                        "lifecycle_id": "03b28172-4a2b-4541-8dbc-a8dd487a8ff4",
                        "state": "PENDIENTE",
                        "date": "2024-01-17T17:27:30.747792+00:00"
                    },
                    {
                        "lifecycle_id": "7283b732-dd6f-4ea1-9d70-71f8f1f85164",
                        "state": "AUTORIZADO",
                        "date": "2024-01-17T17:27:46.218381+00:00"
                    }
                ]
            }
        ]
    },
    "meta": {
        "status": {
            "code": "00",
            "message_ilgn": [
                {
                    "locale": "es_PE",
                    "value": "Se proceso correctamente"
                }
            ]
        }
    }
}

Transacción

Se devolverá la misma respuesta que la Operación, pero solo con una Transaccion dentro de “transactions”.

Ejemplo

JSON
{
    "success": true,
    "merchant_code":"b0deb6f3-e51a-48a7-9268-f1441d46f7bd",
    "operation": {
        "merchant_operation_number": "2391645",
        "amount": "15000",
        "currency": "604",
        "created_at": "2024-01-17T17:27:30.705256+00:00",
        "state": "AUTORIZADO",
        "additional_fields": null,
        "transactions": [
            {
                "transaction_id": "5hk8rwa3h3cq9oyfs3a28v1ms",
                "state": "AUTORIZADO",
                "amount": "15000",
                "currency": "604",
                "created_at": "2024-01-17T17:27:30.715473+00:00",
                "authorize_at": null,
                "expired_at": null,
                "payment_method": {
                    "method_name": "CARD"
                },
                "lifecycle": [
                    {
                        "lifecycle_id": "776b6c17-fe8a-4c43-b4be-4e200028f5dc",
                        "state": "REGISTRADO",
                        "date": "2024-01-17T17:27:30.715512+00:00"
                    },
                    {
                        "lifecycle_id": "03b28172-4a2b-4541-8dbc-a8dd487a8ff4",
                        "state": "PENDIENTE",
                        "date": "2024-01-17T17:27:30.747792+00:00"
                    },
                    {
                        "lifecycle_id": "7283b732-dd6f-4ea1-9d70-71f8f1f85164",
                        "state": "AUTORIZADO",
                        "date": "2024-01-17T17:27:46.218381+00:00"
                    }
                ]
            }
        ]
    },
    "meta": {
        "status": {
            "code": "00",
            "message_ilgn": [
                {
                    "locale": "es_PE",
                    "value": "Se proceso correctamente"
                }
            ]
        }
    }
}

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.