Country:
/v1/authorizations
Autorizar
Este endpoint permite generar una autorización incluyendo los datos completos del instrumento en el request.
id
Un id opcional que permite al cliente identificar el pago en sus sistemas internos.
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.
intent
Indica si se debe realizar una autorización o una reserva.
merchant_id
Id del comercio.
instrument
Debe incluir la información completa del instrumento, como ser, los datos de la tarjeta.
customer_data
Datos del Cliente
billing_address
Direccion de facturación
street
Calle.
number
Número.
city
Ciudad.
state
Estado.
zip_code
Código postal.
country
País.
delivery_address
Direccion de facturación
street
Calle.
number
Número.
city
Ciudad.
state
Estado.
zip_code
Código postal.
country
País.
Correo electrónico del cliente.
phone_number
Número de teléfono del cliente.
ip_address
Dirección IP del cliente.
latitude
Latitud de la ubicación del cliente.
longitude
Longitud de la ubicación del cliente.
entry_mode
Indica el modo en que se ingresaron los datos del instrumento.
order_type
Indica si se trata de un pago individual o recurrente.
initiator
Indica quien inició la transacción.
capture
Debe incluir el modo de captura deseado, manual o automático.
mode
Modo de captura.
capture_after
Tiempo después del cual se debe capturar automáticamente.
installments
Objeto que indica información sobre las cuotas.
quantity
Número de cuotas.
type
Tipo de plan de cuotas.
three_ds
Datos de autenticación 3DS.
cavv
Cardholder Authentication Verification Value.
version
Versión de 3DS.
ds_transaction_id
ID de la transacción 3DS.
eci
Electronic Commerce Indicator. Este campo es obligatorio si se envía el objeto three_ds.
taxes
Impuestos opcionales asociados a la transacción
type
Tipo de impuesto
amount
Monto del impuesto
currency
Moneda en formato iso4217
value
Valor del monto
percentage
Porcentaje del impuesto
base_amount
Monto base para el cálculo del impuesto
currency
Moneda en formato iso4217
value
Valor del monto base
laws
Leyes aplicables al impuesto
Response Examples
201
201
{
"payment_id": "example_string",
"instrument_id": "example_string",
"response_code": "example_string",
"response_code_description": "example_string",
"transaction": {
"id": "example_string",
"network_data": {
"approval_code": "example_string",
"banknet_reference_number": "example_string",
"financial_network_code": "example_string",
"response_code": "example_string",
"response_code_description": "example_string",
"settlement_date": "example_string",
"system_trace_audit_number": "example_string",
"transmission_date_time": "example_string",
"merchant_advice_code": "example_string",
"merchant_advice_description": "example_string",
"merchant_advice_action": "RETRY"
},
"risk_id": "example_string",
"status": "IN_PROGRESS",
"status_detail": "SUCCESS",
"type": "example_string"
}
}400
400
{
"error_code": "example_string",
"error_type": "example_string",
"message": "example_string",
"response_code": "example_string",
"response_code_description": "example_string",
"details": [
"example_string"
]
}409
409
{
"error_code": "example_string",
"error_type": "example_string",
"message": "example_string",
"response_code": "example_string",
"response_code_description": "example_string"
}500
500
{
"error_code": "example_string",
"message": "example_string",
"error_type": "example_string",
"response_code": "example_string",
"response_code_description": "example_string"
}Language
Login required to test API
Code Examples
cURL
curl -X POST "https://api.akua.la/v1/authorizations" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"amount": {},
"instrument": {},
"customer_data": {},
"capture": {},
"installments": {},
"three_ds": {},
"taxes": []
}''