Autorizar

Este endpoint permite generar una autorización incluyendo los datos completos del instrumento en el request.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string

Un id opcional que permite al cliente identificar el pago en sus sistemas internos.

amount
object
required

Incluye el valor y la moneda en la que se realiza la transacción.

string
enum
required

Indica si se debe realizar una autorización, una reserva o estado de cuenta.

Allowed:
string
required

Id del comercio.

instrument
object
required

Debe incluir la información completa del instrumento, como ser, los datos de la tarjeta.

customer_data
object

Datos del Cliente

string
enum

Indica el modo en que se ingresaron los datos del instrumento.

Allowed:
string
enum

Tipo de orden que determina el flujo CIT/MIT. La primera transacción siempre es una CIT (iniciada por el cliente), y los cobros posteriores son MIT (iniciados por el comercio) vinculados a esa CIT original mediante parent_transaction_data.

Valores CIT y MIT: recurring (suscripción — CIT: alta inicial, MIT: cobros periódicos), installment (cuotas — CIT: primera cuota, MIT: cuotas siguientes), standing_order (débito automático — CIT: autorización inicial, MIT: cobros por monto variable), unscheduled (cobro no programado — CIT: guardado de credencial, MIT: cobros futuros), deferred (autorización diferida — CIT: autorización, MIT: cobro posterior).

Solo CIT: purchase (compra puntual sin credencial guardada).

Solo MIT: delayed (cargo posterior, ej: minibar hotel), no_show (cargo por no presentación), resubmission (reenvío de transacción rechazada).

string
enum

Indica quién inició la transacción. customer para transacciones donde el tarjetahabiente está presente y autoriza el pago (CIT). merchant para cobros posteriores iniciados por el comercio sin presencia del tarjetahabiente (MIT). Las transacciones MIT requieren parent_transaction_data para vincular con la autorización original.

Allowed:
capture
object

Debe incluir el modo de captura deseado, manual o automático.

installments
object

Objeto que indica información sobre las cuotas.

three_ds
object

Datos de autenticación 3DS.

string

Electronic Commerce Indicator. Este campo es obligatorio si se envía el objeto three_ds.

transaction_compliance
array of objects

Impuestos opcionales asociados a la transacción

transaction_compliance
parent_transaction_data
object

Datos de vinculación con la transacción original (CIT). Requerido para transacciones MIT (initiator: merchant). La respuesta de una CIT aprobada devuelve parent_transaction_data con los identificadores de red ya resueltos — copiarlos tal cual en las MIT posteriores.

recurring
object

Metadatos de recurrencia para transacciones recurrentes o en cuotas.

recurrence
object

Datos adicionales de recurrencia para Mastercard. Usado para el campo MemberDefinedData de recurrence.

string
length ≤ 22

Descriptor del comercio que aparece en el resumen del tarjetahabiente. Máximo 22 caracteres.

Headers
string

Clave de idempotencia, la plataforma de Akua evitará que dos requests con la misma clave sean ejecutadas.

Responses

Language
Credentials
OAuth2
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
logo akua

© Akua 2025 - Todos los derechos reservados