Autorizacion - CICO Emisores
POST
/authorizeAutorizar operaciones CICO
Objetivo
Este endpoint permite autorizar o rechazar operaciones de Cash-In/Cash-Out. El emisor recibe la solicitud de autorizacion y debe validar que el usuario tiene fondos suficientes (para cash-out) o que puede recibir el deposito (para cash-in).
Request
Headers
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
x-api-key | String | Sí | Clave de API proporcionada por Tapi para autenticar la solicitud. |
x-authorization-token | String | Sí | Token de autenticacion obtenido en el login. |
Body Parameters
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
referenceCode | String | Sí | Codigo de referencia de la operacion. |
action | String | Sí | Accion a realizar: 'approve' o 'reject'. |
reason | String | No | Razon del rechazo (requerido si action es 'reject'). |
Response
Response Body
| Parámetro | Tipo | Descripción |
|---|---|---|
authorizationCode | String | Codigo de autorizacion (solo si fue aprobada). |
status | String | Estado de la autorizacion: 'approved' o 'rejected'. |
Consideraciones
- El codigo de autorizacion es necesario para completar la operacion en el punto de servicio.
- Las autorizaciones aprobadas tienen una validez de 15 minutos.
CLIENT LIBRARIES
REQUEST EXAMPLE
curl --request POST \
--url https://cash-in.homo.tapila.cloud/authorize \
--header 'x-authorization-token: YOUR_TOKEN_HERE' \
--header 'x-api-key: YOUR_API_KEY_HERE' \
--header 'Content-Type: application/json' \
--data '{
"referenceCode": "CICO-2024-ABC123XYZ",
"action": "approve"
}'