Skip to main content
Skip table of contents

API de Autorizacion

El API de Autorización permite generar una transacción dependiendo el método de pago que escoga.

REQUEST

Path

Method: POST

URL: {{base}}/charges

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

Body

Se detalla el request que se usará para todos los métodos de pagos:

Field

Description

Accepted Value

Type

Obligatorio

action

Acción a ejecutar

  • authorize

String

SI

channel

Canal donde se ejecutara la transacción

  • ecommerce

String

SI

merchant_code

Identificador del comercio

Cadena Alfanumérica

String

SI

merchant_operation_number

Número de pedido de la operación

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

String

SI

payment_method

Objeto relacionado al método de pago que se usará para la autorización. Este objeto varia por método de pago

 

Object

SI

payment_method.method_name

Nombre del método de pago que se usará para la autorización.

  • CARD

  • BANK_TRANSFER

  • CUOTEALO

  • QR

  • YAPE

String

SI

payment_method.method_details

Objeto que contiene información necesaria para procesar la autorización. Este objeto es necesario y cambia según el método de pago:

 

Object

NO*

payment_details

Objeto con información de la transacción

 

Object

SI

payment_details.amount

Monto en centavos de la operación. La separación de decimales se aplicará según la moneda.

Ej.: Para S/. 10.50, se debe enviar “1050” y en currency “604” para Soles. (Falta el link al ISO)

Cadena numérica

String

SI

payment_details.currency

Código ISO-3 de la moneda de la operación(Falta el link al ISO)

Cadena numérica

String

SI

payment_details.additional_fields

Diccionario para enviar campos y valores personalizados.

Ej.: key:value

Dictionary

NO

payment_details.customer

Objeto con información del cliente que realiza la compra

 

 

NO

payment_details.customer.first_name

Nombres

Cadena alfanumérica

String

NO

payment_details.customer.last_name

Apellidos

Cadena alfanumérica

String

NO

payment_details.customer.email

Correo electrónico

Cadena alfanumérica

String

NO

payment_details.customer.phone

Objeto con información del teléfono

 

Object

NO 

payment_details.customer.phone.country_code

Código del pais del teléfono

Cadena numérica

String

NO 

payment_details.customer.phone.subscriber

Número del teléfono

Cadena numérica

String

NO 

payment_details.customer.location

Objeto con información de la persona

 

Object

NO 

payment_details.customer.location.line_1

Dirección 1

Cadena alfanumérica

String

NO 

payment_details.customer.location.line_2

Dirección 2

Cadena alfanumérica

String

NO 

payment_details.customer.location.city

Ciudad

Cadena alfanumérica

String

NO 

payment_details.customer.location.state

Estado

Cadena alfanumérica

String

NO 

payment_details.customer.location.country

Pais

Cadena alfanumérica

String

NO 

payment_details.billing

Objeto con información de facturación

 

Object

SI 

payment_details.billing.first_name

Nombres

Cadena alfanumérica

String

SI

payment_details.billing.last_name

Apellidos

Cadena alfanumérica

String

SI 

payment_details.billing.email

Correo electrónico

Cadena alfanumérica

String

SI 

payment_details.billing.phone

Objeto con información del teléfono

 

Object

SI 

payment_details.billing.phone.country_code

Código del pais del teléfono

Cadena numérica

String

SI 

payment_details.billing.phone.subscriber

Numero del teléfono

Cadena numérica

String

SI 

payment_details.billing.location

Objeto con información de la persona

 

Object

SI 

payment_details.billing.location.line_1

Dirección 1

Cadena alfanumérica

String

SI 

payment_details.billing.location.line_2

Dirección 2

Cadena alfanumérica

String

NO 

payment_details.billing.location.city

Ciudad

Cadena alfanumérica

String

SI 

payment_details.billing.location.state

Estado

Cadena alfanumérica

String

SI 

payment_details.billing.location.country

Pais

Cadena alfanumérica

String

SI 

payment_details.shipping

Objeto con información de envío

Object

NO 

payment_details.shipping.first_name

Nombres

Cadena alfanumérica

String

NO 

payment_details.shipping.last_name

Apellidos

Cadena alfanumérica

String

NO 

payment_details.shipping.email

Correo electrónico

Cadena alfanumérica

String

NO 

payment_details.shipping.phone

Objeto con información del teléfono

 

Object

NO 

payment_details.shipping.phone.country_code

Código del pais del teléfono

Cadena numérica

String

NO 

payment_details.shipping.phone.subscriber

Numero del teléfono

Cadena numérica

String

NO 

payment_details.shipping.location

Objeto con información de la persona

 

Object

NO 

payment_details.shipping.location.line_1

Dirección 1

Cadena alfanumérica

String

NO 

payment_details.shipping.location.line_2

Dirección 2

Cadena alfanumérica

String

NO 

payment_details.shipping.location.city

Ciudad

Cadena alfanumérica

String

NO 

payment_details.shipping.location.state

Estado

Cadena alfanumérica

String

NO 

payment_details.shipping.location.country

Pais

Cadena alfanumérica

String

NO 

RESPONSE

Field

Description

Accepted Value

Type

Obligatorio

success

Indica si el proceso se realizó correctamente

Cadena alfanumérica

String

SI

action

Acción ejecutada. Los valores que puede tomar son:

  • authorize

Cadena alfanumérica

String

SI

merchant_code

Identificador del comercio

Cadena Alfanumérica

String

SI

merchant_operation_number

Número de pedido de la operación

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

String

SI

transaction

Objeto con información de la transacción

Object

SI

transaction.transaction_id

Monto de la operación

Cadena numérica

String

SI

transaction.state

Estado de la transacción

  • PENDIENTE

  • AUTORIZADO

  • DENEGADO

  • INVALIDO

String

SI

transaction.redirect_url

URL que debe mostrarse al usuario/cliente para continuar el proceso de compra, devuelto para los siguientes métodos de pagos:

  • CARD (con Autenticacion 3DS)

  • BANK_TRANSFER

  • CUOTEALO

  • POWERPAY

  • PAGO_EFECTIVO

Para ciertos métodos la respuesta final se dará en Consideraciones para los métodos con Redirect.

Cadena alfanumérica

String

NO*

transaction.currency

Código de la moneda de la transacción que fue autorizado

Cadena numérica

String

SI

transaction.amount

Monto de la transacción que fue autorizado. El monto debe estar en centavos.

Cadena numérica

Object

SI

transaction.expiration

Objeto con información de la expiración de la transacción. Este objeto solo esta disponible para los siguientes métodos de pagos:

  • CARD (Cuando es por Redirect)

  • BANK_TRANSFER

  • PAGO_EFECTIVO

  • POWERPAY

  • QR

  • CUOTEALO

Para el resto de casos se devolvera null

Object

SI*

transaction.expiration.date

Objeto con información de cuando expirará la transacción.

Object

NO*

transaction.expiration.date.day

Fecha de Expiracion de la transaccion en formato “AAAA-MM-DD”

Ejm. “2024-01-18”

Cadena alfanumérica

String

NO*

transaction.expiration.date.time

Hora de Expiración de la transaccion en formato 24H: “HH:MM:SS”.

Ejm. “22:10:25”

Cadena alfanumérica

String

NO*

transaction.expiration.date.timezone

Zona horaria de la fecha de expiración

Cadena alfanumérica

 

NO*

transaction.expiration.unix_time

Fecha y hora, en formato unixTime (UTC), en la que se expirará la transacción.

Numerico

 Numeric

NO*

transaction.processor_response

Objeto que contiene resultado detallado del procesamiento. Este objeto puede cambiar según el método de pago.

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

 Object

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

JavaScript errors detected

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

If this problem persists, please contact our support.