Saltar al contenido principal

Buenas Practicas

Renovar el token antes de que expire​

Solicita un nuevo token unos minutos antes de que el actual venza. El token dura 60 minutos por defecto.

Usar idempotency_key en transacciones​

Evita cobros duplicados por reintentos de red. Si envias el mismo idempotency_key dos veces, la segunda llamada retornara el resultado de la primera sin crear una transaccion duplicada.

Consultar saldo antes de canjear​

Verifica que el cliente tenga suficientes puntos antes de intentar un canje.

Manejar errores 401​

Si recibes un 401, solicita un nuevo token y reintenta la operacion.

Ejemplo de Flujo Completo​

# 1. Obtener token
curl -X POST https://fidely20backend.azurewebsites.net/integrations/auth/token \
  -H "Content-Type: application/json" \
  -d '{"client_id": "tu-client-id", "client_secret": "tu-client-secret"}'

# 2. Consultar cliente
curl -X GET https://fidely20backend.azurewebsites.net/integrations/stores/24/clients/12345678 \
  -H "Authorization: Bearer {access_token}"

# 3. Registrar compra
curl -X POST https://fidely20backend.azurewebsites.net/integrations/stores/24/transactions \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: application/json" \
  -d '{"identification": "12345678", "amount": 5000, "ticket_id": "FAC-001"}'

# 4. Canjear puntos (si el cliente lo solicita)
curl -X POST https://fidely20backend.azurewebsites.net/integrations/stores/24/swap \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: application/json" \
  -d '{"identification": "12345678", "amount": 50}'