Preguntas Frecuentes
¿Cómo Usar JWTs?
Como parte del flujo, una vez que un usuario realiza una solicitud, es decir, una solicitud de retiro/deposito interactivo, será procesada por la Anchor Platform y enviada a tu servicio. La Anchor Platform hará una llamada GET
a <configured url>?token=<jwt token>
.
Este token JWT contendrá:
exp
es el tiempo de expiración del token. Deberías verificar que el token proporcionado no haya expirado.sub
es la cuenta asociada con esta transacción. Puede ser utilizado para identificar la cuenta del usuario. Ten en cuenta que este valor puede ser diferente de la cuenta que se utilizará para recibir/enviar fondos.jti
es el hash de la transacción.data
es la carga adicional que ha sido establecida por el usuario. Siempre incluirá elasset
de Stellar que se desea depositar o retirar. Si es proporcionado por el cliente, también contendrá elamount
que el usuario desea transaccionar, elclient_domain
de la billetera verificada durante la autenticación SEP-10, yclient_name
(definido como 'name' en la configuración [clients] si está provisto), y la preferencia delang
(idioma) del usuario.
¿Cómo Proporcionar Tarifas?
Actualmente, se recomienda proporcionar tarifas/tasas de cambio en el iFrame/vista web de tu aplicación.
El estándar SEP-24 proporciona un endpoint /fee
para permitir a las empresas establecer tarifas estáticas para sus transacciones. Sin embargo, actualmente no es soportado por la Anchor Platform.
El endpoint /fee será desaprobado en el futuro.
¿Cómo identificar la cuenta del usuario?
Deberías usar el campo sub
del token JWT. Para billeteras de custodia, este valor estará en el formato cuenta:memo
. Usa el memo para identificar al usuario. Para billeteras no custodiales, simplemente usa el valor sub
en sí mismo, que será igual a la cuenta del usuario.
¿Cómo identificar la billetera?
Utiliza los atributos data.client_domain
dentro del token JWT. En presencia de la configuración [clients], el token JWT incluirá adicionalmente el campo data.client_name
, lo que permitirá la identificación de la billetera.