Docs
Acceder
Integraciones

Integraciones MercadoPago

Automatizaci贸n de Facturaci贸n Electr贸nica para Mercado Pago POS (Point)

Manual de integraci贸n t茅cnica, flujo de arquitectura y alcances para la emisi贸n fiscal automatizada y centralizada de la infraestructura de ViaSRV vinculada a terminales de cobro f铆sicas.

Arquitectura y Flujo de Datos

El servicio opera bajo el est谩ndar seguro de OAuth 2.0 y suscripciones a eventos en tiempo real mediante Webhooks globales atendidos de inmediato por el backend de ViaSRV.
1
Captura en terminal
El cliente procesa su tarjeta de d茅bito o cr茅dito en el dispositivo Point f铆sico del comercio.
2
Despacho Webhook
Mercado Pago notifica de inmediato el ID del recurso al endpoint global api.viasrv.com.
3
Inferencia Fiscal
Nuestra API descarga los detalles del cobro, calcula montos imponibles netos y valida si el n煤mero de serie f铆sico (*Serial Number*) est谩 autorizado en el alcance del usuario.
4
Timbrado ARCA
Se establece conexi贸n por canales seguros SOAP con los servidores de ARCA utilizando tus certificados digitales (.key y .crt).
5
Resguardo y Disponibilidad
El comprobante obtiene el CAE correspondiente, se almacena en tu historial y queda disponible de inmediato para su descarga en PDF o consulta API.

Requisitos Previos Administrativos

Punto de Venta Exclusivo

Debe dar de alta un Punto de Venta nuevo en el portal de ARCA/AFIP desde el administrador de puntos de venta. El tipo debe ser obligatoriamente Factura Electr贸nica - WebServices. No reutilice puntos de venta manuales para evitar colisiones cr铆ticas de correlativos.

Certificados Digitales Activos

Su cuenta en ViaSRV debe tener delegada de forma correcta la firma digital en ARCA correspondiente al CUIT titular de la cuenta de Mercado Pago que recibir谩 los fondos de las transacciones.

Pasos para la Integraci贸n (OAuth 2.0)

1
Vincular Cuenta (Handshake)
Dir铆jase a la secci贸n de Canales de Venta / Mercado Pago de su panel de control e inicie la vinculaci贸n. El sistema lo redireccionar谩 a la URL de autorizaci贸n global:
https://auth.mercadopago.com/authorization?client_id=YOUR_CLIENT_ID&response_type=code&platform_id=mp&redirect_uri=https://api.viasrv.com/api/oauth/mp-callback&state=CLIENTE_ID
2
Definici贸n del Alcance (Scope)
El motor de ViaSRV permite segmentar los cobros mediante dos esquemas seleccionables en la interfaz:
  • Modo Global (all): Factura de forma irrestricta toda la recaudaci贸n (Link de Pago, QR y terminales).
  • Modo Selectivo (selective): El sistema listar谩 mediante cURL los n煤meros de serie de tus dispositivos Point. Podr谩s marcar individualmente cu谩les tienen emisi贸n activa.

Gesti贸n de Contingencias y Validaciones

L铆mites de Identificaci贸n (Consumidor Final)

El motor controla autom谩ticamente los topes vigentes dispuestos por ARCA para ventas a consumidores finales an贸nimos. Si el cobro excede el l铆mite legal, la API pausar谩 la emisi贸n y la retendr谩 en la cola del panel para permitirle asociar un DNI/CUIT de forma manual.

Queue Engine (Cola de Reintentos): Si los servidores de ARCA experimentan microcortes, degradaci贸n o ca铆das completas, el webhook guarda el evento con estado pendiente. El motor asincr贸nico ejecutar谩 barridos autom谩ticos cada 15 minutos hasta consolidar el CAE definitivo del comprobante.

Tabla de Errores Comunes de Retorno

Par谩metro reason Causa Probable Soluci贸n Sugerida
cancelado El usuario presion贸 "Volver al sitio" o rechaz贸 los permisos en la pantalla de Mercado Pago. Reintentar el proceso de enlace y hacer clic en el bot贸n "Permitir".
internal Falla cr铆tica de base de datos al intentar persistir los tokens de acceso cifrados del comercio. Abrir un ticket de soporte en la plataforma aportando el n煤mero de CUIT.
Vac铆o Expiraci贸n del c贸digo de autorizaci贸n temporal provisto debido a un tiempo de espera muy prolongado. Refrescar la pantalla de la secci贸n de Canales e iniciar la vinculaci贸n inmediatamente.

En esta Pagina

Arquitectura y Flujo de Datos Requisitos Previos Administrativos Pasos para la Integraci贸n (OAuth 2.0) Gesti贸n de Contingencias y Validaciones Tabla de Errores Comunes de Retorno
FAQ Support