Paymentbox

El paymentbox (la página de pago hospedada) se abre con un enlace o dentro de un iframe en tu sitio. Podés crearlo por API (recomendado: el monto no viaja en una URL que el cliente pueda editar) o armar la URL directamente.

Con la API

POST /v2/payments devuelve checkout_url, válida 60 minutos. Redirigí al cliente o usala como src del iframe. Ver referencia →

Con una URL

https://paymentbox.e-payouts.com/?module=65cdef71-b6b8-11f1-8ee3-d721203bc734&price=25.00&currency=EUR&ucode=PEDIDO-1001&cname=Ana%20Garc%C3%ADa&cemail=ana%40example.com

v1 (compatible)

https://paymentbox.e-payouts.com/?uid=1001&mid=5001&price=25.00&ucode=PEDIDO-1001&cname=Ana%20Garc%C3%ADa&cemail=ana%40example.com

El formato v1 (uid + mid) solo funciona en cuentas migradas con la integración v1 habilitada; las cuentas nuevas usan module. Integración v1 →

Parámetro	Ya existía en v1	Descripción
module obligatorio	nuevo	Id del módulo (UUID). En formato v1: uid (comercio) + mid (módulo).
price	sí, mismo nombre	Monto con punto decimal. Si el módulo tiene precio por defecto, es opcional y lo reemplaza; si el precio del módulo está marcado como fijo, se cobra ese y el de la URL se ignora.
currency	nuevo	ISO 4217. Por defecto, la moneda de la cuenta del comercio (EUR o USD). Si el cliente paga en otra, se convierte a la de la cuenta con el tipo de cambio del momento. En el formato v1 no se usa.
ucode	sí, mismo nombre	Tu código de pedido (hasta 64 caracteres: letras, números y . _ : / # -). Vuelve en el webhook y en la redirección.
pm	sí, mismo nombre	Mostrar solo ese método (si está disponible).
cemail	sí, mismo nombre	Precarga el email del cliente.
cname	sí, mismo nombre	Precarga el nombre del cliente.
cc	sí, mismo nombre	País del cliente (ISO alfa-2): afecta tarifas y métodos, y el idioma si el navegador no indica uno disponible.
localprice	sí, mismo nombre	Solo formato v1, junto con cc: precio en la moneda local del país (p. ej. cc=uy&localprice=1000 = 1000 UYU). Es lo mismo que pedir ese monto y esa moneda con module, price y currency: el checkout muestra ese monto y cada método cobra el equivalente que necesite, al tipo de cambio del momento. Tiene prioridad sobre price. En el aviso v1, price y currency van en la moneda de tu cuenta. Países: AR, BO, BR, CL, CO, CR, DO, GT, HN, MX, NI, PE, PY, UY.
lang	nuevo	en \| es \| fr \| de \| it \| pt. Sin este parámetro se usa el idioma del navegador; si no es uno de estos, el del país; y si no, inglés. El cliente lo puede cambiar en el checkout.

Si no mandás cc, el paymentbox detecta el país del cliente por su IP y muestra los métodos de ese país; en el pie de la página el cliente puede cambiarlo. Con cc se usa ese país y no se puede cambiar. Si creás el pago por API con method, name y email, el cliente no ve la pantalla de «Pagar»: va directo al proveedor. En MB WAY (con phone, un móvil de Portugal) la pantalla aparece igual, con los datos ya cargados, y el cliente confirma con un clic: así nadie recibe una notificación de pago en el teléfono sin haberla pedido.

Con una URL, el cliente podría cambiar el monto. Confirmá siempre el pago con el webhook (verificando la firma) y compará monto y ucode con tu pedido antes de entregar.

Iframe

HTML

<iframe src="https://paymentbox.e-payouts.com/?module=…&price=25.00&ucode=PEDIDO-1001" width="100%" height="640" style="border:0" title="e-Payouts"></iframe>

El paymentbox solo se deja embeber desde el dominio del sitio registrado en tu panel de comercio (Content-Security-Policy frame-ancestors). En pantallas anchas se muestra en dos columnas; en móviles, en una.

Vuelta a tu sitio

Al terminar, el botón "Volver" lleva a la URL de éxito o de error del módulo con estos parámetros (solo informativos: la confirmación válida es el webhook):

https://tu-sitio.com/gracias?code=9d6c9572-…&ucode=PEDIDO-1001&status=completed

code — id del pago en e-Payouts (en la integración v1, el código de pago de 12 caracteres).
ucode — tu código de pedido.
status — completed | pending | failed.
sandbox=1 — solo en pagos de prueba.