Creación de incoming payment y quote en Open Payments

Crear un pago entrante con open payments es más simple cuando entiendes el flujo: permiso del emisor, recurso del receptor y cotización previa. Aquí verás cómo Alicia autoriza y Bob recibe con un incoming payment y cómo se prepara la quote que asegura transparencia antes del envío.

¿Qué es un incoming payment y cómo se configura?

Un incoming payment funciona como un boleto o recibo digital: indica que Bob está listo para recibir una cantidad específica con condiciones definidas. Se crea en el resource server del receptor, descubierto desde su wallet address. Con el token otorgado previamente por el auth server, el cliente queda autorizado para crear el recurso.

¿Qué incluye el cuerpo de la petición?

• wallet address única de Bob: define dónde recibirá el pago.
• incoming amount: monto y moneda, en este caso dólares.
• asset y escala: decimales del activo; aquí la escala es 2.
• términos y condiciones: reglas que aplican al pago.

¿Cómo validar el pago entrante en ejecución?

• Ejecuta: node index.js.
• Si aparece referencia de route con “grant no finalizado”, revisa el condicional if del paso previo.
• Ajusta importando la lógica de finalización del grant desde la librería de open payments y guarda.
• Verifica de nuevo: el pago queda “montado”. Con esto se completa el paso 3.

¿Cómo avanza el flujo con la billetera y las transacciones?

La billetera de pruebas permite revisar estados. Se elige la cuenta de dólares de Marian y la wallet de Bob. El tipo de transacción es incoming y el estado queda pendiente porque falta la cotización.

¿Qué revisas en la billetera de pruebas?

• Selección de cuenta origen: dólares de Marian.
• Selección del receptor: wallet de Bob.
• Tipo de transacción: incoming.
• Estado: pendiente hasta completar la cotización.

¿Qué es un quote y cómo se crea en open payments?

Un quote es la cotización: calcula cuánto envía el emisor, cuánto recibe el receptor, qué rutas son más óptimas y qué tasas de conversión aplican. Funciona como contrato previo entre Alicia y Bob: ambas partes saben el resultado del pago antes de enviarlo. Se crea en el resource server, pero requiere permiso del auth server del emisor.

¿Qué autoriza el emisor y con qué token?

• Solicitas al auth server de Alicia el permiso para crear la cotización.
• Si se concede, recibes un access token.
• Con ese token llamas al resource server de Alicia para crear el quote.
• El quote devuelve datos clave: creado, fecha de creación, expiración y montos. El amount recibido puede ser 0 hasta completar el outgoing payment.

¿Cómo se verifica la concesión del quote?

• Se realiza la petición de concesión del quote y se revisa la autorización.
• Se crea el quote y, si corresponde, se espera la finalización de la concesión antes de continuar.
• Se imprime el objeto para validar su información.

¿Te gustaría que detallemos cómo usar ese quote grant para crear el client Quote Create y obtener la cotización con los detalles de envío y recepción? Deja tus preguntas y comentarios.