Generacion de Referencias - CICO Emisores
POST
/referencesGenerar referencias unicas para operaciones CICO
Objetivo
Este endpoint permite generar referencias unicas que identifican cada operacion de Cash-In o Cash-Out. Las referencias son necesarias para vincular depositos o retiros con las cuentas de los usuarios.
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 |
|---|---|---|---|
operationType | String | Sí | Tipo de operacion: 'cash_in' o 'cash_out'. |
amount | Number | Sí | Monto de la operacion. |
currency | String | Sí | Codigo de moneda (ARS, MXN, COP, etc.). |
userId | String | Sí | Identificador unico del usuario. |
Response
Response Body
| Parámetro | Tipo | Descripción |
|---|---|---|
referenceCode | String | Codigo de referencia unico generado. |
expiresAt | String | Fecha y hora de expiracion de la referencia. |
tx | String | Identificador de la transaccion. |
Consideraciones
- Las referencias tienen una validez de 24 horas por defecto.
- El codigo de referencia debe ser presentado en el punto de servicio para completar la operacion.
CLIENT LIBRARIES
REQUEST EXAMPLE
curl --request POST \
--url https://cash-in.homo.tapila.cloud/references \
--header 'x-authorization-token: YOUR_TOKEN_HERE' \
--header 'x-api-key: YOUR_API_KEY_HERE' \
--header 'Content-Type: application/json' \
--data '{
"operationType": "cash_in",
"amount": 10000,
"currency": "ARS",
"userId": "user-123456"
}'