Autorización Transaccional

Este endpoint permite generar una autorización transaccional sin especificar un payment_id, creando una nueva transacción.

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

Un id opcional que permite al cliente identificar la transacción en sus sistemas internos.

string
length ≤ 255

ID de trazabilidad para seguimiento de la transacción.

amount
object
required

Incluye el valor, la moneda y propina opcional 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.

capture
object

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

terminal
object

Información del terminal.

string
enum

Modo de entrada de la transacción. Determina si use_case es requerido.

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), points_redeem (canje de puntos).

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:
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.

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