Country:
/v1/pos/authorizations
Autorizar con tarjeta (genérico)
Este endpoint permite generar una autorización con tarjeta presente usando un formato genérico sin especificar proveedor.
id
Un id que permite al cliente identificar el pago en sus sistemas internos.
entry_mode
Indica el modo en que se ingresaron los datos del instrumento.
terminal_id
Id de la terminal
pre_authorization
Indica si es una pre-autorización
capture
Configuración de captura
mode
Modo de captura
amount
Incluye el valor y la moneda en la que se realiza la transacción.
value
Monto por el cual se quiere capturar
currency
Moneda en la cual se quiere capturar en formato iso4217
tip_amount
Monto de propina
value
Monto correspondiente a la propina
currency
Moneda en formato iso4217
installments
Información de cuotas
plan
quantity
instrument
Contiene la información requerida del instrumento de pago
track2_data
Contiene la información relacionada con el track2 de la tarjeta, utilizada principalmente en transacciones con tarjetas de banda magnética o chip.
ksn
Número de serie asociado a la clave criptográfica utilizada para cifrar los datos del Track 2. Requerido si data está encriptado.
data
Datos del track2 de la tarjeta. Incluye el número de la tarjeta (PAN) junto con otros datos relacionados
encrypted
Indica si la data está encriptada o no
pin_block
Contiene la información del bloque de PIN cifrado, usado en transacciones donde el cliente ingresa el PIN en el dispositivo.
ksn
Número de serie asociado a la clave utilizada para cifrar el PIN
data
Bloque de PIN cifrado. Contiene el PIN del usuario protegido mediante criptografía.
emv_data
Contiene la información derivada del chip EMV de la tarjeta, utilizada en transacciones con tarjetas con chip inteligente.
sequence_number
Número de secuencia de aplicación (Application Transaction Counter - ATC). Es un contador incremental que lleva el chip para el seguimiento de transacciones
tags
Lista de objetos que representan los campos EMV (Tags), los cuales contienen información adicional específica de la transacción.
tag
Código hexadecimal que identifica el campo EMV
length
Longitud del valor asociado al tag
value
Valor asociado al tag, en formato hexadecimal.
metadata
Lista opcional en formato clave-valor con metadata que se necesite informar
key
clave del dato
value
valor del dato
Response Examples
201
201
{
"payment": {
"capture": {
"mode": "example_string"
},
"country": "example_string",
"currency": "example_string",
"current_amount": 123,
"external_client_trace_id": "example_string",
"id": "example_string",
"merchant": {
"id": "example_string",
"terminal_id": "example_string"
},
"transaction": {
"amount": 123,
"authorization_code": "example_string",
"id": "example_string",
"status": "example_string",
"status_detail": "example_string",
"system_trace_audit_number": "example_string",
"transmission_date_time": "example_string",
"type": "example_string"
},
"taxes": [
{
"id": "example_string",
"type": "example_string",
"amount": 123,
"currency": "example_string"
}
]
}
}400
400
{
"error_type": "example_string",
"message": "example_string",
"details": [
"example_string"
]
}Language
Login required to test API
Code Examples
cURL
curl -X POST "https://api.akua.la/v1/pos/authorizations" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"capture": {},
"amount": {},
"tip_amount": {},
"installments": {},
"instrument": {},
"metadata": []
}''