Skip to main content
Skip table of contents

Api de Consulta con Tarjeta

Response

Objeto operation.transactions para pagos con tarjetas que se encuentra dentro de la trama de respuesta.: API de Consulta.

Field

Description

Accepted Value

Type

Obligatorio

operation.transactions.[].transaction_id

Identificador unico de la transacción

Cadena alfanumérica

String

SI

operation.transactions.[].channel

Canal por la cual se realizó la transacción

  • ecommerce

String

SI

operation.transactions.[].state

Estado actual de la transacción

  • PENDIENTE

  • INVALIDO

  • AUTORIZADO

  • DENEGADO

  • CANCELADO

  • EXPIRADO

  • LIQUIDADO

String

SI

operation.transactions.[].state_reason

Observacion del estado

 

 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.[].payment_method

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

  • CARD

Object

SI

operation.transactions.[].payment_method.method_name

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

Cadena alfabética

String

SI

operation.transactions.[].payment_method.method_detail

Objeto que contiene información detallada relacionada al método. Este objeto varia por método.

 

Object

NO

operation.transactions.[].payment_method.method_detail.masked_pan

Tarjeta enmascarada usada en la transacción

Cadela alfanumérica

String

NO

operation.transactions.[].payment_method.method_detail.brand

Marca de la tarjeta usada en la transacción

Cadena alfabética

String

NO

operation.transactions.[].payment_method.method_detail.bin

Bin de la tarjeta usada en la transacción

Cadena numérica

String

NO

operation.transactions.[].payment_method.method_detail.last_pan

Ultimos 4 dígitos de la tarjeta usada en la transacción

Cadena numérica

String

NO

operation.transactions.[].payment_method.method_detail.card_type

Tipo de tarjeta

Cadela alfanumérica

String

NO

operation.transactions.[].payment_method.method_detail.card_country

Pais de la tarjeta

Cadela alfanumérica

String

NO

operation.transactions.[].payment_method.method_detail.issuer

Banco emisor de la tarjeta

Cadela alfanumérica

String

NO

operation.transactions.[].payment_method.method_detail.installments

Objeto que contiene información de los planes y cuotas usada en la transacción

 

Object

NO

operation.transactions.[].payment_method.method_detail.installments.plan

Plan

  • NORMAL

  • DIFERIDO

String

NO

operation.transactions.[].payment_method.method_detail.installments.installment_number

Número de cuotas

Cadena numérica

String

NO

operation.transactions.[].payment_method.method_details.redirect_url

Visible en estado PENDIENTE

URL del redirect enviado en el Request

Cadena alfanumérica

String

NO

operation.transactions.[].payment_method.method_details.callback_url

URL del callback enviado en el Request

Cadena alfanumérica

String

NO

operation.transactions.[].continue_url

Visible en estado PENDIENTE

URL para continuar el proceso de pago. En el caso del método CARD, se redireccionará a la autenticación.

Cadena alfanumérica

String

NO

operation.transactions.[].expiration_date

Visible en estado PENDIENTE

Objeto que contiene la fecha en la que se expirará la transacción.

 

Object

NO

operation.transactions.[].expiration_date.utc_time

Fecha en UTC

 

String

NO

operation.transactions.[].expiration_date.unix_time

Fecha en unix time

 

Integer

NO

operation.transactions.[].processor_response

Visible en estado AUTORIADO - DENEGADO - EXTORNADO

Objeto que contiene el resultado de la autorización. Los valores son devueltos por la procesadora.

 

Object

NO

operation.transactions.[].processor_response.authorization_code

Código de autorización

Cadena alfanumérica

String

NO

operation.transactions.[].processor_response.brand_transaction_id

ID de la transacción ante la marca

Cadena alfanumérica

String

NO

operation.transactions.[].processor_response.result_message

Objeto que contiene mensaje del resultado de la autorizacion

 

Object

NO

operation.transactions.[].processor_response.result_message.code

Código del resultado de la autorización

Cadena alfanumérica

String

NO

operation.transactions.[].processor_response.result_message.description

Descripción del resultado de la autorización

Cadena alfanumérica

String

NO

operation.transactions.[].authentication_result

Objeto que contiene le resultado de la autenticación usada en al transacción

 

Object

NO

operation.transactions.[].authentication_result.version

Version del protocolo de autenticación

Cadena alfanumérica

String

NO

operation.transactions.[].authentication_result.eci

ECI

Cadena alfanumérica

String

NO

operation.transactions.[].authentication_result.vci

VCI

Cadena alfanumérica

String

NO

operation.transactions.[].authentication_result.ds_transaction_id

DS Transaction ID

Cadena alfanumérica

String

NO

operation.transactions.[].authentication_result.3ds_transaction_id

3DServer Transaction ID

Cadena alfanumérica

String

NO

operation.transactions.[].risk_evaluation

Objeto que contiene el resultado de la evaluación de antifraude.

 

Object

NO

operation.transactions.[].additional_fields

Objeto que contiene los datos adicionales de la transacción enviados en el request

 

Object

NO

operation.transactions.[].lifecycle

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

 

Array

SI

operation.transactions.[].lifecycle.[].state

Estado de la transacción

  • REGISTRADO

  • PENDIENTE

  • INVALIDO

  • AUTORIZADO

  • DENEGADO

  • CANCELADO

  • EXPIRADO

  • LIQUIDADO

String

SI

operation.transactions.[].lifecycle.[].date

Objeto que contiene la fecha en la que se realizó el cambio de estado

 

Object

SI

operation.transactions.[].lifecycle.[].date.utc_time

Fecha en UTC

Cadena alfanumérica

String

SI

operation.transactions.[].lifecycle.[].date.unix_time

Fecha en unix time

Cadena alfanumérica

Integer

SI

Ejemplo 1 (sin Autenticación)

Response de consulta de Tarjeta sin Autenticacion.

JSON
{
    "success": true,
    "merchant_code": "abc",
    "operation": {
        "merchant_operation_number": "2391645",
        "state": "AUTORIZADO",
        "amount": "15000",
        "currency": "604",
        "transactions": [
            {
                "transaction_id": "5hk8rwa3h3cq9oyfs3a28v1ms",
                "channel": "ecommerce",
                "state": "AUTORIZADO",
                "state_reason": "Approval and completed successfully",
                "amount": "15000",
                "currency": "604",
                "payment_method": {
                    "method_name": "CARD",
                    "method_detail": {
                        "masked_pan": "455788******9268",
                        "brand": "VISA",
                        "bin": "455788",
                        "last_pan": "9268",
                        "card_type": "DEBIT",
                        "card_country": "PE",
                        "issuer": "BANCO DE CREDITO DEL PERU - BCP",
                        "installments": {
                            "plan": "01",
                            "installment_number": "2"
                        },
                        "redirect_url": "https://pay-me.com",
                        "callback_url": "https://pay-me.com/callback"
                    }
                },
                "processor_response": {
                    "authorization_code": "055552",
                    "brand_transaction_id": "A055552"
                    "result_message": {
                        "code": "00",
                        "description": "Approval and completed successfully"
                    }
                },
                "lifecycle": [
                    {
                        "state": "REGISTRADO",
                        "date": {
                            "utc_time": "2024-03-12T22:49:36.018Z",
                            "unix_time": 1710282940
                        }
                    },
                    {
                        "state": "PENDIENTE",
                        "date": {
                            "utc_time": "2024-03-12T22:49:36.018Z",
                            "unix_time": 1710282940
                        }
                    },
                    {
                        "state": "AUTORIZADO",
                        "date": {
                            "utc_time": "2024-03-12T22:49:36.018Z",
                            "unix_time": 1710282940
                        }
                    }
                ]
            }
        ]
    },
    "meta": {
        "status": {
            "code": "00",
            "message_ilgn": [
                {
                    "locale": "es_PE",
                    "value": "Se proceso correctamente"
                }
            ]
        }
    }
}

Ejemplo 2 (con Autenticación Redirect)

Response de consulta de Tarjeta con Redirect para un API único de Autorización + Autenticación 3DS.

JSON
{
    "success": true,
    "merchant_code": "abc",
    "operation": {
        "merchant_operation_number": "2391645",
        "state": "PENDIENTE",
        "amount": "15000",
        "currency": "604",
        "transactions": [
            {
                "transaction_id": "5hk8rwa3h3cq9oyfs3a28v1ms",
                "channel": "ecommerce",
                "state": "PENDIENTE",
                "state_reason": "Url generada para continuar con la Autenticacion",
                "continue_url": "https://api.dev.alignet.io/payment/continue/card/81vrxn30vja1gwcfsdng4i5g5",
                "expiration_date": {
                  "utc_time": "2024-03-12T22:49:36.018Z",
                  "unix_time": 1711585037
                  }
                "amount": "15000",
                "currency": "604",
                "payment_method": {
                    "method_name": "CARD",
                    "method_detail": {
                        "masked_pan": "455788******9268",
                        "brand": "VISA",
                        "bin": "455788",
                        "last_pan": "9268",
                        "card_type": "DEBIT",
                        "card_country": "PE",
                        "issuer": "BANCO DE CREDITO DEL PERU - BCP",
                        "installments": {
                            "plan": "01",
                            "installment_number": "2"
                        },
                        "redirect_url": "https://pay-me.com",
                        "callback_url": "https://pay-me.com/callback"
                    }
                },
                "lifecycle": [
                    {
                        "state": "REGISTRADO",
                        "date": {
                            "utc_time": "2024-03-12T22:49:36.018Z",
                            "unix_time": 1710282940
                        }
                    },
                    {
                        "state": "PENDIENTE",
                        "date": {
                            "utc_time": "2024-03-12T22:49:36.018Z",
                            "unix_time": 1710282940
                        }
                    }
                ]
            }
        ]
    },
    "meta": {
        "status": {
            "code": "00",
            "message_ilgn": [
                {
                    "locale": "es_PE",
                    "value": "Se proceso correctamente"
                }
            ]
        }
    }
}

Ejemplo 3 (con Datos de Autenticación)

Response de consulta de Tarjeta con datos resultado de Autenticacion 3DS, consumido anteriormente por otro API 3DS.

JSON
{
    "success": "true",
    "merchant_code": "abc",
    "action": "authorize",
    "merchant_code": "b0deb6f3-e51a-48a7-9268-f1441d46f7bd",
    "merchant_operation_number": "2391645",
    "transaction": {
        "transaction_id": "5hk8rwa3h3cq9oyfs3a28v1ms",
        "channel": "ecommerce",
        "state": "AUTORIZADO",
        "state_reason": "Approval and completed successfully"
        "amount": "15000",
        "currency": "604",
        "payment_method": {
            "method_name": "CARD",
            "method_details": {
                "masked_pan": "411111********1111",
                "brand": "VISA",
                "bin": "411111",
                "last_pan": "9268",
                "card_type": "DEBIT",
                "card_country": "PE",
                "issuer": "BANCO DE CREDITO DEL PERU - BCP",
                "installments": {
                    "plan": "01",
                    "installment_number": "2"
                },
                "callback_url": "https://pay-me.com/callback"
            }
        },
        "processor_response": {
            "authorization_code": "055552",
            "brand_transaction_id": "100B",
            "result_message": {
                "code": "00",
                "description": "Approval and completed successfully"
            }
        },
        "additional_fields": null,
        "authentication_result": {
            "version": "2.1.0",
            "eci": "05",
            "vci": "TSYF",
            "ds_transaction_id": "",
            "3ds_transaction_id": ""
        },
        "lifecycle": [
            {
                "state": "REGISTRADO",
                "date": {
                    "utc_time": "2024-03-12T22:49:36.018Z",
                    "unix_time": 1710282940
                }
            },
            {
                "state": "PENDIENTE",
                "date": {
                    "utc_time": "2024-03-12T22:49:36.018Z",
                    "unix_time": 1710282940
                }
            },
            {
                "state": "AUTORIZADO",
                "date": {
                    "utc_time": "2024-03-12T22:49:36.018Z",
                    "unix_time": 1710282940
                }
            }
        ]
    },
    "meta": {
        "status": {
            "code": "00",
            "message_ilgn": [
                {
                    "locale": "es_PE",
                    "value": "Procesado correctamente"
                }
            ]
        }
    }
}
JavaScript errors detected

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

If this problem persists, please contact our support.