Marketplaces

Marketplaces permite a comercios que operan como intermediarios entre compradores y vendedores procesar pagos y liquidar fondos a los vendedores de forma automática y segura.

Referencia API relacionada

• Crear una intención de pago
• Confirmar una intención de pago
• Obtener una intención de pago
• Listar todas las intenciones de pago

Crear una cuenta marketplace

Creá la cuenta desde la sección Marketplace del Dashboard de ONVO. Ahí indicás el nombre del comercio vendedor y el porcentaje de comisión de marketplace, adicional a las comisiones transaccionales de ONVO y retenciones cuando apliquen.

Al crear la cuenta, ONVO genera:

• Un Account ID para identificar al vendedor en transacciones.
• Un enlace de onboarding para que el vendedor complete su registro.

Onboarding de vendedores

El enlace de onboarding es único por cuenta marketplace. El vendedor debe completarlo para poder recibir pagos. Durante este proceso, indica las cuentas IBAN donde recibirá liquidaciones.

El enlace expira después de 7 días. Podés regenerarlo desde el detalle de la cuenta marketplace; al hacerlo, el enlace anterior queda expirado.

Cuando el onboarding se completa, la cuenta marketplace queda habilitada para aceptar pagos en su nombre.

Flujo de pago

Usá siempre las API keys de la cuenta primaria, es decir, la cuenta que creó el marketplace. Las cuentas marketplace no tienen API keys propias.

Los métodos de pago también deben crearse en la cuenta primaria.

1. Creá una intención de pago con el atributo onBehalfOf, usando el Account ID del vendedor.

{
  "amount": 10000,
  "currency": "USD",
  "onBehalfOf": "ma502zv0d0127ebdp3zt27651"
}

2. Confirmá la intención de pago con el paymentMethodId.

{
  "paymentMethodId": "cl502zv0d0127ebdp3zt27651"
}

3. Si el cobro es exitoso, ONVO calcula comisiones, retenciones y comisión marketplace sobre el monto bruto.

Ejemplo para una transacción de 100.00 USD:

Concepto	Monto
Monto bruto	100.00 USD
Comisión ONVO 3.5%	3.50 USD
Retención 2%	2.00 USD
Monto neto	94.50 USD
Comisión marketplace 5%	5.00 USD
Monto a liquidar al vendedor	89.50 USD

La comisión marketplace se deposita en la cuenta primaria y el monto neto se deposita al vendedor.

Modo de prueba y producción

Podés crear cuentas marketplace en modo de prueba o producción según el modo activo del Dashboard.

Las cuentas creadas en modo de prueba solo funcionan con llaves de prueba. Las cuentas creadas en modo producción solo funcionan con llaves live. No se puede cambiar el modo de una cuenta una vez creada.