Technical manualManual técnico › Mercado Pago › Mercado Pago accountMercado Pago › Cuenta de Mercado Pago

Mercado Pago account

Cuenta de Mercado Pago

To charge with QR and with the Point terminal, Kubrik POS needs the credentials of your Mercado Pago account. You can keep two loaded, one for testing and one real, and you choose which one charges.

Para cobrar con QR y con la terminal Point, Kubrik POS necesita las credenciales de tu cuenta de Mercado Pago. Podés tener dos cargadas, una de prueba y una real, y elegís con cuál se cobra.

👤 Who: Administrator📍 Where: Gestión → Admin → Fiscal · ARCA → Mercado Pago

👤 Quién: Administrador📍 Dónde: Gestión → Admin → Fiscal · ARCA → Mercado Pago

What you need from Mercado Pago

Qué necesitás de Mercado Pago

Both values come from the Mercado Pago developers site, in your application.

Los dos valores salen del sitio de desarrolladores de Mercado Pago, en tu aplicación.

Value	Where it is	What it is for
Access token	Credenciales of your application. For testing, use the application created with the test seller account.	The key the system uses to ask Mercado Pago for charges.
Webhook secret	Webhooks → Configurar notificaciones. As the address for the notifications, use the one of your Kubrik POS server ending in /api/v1/retail-pos/webhooks/mercado-pago; ask the technical team for the full address. The secret is shown once, when you press Save.	Proves that each payment notice really comes from Mercado Pago.

Valor	Dónde está	Para qué sirve
Access token	Credenciales de tu aplicación. Para pruebas, usá la aplicación creada con la cuenta vendedora de prueba.	La llave con la que el sistema le pide cobros a Mercado Pago.
Webhook secret	Webhooks → Configurar notificaciones. Como dirección de las notificaciones va la de tu servidor de Kubrik POS terminada en /api/v1/retail-pos/webhooks/mercado-pago; pedile la dirección completa al equipo técnico. El secreto se muestra una sola vez, al apretar Guardar.	Comprueba que cada aviso de pago venga realmente de Mercado Pago.

Load the credentials

Cargar las credenciales

Open the form. The first time, the form Configurar credenciales is already open. Later, open it with Rotar, or with Cargar credencial on the empty card of the mode you want.
Type an Alias, a name of your own to recognise this credential later, and choose the Modo: SANDBOX for testing with fictitious money, PRODUCTION for real money.
Paste the Access token and press Validar token. The account number (MP user_id) is filled in by itself. The screen warns you if the account does not match the mode, or if Mercado Pago did not say which type of account it is.
Paste the Webhook secret. Add Notas if you want to record why you are loading it.
Press Guardar credenciales (Rotar y guardar when that mode already has a credential). You see Credenciales guardadas (cifradas).

Abrí el formulario. La primera vez, el formulario Configurar credenciales ya está abierto. Después, abrilo con Rotar, o con Cargar credencial en la tarjeta vacía del modo que quieras.
Escribí un Alias, un nombre tuyo para reconocer después esta credencial, y elegí el Modo: SANDBOX para probar con plata ficticia, PRODUCTION para plata real.
Pegá el Access token y tocá Validar token. El número de la cuenta (MP user_id) se completa solo. La pantalla te avisa si la cuenta no coincide con el modo, o si Mercado Pago no dijo de qué tipo de cuenta se trata.
Pegá el Webhook secret. Agregá Notas si querés dejar asentado por qué la cargás.
Tocá Guardar credenciales (Rotar y guardar cuando ese modo ya tiene una credencial). Ves Credenciales guardadas (cifradas).

⛔

The first credential you save goes into use by itself. There is no confirmation: if the first one is the PRODUCTION credential, charges move real money from that moment. Load the SANDBOX credential first. A credential loaded afterwards for the other mode stays EN RESERVA until you press Usar esta cuenta.La primera credencial que guardás queda en uso sola. No pide confirmación: si la primera es la de PRODUCTION, desde ese momento los cobros mueven plata real. Cargá primero la de SANDBOX. Una credencial cargada después para el otro modo queda EN RESERVA hasta que toques Usar esta cuenta.

⚠️

The mode has to match the account. A real account cannot be saved as SANDBOX, and a test account cannot be saved as PRODUCTION: with a test account in production the cashier would believe they charged and no money would come in. The screen blocks both cases and tells you which one it is.El modo tiene que coincidir con la cuenta. Una cuenta real no se puede guardar como SANDBOX, ni una de prueba como PRODUCTION: con una cuenta de prueba en producción el cajero creería que cobró y no entraría plata. La pantalla bloquea los dos casos y te dice cuál es.

ℹ️

The token and the secret are stored encrypted and are never shown again after saving. To replace them, load new ones for the same mode with Rotar: the previous ones remain in Historial de credenciales. If the new credentials belong to a different Mercado Pago account than the one in use, every till has to be closed, as when switching accounts.El token y el secreto se guardan cifrados y no se vuelven a mostrar después de guardar. Para reemplazarlos, cargá otros para el mismo modo con Rotar: los anteriores quedan en Historial de credenciales. Si las credenciales nuevas son de otra cuenta de Mercado Pago que la que está en uso, todas las cajas tienen que estar cerradas, igual que al cambiar de cuenta.

Choose the account that charges

Elegir la cuenta que cobra

The Cuenta de Mercado Pago panel has two cards, Sandbox and Producción. The one tagged EN USO is the one every till charges with; the other is EN RESERVA. Only one charges at a time.

El panel Cuenta de Mercado Pago tiene dos tarjetas, Sandbox y Producción. La que dice EN USO es con la que cobran todas las cajas; la otra queda EN RESERVA. Se cobra con una sola a la vez.

Press Probar on the card. It checks the connection without changing anything, and confirms the type of account.
Have every till of the company closed.
Press Usar esta cuenta on the card in reserve.
Confirm. When the change means charging real money, the window says so in red: Desde que confirmes, cada cobro mueve plata real.

Tocá Probar en la tarjeta. Verifica la conexión sin cambiar nada, y confirma el tipo de cuenta.
Hacé cerrar todas las cajas de la empresa.
Tocá Usar esta cuenta en la tarjeta en reserva.
Confirmá. Cuando el cambio implica cobrar plata real, la ventana lo dice en rojo: Desde que confirmes, cada cobro mueve plata real.

Charges already made stay in the account where they were made, and so do their refunds. Till assignments are kept per account, so the new account starts with its own, empty the first time. The terminal list is not: after switching, press Sincronizar con MP and review Tills and Point terminals. Both panels configure only the account in use.

Los cobros ya hechos quedan en la cuenta donde se hicieron, igual que sus devoluciones. Las asignaciones de cajas se guardan por cuenta, así que la cuenta nueva arranca con las suyas, vacías la primera vez. La lista de terminales no: después de cambiar, tocá Sincronizar con MP y revisá Cajas y terminales Point. Los dos paneles configuran solo la cuenta en uso.

Common issues

Problemas habituales

"Ninguna cuenta de Mercado Pago está en uso": Credentials are loaded but none is in use. Press Usar esta cuenta on the right one. Until then no point of sale can charge with Mercado Pago.
"El token no es válido.": Copy the access token again, complete, from the application of the right account.
"No pudimos verificar si esta cuenta es de prueba": The token is valid but Mercado Pago did not say the type of account. Check by hand where the credentials came from before charging with them.
"No se cambió la cuenta: …": Read the rest of the message. If it names an open till, close it and try again; it names one till at a time, so repeat until none is left. If it talks about the access token or the type of account, load that credential again with Rotar.
The cashier sees "La integración con Mercado Pago está apagada": The integration is switched off for the whole installation. Ask the technical team to turn it on.
"Mercado Pago está en modo de prueba interno": Charges would be approved without money coming in. Tell the technical team before operating.
I need to disconnect the account: There is no button to unlink. Put the other account in use, or load new credentials with Rotar.

«Ninguna cuenta de Mercado Pago está en uso»: Hay credenciales cargadas pero ninguna está en uso. Tocá Usar esta cuenta en la que corresponda. Hasta entonces ningún punto de venta puede cobrar con Mercado Pago.
«El token no es válido.»: Copiá de nuevo el access token, completo, desde la aplicación de la cuenta correcta.
«No pudimos verificar si esta cuenta es de prueba»: El token es válido pero Mercado Pago no dijo el tipo de cuenta. Revisá a mano de dónde salieron las credenciales antes de cobrar con ellas.
«No se cambió la cuenta: …»: Leé el resto del mensaje. Si nombra una caja abierta, cerrala y probá de nuevo; nombra de a una, así que repetí hasta que no quede ninguna. Si habla del access token o del tipo de cuenta, volvé a cargar esa credencial con Rotar.
El cajero ve «La integración con Mercado Pago está apagada»: La integración está apagada para toda la instalación. Pedile al equipo técnico que la encienda.
«Mercado Pago está en modo de prueba interno»: Los cobros se aprobarían sin que entre plata. Avisá al equipo técnico antes de operar.
Necesito desconectar la cuenta: No hay un botón para desvincular. Poné en uso la otra cuenta, o cargá credenciales nuevas con Rotar.