Preguntas frecuentes
¿Cómo usar JWTs?
Como parte del flujo, una vez que un usuario hace una solicitud, es decir, una solicitud de retirada de fondos/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>
. La Anchor Platform hará una llamada GET
a <configured url>?token=<jwt token>
.
Este token JWT contendrá:
- Debes verificar que el token proporcionado no haya caducado.
sub
es la cuenta asociada con esta transacción. - Puede usarse 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 contendrá el
asset
de Stellar que desea depositar o retirar. Siempre contendrá elasset
de Stellar que desea depositar o retirar. Si lo proporciona el cliente, también contendrá elamount
que el usuario desea transaccionar, elclient_domain
de la billetera verificado durante la autenticación SEP-10, yclient_name
(definido como 'name' en la configuración de [clients] si se proporciona), y la preferencia delang
(idioma) del usuario. Si lo proporciona el cliente, también contendrá elamount
que el usuario quiere transaccionar, elclient_domain
de la billetera verificado durante la autenticación SEP-10, y elclient_name
(definido como 'nombre' en la configuración de [clients] si se proporciona), 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 que las empresas establezcan tarifas estáticas para sus transacciones. Sin embargo, actualmente no es admitido por la Anchor Platform.
/fee endpoint se deprecará en el futuro.
¿Cómo identificar la cuenta del usuario?
Debes usar el campo sub
del token JWT. Para billeteras custodiales, este valor estará en el formato account:memo
. Usa el memo para identificar al usuario. Para billeteras no custodiales, simplemente usa el valor sub
en sí, 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 de [clients], el token JWT incorporará además el campo data.client_name
, permitiendo la identificación de la billetera.