Confirmar

Clave de API: Payment

Confirma el stablecoin y la red de una factura que sigue en awaiting_client. Da igual cómo se haya expresado el importe: la llamada asigna la dirección de depósito y mueve la factura a awaiting_payment. Si el importe va en fiat, el tipo de cambio se fija en ese mismo momento. Si ya va en un token no hay tipo que fijar: el token que confirmas tiene que ser el que se pidió al crear la factura, y la red también cuando quedó fijada ahí.

Usa este endpoint cuando dibujes tu propia página de pago y recojas la elección del token en tu servidor. Cuando el pago lo atiende el propio Paymos —la página a la que lleva la payment_url, el pago integrado en iframe, el Low-Code SDK o el bot de Paymos que la payment_url de un proyecto de Bot de Telegram abre en su lugar—, la elección se confirma por esa misma vía y esta llamada no hace falta. Y el canal del proyecto no la limita: confírmala en tu servidor también en un proyecto de Bot de Telegram, y el enlace que abre quien paga llevará directo a la dirección de depósito, sin paso de selección.

Lo que tienes aquí es un endpoint, no un producto de marca blanca. Te deja construir la página de pago por tu cuenta, en tu propio dominio, y no cambia nada en las páginas que alojamos nosotros: ahí el pie "Secured by Paymos" aparece con cualquier tema y en cualquier modo de incrustación, y Paymos no ofrece una página de pago bajo tu propio dominio.

Cuerpo de la petición

Parámetro	Tipo	Obligatorio	Descripción
currency	string	Sí	El stablecoin con el que el cliente ha decidido pagar (por ejemplo, USDT, USDC). Debe estar activado en el proyecto de la factura
network	string	Sí	La red en la que el cliente ha decidido pagar (por ejemplo, TRC20, BASE); debe ser una red donde ese token esté activado

{
  "currency": "USDT",
  "network": "TRC20"
}

Respuesta (200 OK)

Devuelve la factura completa con su sección payment ya rellena: la currency y la network elegidas, la address de depósito asignada, el exchange_rate fijado si la factura va en fiat, y el importe expected en cripto. Como esta llamada se autentica con tu clave de comercio, la respuesta incluye además los campos fee y net, reservados al comercio. El cuerpo tiene la misma forma que en Obtener factura.

Errores

Consulta Códigos de error para el catálogo completo. La URI de type en cada respuesta de error enlaza directamente con la fila correspondiente. Confirmar una factura que no es tuya devuelve 404. Una factura expired o cancelled devuelve 410; cualquier otro estado posterior a awaiting_client devuelve 409, incluidos los finales paid, paid_over y underpaid.