summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJavier Sepulveda <javier.sepulveda@uv.es>2024-01-25 12:47:01 +0100
committerJavier Sepulveda <javier.sepulveda@uv.es>2024-01-25 12:47:01 +0100
commit867aaa111d1542e0381c4347db5aba303127835a (patch)
tree019c2e6971674e0004afcf9665d73bf0e8614771
parent8263aa0d519b09881bf26d7544d61ccf47c2edae (diff)
downloadtutorial-videos-867aaa111d1542e0381c4347db5aba303127835a.tar.gz
tutorial-videos-867aaa111d1542e0381c4347db5aba303127835a.tar.bz2
tutorial-videos-867aaa111d1542e0381c4347db5aba303127835a.zip
Translation of ES-Creating-orders-and-getting-paid into Spanish
-rw-r--r--translations/ES-Creating-orders-and-getting-paid.txt175
1 files changed, 175 insertions, 0 deletions
diff --git a/translations/ES-Creating-orders-and-getting-paid.txt b/translations/ES-Creating-orders-and-getting-paid.txt
new file mode 100644
index 0000000..139a04f
--- /dev/null
+++ b/translations/ES-Creating-orders-and-getting-paid.txt
@@ -0,0 +1,175 @@
+Hola y bienvenidos a este tutorial.
+
+En este tutorial vamos a ver como tú como vendedor (merchant), puedes
+crear una orden de pedido, y que esta sea pagada por uno de tus
+clientes.
+
+Si no estas familiarizado con realizar llamadas a la API, y la
+configuración necesaria para realizar llamadas a los servicios de la
+API de vendedor, te recomendamos enormemente que veas el tutorial de
+introducción que será enlazado en el código QR de recursos de este
+video.
+
+Cuando estés familiarizado con la configuración necesaria, ten en
+cuenta que para crear pedidos y comprobar el estado de estos pedidos
+"orders", nosotros vamos a realizar peticiones autentificadas contra
+la API, así que olvides incluir tu token secreto en el encabezado de
+la petición.
+
+Así vamos a crear un pedido minimalista para que tengas una idea de
+como hacerlo. Vamos a enviar una petición "POST" al endpoint de la API
+del vendedor (merchant), puedes usar o bien el backend del servidor de
+demostración de Taler (demo.taler.net), o tu propio servidor si tienes
+uno configurado. Así que indica en la ultima /, /private/orders, pero
+para poder crear un pedido, necesitamos crearle un cuerpo "body", el
+cuerpo de la petición va a ser creado usando el formato JSON.
+
+Para crear un pedido, simplemente añade un objeto del tipo pedido
+"order", en el cual vamos a insertar un diccionario y tres parámetros
+requeridos, para poder crear el pedido. Este va a ser un pedido muy
+minimalista, pero ten cuenta que puedes incluir muchos otros campos en
+este pedido, como podrían ser tus productos personalizados, pero
+cubriremos estos campos adicionales en un video-tutorial aparte, que
+lo llamaremos "creación de pedidos avanzado".
+
+Igualmente puedes acudir a la documentación oficial que puedes
+encontrar en los recursos que hemos mostrado antes en el código QR.
+
+El primer campo que vamos a insertar es "amount", que básicamente es
+el precio del producto o item que estás tratando de vender, pero para
+poder especificar este precio, tienes que especificar la divisa
+primero con su identificador, sino estás seguro de que trata esto, te
+recomendamos que veas el video-tutorial de configuración que está
+igualmente en el enlace del código QR, y este te ayudará a entender
+que divisa está en uso en el servidor. En el caso concreto del
+servidor "demo" de Taler, este usa la divisa KUDOS, que obviamente es
+una divisa ficticia con propósito de demostración, y así nosotros
+vamos a crear este pedido con el precio de 10 KUDOS como ejemplo. El
+siguiente campo es el campo "summary", que es un campo de descripción
+que será mostrado en la "wallet" del comprador que esté realizando la
+compra, así que tu puedes usar este campos para en dos o tres palabras
+explicar el contenido de este pedido. Nosotros ponemos "Test
+order". El último campo es el mensaje "fullfillment_message", y en
+este puedes poner cualquier texto que tu quieras, que será mostrado al
+comprador, justo después de realizar el pago. Así por ejemplo nosotros
+ponemos "Gracias por tu pedido", pero por supuesto puedes poner lo que
+quieras.
+
+Quizás te estés preguntando si existe una opción de no mostrar un
+mensaje pero redirigir al usuario hacia una URL concreta, pues bien,
+existe esa posibilidad pero no vamos a cubrirla en este tutorial,
+porque requiere explicaciones adicionales de como funciona el
+sistema. Así que si estás interesado en en el proceso de redirección
+después de pagar un pedido, te animamos a ver el tutorial concreto que
+incluso contiene la explicación de re-compra.
+
+Por último el último elemento que vamos a indicar es el campo
+"create_token" que pondremos con valor falso, por el momento, si
+quieres conocer más sobre este campo porfavor consulta los otros
+tutoriales disponibles en el enlace del codigo QR.
+
+Vamos a mantener este pedido lo más minimalista posible, así que
+simplemente es un pedido de 10KUDOS, donde mostraremos un mensaje de
+agradecimiento justo después de la compra, sin ningún token creado.
+
+Una vez estés listo, puede enviar esta petición a través del botón
+"send", y vas a recibir como respuesta una código o ID de pedido
+único, con este ID de pedido, tu debes construir ahora la URL de pago
+que darás a tu comprador, y en este punto tenemos 2 formas de hacerlo,
+pero la forma más recomendada es enviar una URL con https a tu
+comprador, porque esto le permitirá elegir su cartera (wallet) de
+pago, basado en la ventana emergente que aparecerá en su navegador,
+con un código QR que podrá escanear con su teléfono móvil.
+
+Así que para esta URL de pago, vas a apuntar a tu servicio de backend
+/orders/ID-pedido, donde ID-pedido es el ID de pedido que has recibido
+como respuesta a tu pedido. Este el método recomendado, para que así
+el comprador pueda elegir su método de pago, o desde que cartera
+quiere pagar.
+
+Pero, si estás en una situación que sabes que tu comprador va a pagar
+con la cartera que actualmente se está usando en la página Web, o en
+el caso que tú quieras crear tu propio QR y mostrarlo de una forma
+personalizada, tendrás que utilizar la url del tipo
+taler://pay/sevidor-backend(backend.demo.taler.net)/ID-pedido. Y un
+consejo, si quieres codificar esto dentro de un código QR, y eliges la
+codificación correcta, puedes ver que el ID de pedido está formado por
+caracteres en mayúsculas, y esto es así porque puedes codificar la URL
+entera igualmente en mayusculas, y así tener la URL completa, bajo un
+código QR, y sigue siendo una URL perfectamente válida.
+
+En este tutorial, yo voy a usar la URL estándar de pago con
+https. Cuando el comprado clique la URL en su navegador, el verá un
+codigo QR, que le permitirá pagar con la wallet de su teléfono móvil,
+y justo debajo del código QR, podrá usar el botón para abrir la
+cartera instalada en su navegador , si la tiene, y sino la tuviera,
+por último aparece un enlace que nos lleva a una ayuda de como
+instalarla.
+
+Pero antes de pagar por este pedido quiero enseñarte algo más. Para
+ver el estado de este pedido, antes podemos hacer una petición GET,
+borrar el cuerpo de la petición, y añadir al final
+/private/orders/id-pedido. Si enviamos esta petición, podremos ver que
+los 2 enlaces de pago que hemos explicado antes, aparecen en la
+respuesta de la API, y mucho más importante puedes ver un resumen de tu
+pedido, e incluso el "estado" de pago del pedido, que por ahora no
+aparece como pagado.
+
+Si quieres ver si tu comprador o cliente, ha pagado por este pedido,
+por supuesto puedes refrescar esta petición a la API, todas las veces
+que requieras, hasta que veas que el campo "order_status" ha cambiado
+a "pagado". Pero hay un camino más inteligente de hacer esto, que
+consiste en añadir al final de la URL, "?timeout_ms=XXXXX" siendo XXXX
+los mili-segundos que deseas esperar, hasta que el comprador pague el
+pedido. Así vamos a probar con 10 segundos, para tener una idea de
+como funciona, básicamente cuando enviemos la petición, esta esperará
+por 10 segundos a ser pagada por el comprador,en el caso del que el
+comprador/a, pague este pedido, recibirás inmediatamente la respuesta
+de la API, justo en el momento que el comprador/a, haya pagado. En el
+caso de que estos 10 segundos pasen y no haya existido pago por parte
+del comprador, recibirás la respuesta estándar, indicando que el
+pedido sigue sin haber sido pagado.
+
+Así que dejame que os demuestre esto, pagando este pedido, y dándome a
+mi mismo dos minutos para realizar el pago, así que la izquierda está
+mi programa de gestión de peticiones API (insomnia), en el medio
+tenemos el codigo QR que será presentado al comprador en su pantalla
+del navegador, y en el derecha está mi teléfono, que sería en este
+caso el teléfono del cliente, que es quien va a pagar eset pedido.
+Así el cliente abrirá la APP taler wallet en su teléfono móvil, y como
+podemos ver tiene 39,99 kudos, disponibles como su saldo, así que
+podrá realizar esta compra con coste de 10. Así vamos a darle a
+comenzar a la petición a la API (al pedido), y vemos como comienza a
+contar los segundos que pasan, esperando al cliente para que realice
+el pago. El cliente con su teléno escanerá el codigo QR con su
+telefono movil, y la APP de Taler wallet, y enseguida verá los detalle
+sobre la cantidad que tiene pagar, así como la comisión del exchange,
+y si está de acuerdo, confirmará el pago. Y como verás , nada más
+realice el pago su saldo, es actualizado (restando 10 kudos), y el
+pago está realizado, y en la parte izquierda veremos que la respuesta
+de la API es instantánea, y provee de mucha información sobre el
+pedido, que no vamos a cubrir en su totalidad, pero que la información
+clave que podemos ver de esta respuesta es, que el campo
+"order_status" ahora está marcado como "pagado". Así que sabemos con
+certeza que el cliente pagó correctamente este pedido. Si tú o el
+cliente, refrescas la pagina del pedido, en vez del antiguo codigo QR
+podrás ver un resumen del pedido, así como la confirmación de que el
+pago ha sido correctamente realizado.
+
+Esto ha sido todo para este tutorial, y ahora ya sabes como crear un
+pedido básico, pronto una versión de este tutorial será publicado, y
+así podrás aprender sobre los "campos" adicionales que podrías
+insertar en estos pedidos, e igualmente aprender a usar las
+plantillas, los productos, y como emitiré recompensas hacia tus
+clientes. También como realizar devoluciones (refunds), y como usar
+URL's de redirección (fullfillmente urls), en vez del mensaje que se
+muestra en la wallet de los clientes. Que incluye un mecanismo llamado
+"re-purchase detection" o detección de re-compra, que será explicado
+en este nuevo tutorial.
+
+Como siempre y como recordatoria, en este QR o dirección URL puedes
+encontrar todos los recursos que hemos usado en este video, incluyendo
+el resto de tutoriales asociados. Muchas gracias por seguir este
+tutorial, nos vemos en el próximo.
+
+