Solicitudes de pago con la billetera móvil Algorand

Las nuevas versiones de Algorand Mobile Wallet mejora la capacidad de usar códigos QR para crear y enviar transacciones básicas. Este documento proporciona una breve descripción general de cómo los desarrolladores y los usuarios pueden aprovechar esta funcionalidad mejorada.

Para desarrolladores

Los desarrolladores de los ecosistemas de Algorand pueden encontrarse ante una situación en la que deseen solicitar a los usuarios que creen y envíen intercambios específicos. Por ejemplo, una cafetería que acepta Algo y USDC como pago necesitará que los clientes creen transacciones con una cantidad específica, la identificación del activo que se transfiere y tal vez un valor determinado en el campo de la nota.

Esto es posible mediante el uso de Algorand URI. Las siguientes secciones explican cómo construir códigos QR y URI de ésta, que sean compatibles con “Algorand Mobile Wallet”.

Esquema de URI

Para solicitar a los usuarios que creen transacciones, que envíen Algos o ASA, primero debe construir un URI que se ajuste al esquema de Algorand. Cuando un usuario abre una URI y tiene la Cartera móvil instalada, la aplicación se abrirá y podrá manejarla correctamente.

Algo y URI deben comenzar con algorand://, seguido de la dirección del receptor y luego los parámetros para la transacción. Por ejemplo:

algorand://WSJHNPJ6YCLX5K4GUMQ4ISPK3ABMS3AL3F6CSVQTCUI5F4I65PWEMCWT3M?amount=5000000&asset=31566704&xnote=Order%20250

Este URI es un mensaje para transferir 5 USDC a la dirección WSJHNPJ6YCLX5K4GUMQ4ISPK3ABMS3AL3F6CSVQTCUI5F4I65PWEMCWT3M con una nota de «Pedido 250».

A continuación se muestran breves descripciones de algunos de los parámetros. También está disponible una descripción completa del esquema Algorand URI y sus parámetros.

• Activo : este parámetro determina si la transacción enviará Algos o un ASA. Si desea enviar un ASA, establezca este parámetro en el ID de ,este. De lo contrario, si este parámetro no está presente, la transacción enviará Algos.

• Cantidad : esta es el volumen de ALGO o ASA a enviar en la transacción. Tenga en cuenta que esta cantidad está en la unidad más pequeña del activo.
  
  • Para Algos, la unidad más pequeña es el microAlgo. 1,000,000 microAlgos = 1 Algo.
    
  • Para los ASA, la unidad más pequeña depende del número de decimales que éste está configurado para tener. Si uno de éstos tiene decimales, entonces una cantidad de 10 ^  unidades básicas equivale a 1 unidad del activo.

• Note y Xnote : estos parámetros se pueden utilizar para especificar qué debe contener el campo de nota de la transacción. El valor de este parámetro debe estar codificado en porcentaje si contiene caracteres especiales. Si se utiliza «nota», este tendrá la opción de editar el campo de ésta antes de enviar la transacción. Si se utiliza «xnote», no se podrá editar el campo de la misma. Si su aplicación tiene requisitos estrictos para el campo de nota, es mejor usar «xnote». No debe especificar tanto «nota» como «xnote».

Creación de código QR

Además de solicitar transacciones con URI, también puede convertir éstos en códigos QR que los usuarios pueden escanear para crear transacciones.

Para hacer esto, primero cree un URI para sus transacciones, codifíquelo como un código QR usando cualquier biblioteca o herramienta de conversión QR estándar.

Una vez que haya generado el código QR, ¡estará listo para mostrárselo a los usuarios!

Para los usuarios

Pueden utilizar la función de escaneo QR de Algorand Wallet para firmar ordenes específicas de la aplicación. Algorand URI y códigos QR para crear transacciones de pago. Esta sección explica cómo se puede utilizar Algorand Mobile Wallet para crear transacciones como esta, previsualizar y firmar escaneando un código QR que se les presenta.

Escaneo de códigos QR

Para escanear un código QR, presione el botón QR en la esquina superior derecha de la pantalla de inicio.

Esto abrirá una pantalla que usa la cámara de su dispositivo para escanear un código QR. Una vez que se ha escaneado el código, puede seguir los mismos pasos que en la sección siguiente para abrir URI de Algorand.

Apertura de URI de Algorand

Para crear una transacción a partir de un Algorand URI, simplemente presione el mismo. Esto abrirá Algorand Mobile Wallet, tal como en la siguiente pantalla:

Desde esta pantalla, puede elegir qué cuenta será el remitente de la transacción. Después de elegir el remitente, verá una creación de transacciones con todos los valores de URI completados:

Si todo aparece aceptable, presione el botón de vista previa para continuar con la pantalla de confirmación de la transacción:

Esta es su última oportunidad para revisar la transacción antes de enviarla a la red. Si está satisfecho con él, presione enviar.

Ahora ha creado con éxito una transacción a partir de un código QR o Algorand URI.

¿Qué sigue?

Si bien estamos emocionados de lanzar esta funcionalidad para codificar transacciones básicas de Algorand, también estamos trabajando arduamente para admitir transacciones más complejas y llamadas de aplicaciones. Esperamos que pueda utilizar Algorand Wallet para firmar una multitud de transacciones desde cualquier diferentes tipos de aplicaciones.

Por último, esta es una característica que ha sido solicitada muchas veces por los desarrolladores y miembros de la comunidad de Algorand, ¡y sigan enviando comentarios! Si tiene comentarios o necesita ayuda para integrar Algorand Wallet con los flujos de trabajo de su aplicación, comuníquese con nosotros en Discord en el canal #algorand-wallet.

Este artículo ha sido escrito originalmente por Jason Paulos en «Artículos» del portal para desarrolladores de Algorand  y traducido por AlgoLatam.

Original Article: https://developer.algorand.org/articles/payment-prompts-with-algorand-mobile-wallet/