Preguntas frecuentes

Las dudas que aparecen durante una integración real con la API de partners de SLAN.

¿Qué hago si mi wallet se queda en PENDING?

Nada: un proceso nuestro la resuelve cada 15 minutos. Si después de una hora sigue en PENDING, escríbenos.

No intentes crear otra. Reintentar el POST es seguro y devuelve la misma wallet, pero no acelera nada.

¿Puedo reutilizar la misma Idempotency-Key?

Con el mismo cuerpo, sí: te devolvemos la respuesta original. Con un cuerpo distinto, no — eso da 422. La clave identifica una intención, no una petición.

¿Qué pasa si el correo ya existe en SLAN?

Recibes 409 PARTNER_END_USER_EMAIL_TAKEN y no se crea nada. No vinculamos al usuario existente: hacerlo te daría acceso a un cliente de SLAN con su expediente, sus tarjetas y su saldo.

Si ese caso te aparece a menudo, hablémoslo.

¿Cómo roto mi llave antes de que expire?

Con POST /v1/partner/api-keys/rotate, usando tu llave actual. Recibes una nueva con los mismos scopes y otros 365 días.

La anterior se revoca en el acto, así que actualiza tu integración con el secreto nuevo antes de hacer cualquier otra llamada.

¿Pueden salir identificadores internos en la API?

Nunca. Todo sale como publicId, un ULID de 26 caracteres. Los enteros internos son un detalle de implementación.

¿Por qué shareUrl viene en null?

Estás en el ambiente de pruebas, donde no hay checkout alojado configurado. En producción recibes una URL que puedes compartir por WhatsApp, por correo o convertir en un código QR.

Lee Ambientes para el resto de diferencias.

¿Se puede pagar desde la aplicación de SLAN?

Sí. Un usuario de SLAN puede abrir el shareUrl en la aplicación y pagar desde su saldo, como transferencia interna. En la trazabilidad esos pagos aparecen con payerType: "SLAN_USER".

¿Por qué recibo 404 en un recurso que existe?

Porque no es tuyo. Un publicId que pertenece a otro partner responde 404, nunca 403: un 403 confirmaría que ese identificador existe.

Si crees que el recurso sí es tuyo, comprueba que no estás mezclando credenciales de dos ambientes.

¿Qué hago si recibo un 500?

Reintenta después de unos segundos. Si era un POST, con la misma Idempotency-Key.

Si el error persiste, mándanos el requestId que viene en la respuesta: nos lleva directamente a la petición que falló.