Skip to main content
Skip table of contents

API de Autorización con Tarjeta

Request

Objeto method_details para tarjetas que se encuentra dentro de la trama de autorización: API de Autorizacion.

Field

Description

Accepted Value

Type

Obligatorio

pan

Número de la tarjeta

Cadena numérica

String

SI

expiry_date

Fecha expiración de la tarjeta en el formato MMYY

Cadena numérica

String

SI

security_code

Código de seguridad de la tarjeta (CVV)

Cadena numérica

String

SI

card_holder

Objeto que contiene información del titular de la tarjeta

Object

SI

card_holder.first_name

Nombres del titular de la tarjeta

Cadena alfanumérica

String

SI

card_holder.last_name

Apellidos del titular de la tarjeta

Cadena alfanumérica

String

SI

card_holder.email

Correo electrónico el titular de la tarjeta

Cadena alfanumérica

String

SI

card_holder.phone

Objeto con información del teléfono del titular de la tarjeta

Object

SI

card_holder.phone.prefix

Código del pais del teléfono

Cadena numérica

String

SI

card_holder.phone.number

Numero del teléfono

Cadena numérica

String

SI

redirect_url

URL donde se realizará el redirect cuando finalice la autorización

*Aplica para Comercios con Autenticacion 3DS para tarjeta en una sola API.

Cadena alfanumérica

String

NO*

callback_url

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

*Aplica para Comercios con Autenticacion 3DS para tarjeta en una sola API cuando es variable.

Cadena alfanumérica

String

NO*

authentication_result.3ds_secure

Objeto con información del resultado de autenticación 3DSecure

Object

NO

authentication_result.3ds_secure.version

Versión del protocolo

Cadena alfanumérica

String

NO

authentication_result.3ds_secure.electronic_commerce_indicator

Valor del ECI

Cadena alfanumérica

String

NO

authentication_result.3ds_secure.cardholder_authentication_verification_value

Valor del CAVV

Cadena alfanumérica

String

NO

authentication_result.3ds_secure.ds_transaction_id

Valor del directory server transaction id

Cadena alfanumérica

String

NO

authentication_result.3ds_secure.tds_transaction_id

Valor del 3DS server transaction id

Cadena alfanumérica

String

NO

authentication_result.3ds_secure.verifika_commerce_indicator

Valor del VCI

Cadena alfanumérica

String

NO

service.installments

Objeto con información de planes y cuotas

Object

NO

service.installments.plan

Plan ID que se usará para la autorización

Cadena numérica

String

NO

service.installments.number

Cantidad de cuotas que se usará para la autorización

Cadena numérica

String

NO

Ejemplo 1 (sin Autenticación)

Request para autorizar Tarjeta sin Autenticacion.

JSON
{
    "action": "authorize",
    "channel": "ecommerce",
    "merchant_code":"b0deb6f3-e51a-48a7-9268-f1441d46f7bd",
    "merchant_operation_number": "2391645",
    "payment_method": {
        "method_name": "CARD",
        "method_details": {
            "pan": "4051420006041115",
            "expiry_date": "1231",
            "security_code": "123",
            "card_holder": {
                "first_name": "Pedro",
                "last_name": "Miranda",
                "email": "pedro@pay-me.com",
                "phone": {
                    "prefix": "51",
                    "number": "999835685"
                }
            },
            "installments": {
                "plan": "01",
                "number": "03"
            }
        }
    },
    "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": []
        }
    }
}

Ejemplo 2 (con Autenticación Redirect)

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

Para recibir la respuesta de la Autorizacion final con Autenticacion Redirect tomar en cuenta las Consideraciones para los métodos con Redirect.

JSON
{
    "action": "authorize",
    "channel": "ecommerce",
    "merchant_code":"b0deb6f3-e51a-48a7-9268-f1441d46f7bd",
    "merchant_operation_number": "2391645",
    "payment_method": {
        "method_name": "CARD",
        "method_details": {
            "pan": "4051420006041115",
            "expiry_date": "1231",
            "security_code": "123",
            "card_holder": {
                "first_name": "Pedro",
                "last_name": "Miranda",
                "email": "pedro@pay-me.com",
                "phone": {
                    "prefix": "51",
                    "number": "999835685"
                }
            },
            "redirect_url": "https://pay-me.com",
            "callback_url": "https://pay-me.com/callback",
            "installments": {
                "plan": "01",
                "number": "03"
            }
        }
    },
    "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": []
        }
    }
}

Ejemplo 3 (con Datos de Autenticación)

Request para autorizar Tarjeta con datos resultado de Autenticacion 3DS, consumido anteriormente por otro API 3DS.

JSON
{
    "action": "authorize",
    "channel": "ecommerce",
    "merchant_code":"b0deb6f3-e51a-48a7-9268-f1441d46f7bd",
    "merchant_operation_number": "2391645",
    "payment_method": {
        "method_name": "CARD",
        "method_details": {
            "pan": "4051420006041115",
            "expiry_date": "1231",
            "security_code": "123",
            "card_holder": {
                "first_name": "Pedro",
                "last_name": "Miranda",
                "email": "pedro@pay-me.com",
                "phone": {
                    "prefix": "51",
                    "number": "999835685"
                }
            },
            "authentication_result": {
                "3d_secure": {
                    "version": "2.1.0",
                    "electronic_commerce_indicator": "05",
                    "cardholder_authentication_verification_value": "AJkBB5NBeQAAAD3MYENQdAAAAAA=",
                    "ds_transaction_id": "ABC123",
                    "three_ds_server_transaction_id": "ABC123",
                    "verifika_commerce_indicator": "TSY"
                }
            },
            "installments": {
                "plan": "01",
                "number": "03"
            }
        }
    },
    "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 processor_response para pagos con tarjetas que se encuentra dentro de la trama de respuesta: API de Autorizacion.

Este campo es variable y modificable en el tiempo, tomarlo como referencial.

Field

Description

Accepted Value

Type

date

Fecha y hora en la que se realizó la autorización

Fecha y Hora

String

authorization_code

Código de autorización entregado por la procesadora.

Cadena numérica

String

result_message

Objeto con información del resultado de la autorización

 

Object

result_message.code

Código del resultado de la autorización

Cadena numérica

String

result_message.description

Descripción del resultado de la autorización

Cadena alfanumérica

String

Ejemplo 1 (sin Autenticación)

Response para autorizar Tarjeta sin Autenticacion.

JSON
{
    "success": "true",
    "action": "authorize",
    "merchant_code":"b0deb6f3-e51a-48a7-9268-f1441d46f7bd",
    "merchant_operation_number": "2391645",
    "transaction": {
        "transaction_id": "5hk8rwa3h3cq9oyfs3a28v1ms",
        "state": "AUTORIZADO",
        "amount": "15000",
        "currency": "604",
        "expiration": null,
        "processor_response": {
            "date": "17-01-2024 12:27:46",
            "authorization_code": "055552",
            "result_message": {
                "code": "00",
                "description": "Approval and completed successfully"
            }
        }
    },
    "meta": {
        "status": {
            "code": "00",
            "message_ilgn": [
                {
                    "locale": "es_PE",
                    "value": "Procesado correctamente"
                }
            ]
        }
    }
}

Ejemplo 2 (con Autenticación Redirect)

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

Para recibir la respuesta de la Autorizacion final con Autenticacion Redirect tomar en cuenta las Consideraciones para los métodos con Redirect.

JSON
{
    "success": "true",
    "action": "authorize",
    "merchant_code":"b0deb6f3-e51a-48a7-9268-f1441d46f7bd",
    "merchant_operation_number": "2391645",
    "transaction": {
        "transaction_id": "5hk8rwa3h3cq9oyfs3a28v1ms",
        "state": "PENDIENTE",
        "redirect_url": "http://paymentapi.alignet.io/payment/redirect/cuotealo/2be5s7xu4i6fzrmbvp167inb2",
        "amount": "15000",
        "currency": "604",
        "expiration": {
            "date": {
                "day": "2024-01-14",
                "time": "22:32:47",
                "timezone": "America/Lima"
                },
            "unix_time": 1705548767
        },
        "processor_response": {
            "date": "17-01-2024 12:27:46",
            "authorization_code": "055552",
            "result_message": {
                "code": "00",
                "description": "Approval and completed successfully"
            }
        }
    },
    "meta": {
        "status": {
            "code": "00",
            "message_ilgn": [
                {
                    "locale": "es_PE",
                    "value": "Procesado correctamente"
                }
            ]
        }
    }
}

Ejemplo 3 (con Datos de Autenticación)

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

JSON
{
    "success": "true",
    "action": "authorize",
    "merchant_code":"b0deb6f3-e51a-48a7-9268-f1441d46f7bd",
    "merchant_operation_number": "2391645",
    "transaction": {
        "transaction_id": "5hk8rwa3h3cq9oyfs3a28v1ms",
        "state": "AUTORIZADO",
        "amount": "15000",
        "currency": "604",
        "expiration": null,
        "processor_response": {
            "date": "17-01-2024 12:27:46",
            "authorization_code": "055552",
            "result_message": {
                "code": "00",
                "description": "Approval and completed successfully"
            }
        }
    },
    "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.