Skip to main content
Skip table of contents

API de Autorización con QR

Request

Objeto method_details para QR que se encuentra dentro de la trama de autorización: API de Autorización - ecommerce.

Field

Description

Accepted Value

Type

Obligatorio

callback_url

URL donde se realizará la notificacion host to host (server to server)

Cadena alfanumérica

String

NO

Ejemplo

JSON
{
    "action": "authorize",
    "channel": "ecommerce",
    "merchant_code":"b0deb6f3-e51a-48a7-9268-f1441d46f7bd",
    "merchant_operation_number": "5733813",
    "payment_method": {
        "method_name": "QR",
        "method_details": {
            "callback_url": "https://pay-me.com/callback"
        }
    },
    "payment_details": {
        "amount": "15000",
        "currency": "604",
        "billing": {
            "first_name": "Pedro",
            "last_name": "Miranda",
            "email": "pedro@pay-me.com",
            "phone": {
                "country_code": "+51",
                "subscriber": "999835685"
            },
            "location": {
                "line_1": "Av. Casimiro Ulloa 333",
                "line_2": "Miraflores",
                "city": "Lima",
                "state": "Lima",
                "country": "Peru"
            }
        },
        "shipping": {
            "first_name": "Pedro",
            "last_name": "Miranda",
            "email": "pedro@pay-me.com",
            "phone": {
                "country_code": "+51",
                "subscriber": "999835685"
            },
            "location": {
                "line_1": "Av. Casimiro Ulloa 333",
                "line_2": "Miraflores",
                "city": "Lima",
                "state": "Lima",
                "country": "Peru"
            }
        },
        "customer": {
            "first_name": "Pedro",
            "last_name": "Miranda",
            "email": "pedro@pay-me.com",
            "phone": {
                "country_code": "+51",
                "subscriber": "999835685"
            },
            "location": {
                "line_1": "Av. Casimiro Ulloa 333",
                "line_2": "Miraflores",
                "city": "Lima",
                "state": "Lima",
                "country": "Peru"
            }
        },
        "product_details": []
        }
    }
}

Response

Objeto transaction para pagos con QR que se encuentra dentro de la trama de respuesta: API de Autorización - ecommerce.

Field

Description

Accepted Value

Type

Obligatorio

transaction.transaction_id

Identificador unico de la transacción

Cadena alfanumérica

String

SI

transaction.channel

Canal por la cual se realizó la transacción

  • ecommerce

String

SI

transaction.state

Estado actual de la transacción

  • PENDIENTE

  • INVALIDO

String

SI

transaction.state_reason

Observacion del estado

 

 

SI

transaction.amount

Monto de la transacción

Cadena numérica

String

SI

transaction.currency

Código de la moneda de la operación

Cadena numérica

String

SI

transaction.payment_method

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

  • QR

Object

SI

transaction.payment_method.method_name

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

Cadena alfabética

String

SI

transaction.payment_method.method_details

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

Object

NO

transaction.payment_method.method_details.callback_url

URL de callback enviado en el request

Cadena alfanumérica

String

NO

transaction.expiration_date

Visible en estado PENDIENTE

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

 

Object

NO

transaction.expiration_date.utc_time

Fecha en UTC

 

String

NO

transaction.expiration_date.unix_time

Fecha en unix time

 

Integer

NO

transaction.processor_response.date

Fecha de la procesadora

Cadena alfanumérica

NO

transaction.processor_response.qr_image

Imagen del QR en base 64

Cadena alfanumérica

String

NO

transaction.processor_response.qr_id

ID del QR

Cadena alfanumérica

String

NO

transaction.processor_response.result_message

Objeto que contiene mensaje del resultado de la autorizacion

 

Object

NO

transaction.processor_response.result_message.code

Código del resultado de la autorización

Cadena alfanumérica

String

NO

transaction.processor_response.result_message.description

Descripción del resultado de la autorización

Cadena alfanumérica

String

NO

transaction.additional_fields

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

 

Object

NO

transaction.lifecycle

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

 

Array

SI

transaction.lifecycle.[].state

Estado de la transacción

  • REGISTRADO

  • PENDIENTE

  • INVALIDO

String

SI

transaction.lifecycle.[].date

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

 

Object

SI

transaction.lifecycle.[].date.utc_time

Fecha en UTC

Cadena alfanumérica

String

SI

transaction.lifecycle.[].date.unix_time

Fecha en unix time

Cadena alfanumérica

Integer

SI

Ejemplo

CODE
{
    "success": "true",
    "action": "authorize",
    "merchant_code": "b0deb6f3-e51a-48a7-9268-f1441d46f7bd",
    "merchant_operation_number": "2391645",
    "transaction": {
        "transaction_id": "5hk8rwa3h3cq9oyfs3a28v1ms",
        "channel": "ecommerce",
        "state": "AUTORIZADO",
        "state_reason": "QR generado exitosamente"
        "amount": "15000",
        "currency": "604",
        "payment_method": {
            "method_name": "QR",
            "method_details": {
              "callback_url": "https://pay-me.com/callback"
              }
        },
        "expiration_date": {
          "utc_time": "2024-03-12T22:49:36.018Z",
          "unix_time": 1711585037
          }
        "processor_response": {
            "date": "2024-03-26 19:17:19.599715",
            "qr_image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAV4AAAFeAQAAAADlUEq3AAAFdElEQVR42u1bQYrrWAxU8MLLHME36VzMYEMuFt/kHcFLL0z0VVV67vTAwCxmI35nYZJ2pSGSnlQqyeb//XXaL/jvAu9mdouLv2zu7+7u4zv+bl/3Z/P3/cT7pSp4cd/2wY8vs8kscMfXnVZajTfc93mKS1nwbOO223RY/PL4+d7CEIsfN3/ia2GNLcBhptJg98CFS+NrS7MboneL+B2BC++f9cHPsEEYAqh2IHrhZMaz2+Of1igGZjzz1EZQ88DCEPGaLT4OLRx//gz+YmDi5omu/bfLz/RVC8zXzmy7tDiha7xDKL/i1Kb37z8LUDXwmcfUkIwixzb8dEMGvooNL0tRcNzFL50OZNsI4IhiixTkyLvxD+LARvJtPZ6LguHa8RU34vUEJA7sVxzYEXGA88tqWhVM1y4tAjgy0sPxDXCBNzKSbsR/Ga+MVBA88XAi2zKzthExbuA+UWxWi39wBiStUQ+MAwvmRmuA8cSp9YxnFFInZ8DHouBwLepl44WxO35n4EdcGO1X8NcDg/E4Pe3rBHIXFNbmCaEcjMeRhgHZGM8VwTicqBpB3wa4lqEcldPE0eO7iGdQ9rrgEXl3RI/ojF2EdxhiVZ2JmhKnti6YRYQUR7GLSoK+EbnY01YLT21VMH40ic39KRoQdlmZYxutAZxHoC9FwTirL/X7SLSoJKiXJLMMdDG8umAGK/4WYTtJ1UBhAQDxTMaD3irdXRE8MQ8daIKpaqD1CIgNqClDIwHqNaUgGP0vKM4hcSog9lDlxA2RhCfpQlVwdv6sH8F9WD7Vb1EXoM/RUHpRMNzt8u98kdQzpQ0IOGDm7SOeq4H37lC0+vr5t95QQl6MODBQv7LgSEHh6QHkboHkHcZ5M0Ht/cBu6reWouDdlH3Ac0DuoKRSwLl3x+v8ZvAXBAfPeSNsN5I7Y5c1i8eCmZMpsAmpCkbjZFIRG9t/qsT6CI5OYbUz84LgeI3JWSPbot/vGmPU0EeXd2CXomDpwIP4KRkA8xD0jSnfIQS8Ltigb9DnimeTvsEBVDgZ4sDyzcwLgockqcZhoqXjqf1LU73tmlFVBS8cNmmiGDXlKRWHM2H0Vs6a0q1REMwboHRdOp3YQfLockYFMus9I1UExw3UFLJwKYt5fpmuno2qeB7YkuDVpDFCsaGISroKd+u7cHf75nX1wApWCcQG11JU9C3zkAScZAUVwVTAoW+wSmrMxt0FeH+DsKrKefeqYLZQ/NvSsroEmAqVNjRIYT9b6WJgClED76IdZv+BeDbu0+RM2C9mXg6cYxiM2VbtlwjyVrOMCWpSv6pgpJucd4uUH6bzmwOAnC32SU058K6RWuN8hmzO/ZL4v1hsKKyWBWuYLbIj/dRzMEz2ynfyeVGwpjKnLqQ4Oc2g+mbcJFKqqgrmGIYSP+OZtIe6FJcVVp3fj9goCL4axdRPyV6himveTdXqskY98MBhttQ36olcPOmzNpoEmsc1HK8GdhX/vvyFZER+wN2FlFgx6+gFqByYu4gadXvra0LrJOPctHPy7L1VRbDqB4hrBDU3aygvsvMnFRKvcy8LPvsckXM13TipviXN4+qQ9Q2ccmAxVRBwm+Vfaao3+dzZRkICqQp2Du8xcYKMYeoWjTxHkoA2v1/XaLUc2L+fMmBmzRqa0wx8RNH8sWpbCsxpqUvQyCctIC+KqHPvK1WrsmBKNGu3hp6vOCet0L60MkwqtFQFSz/V0JubNdSLx3x2BHtfH2OdwmDQN0qJekKGU+5R1kDRfHhtMEa/ZDyMbI5mdo6iuLYwX6u2FcGMZyUePSvD9eADA6hUqNBQfjxyUg1sOT3c9EQQTcJSuU5aYICZPhdUioF/Hxf9Bf8P4D+ib+Aw9vPg5wAAAABJRU5ErkJggg==",
            "qr_id": "6d5d1ffc79234991b5592b825d6ec097",
            "result_message": {
                "code": 0,
                "description": "Exito"
                }
        },
        "additional_fields": null,
        "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": "Procesado correctamente"
                }
            ]
        }
    }
}
JavaScript errors detected

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

If this problem persists, please contact our support.