MONEI Connect para desarrolladores

Conviértete en partner de pagos integrado para ofrecer servicios de pago a los usuarios de tu plataforma o marketplace con MONEI Connect. Registra comercios bajo tu marca, gestiona sus cuentas en su nombre a través de las APIs REST y GraphQL, e integra pagos con tarjeta presenciales directamente dentro de tu app de comercio con los SDKs de MONEI Pay.

Antes de empezar

Regístrate como partner en el Partner Dashboard en partners.monei.com, con tu email o con tu cuenta de Google o de Apple. El alta te da al momento una cuenta de partner de prueba, así que puedes construir y probar tu integración de inmediato. Consulta Date de alta.

Para usar el modo en producción, completa Incorporación en el Partner Dashboard. Consulta Puesta en marcha. Cuando tu cuenta de partner está en producción, obtienes tu clave de API en producción y un enlace de registro único para tu cuenta de partner. Cada comercio que se registre a través de este enlace quedará vinculado a ti.

Cómo funciona

Claves de API

Genera tus claves de API de partner en partners.monei.com/settings/api → Crear clave de API. La página es sensible al modo: cambia al modo en producción para tu clave pk_live_…, y al modo de prueba para tu clave pk_test_…. Las claves se pueden revocar y volver a crear desde la misma página.

Modo de prueba y modo en producción

Cada cuenta de partner es en realidad un par: una cuenta en producción (pk_live_…) y una cuenta de prueba (pk_test_…) vinculadas de forma permanente. Cada comercio que se registre a través de tu enlace de registro recibe el mismo tratamiento doble: una subcuenta de producción y una subcuenta de prueba con IDs diferentes.

Esto significa que puedes construir y probar la integración completa —incorporación, llamadas a la API, — en modo de prueba antes de que ningún comercio firme el contrato.

• Las subcuentas de prueba se activan inmediatamente tras confirmar el email de registro; el comercio no necesita completar la incorporación.
• Las subcuentas en producción permanecen en PENDING_CONTRACT hasta que el comercio firme el contrato y sea aprobado.
• Las claves en producción no pueden llamar a subcuentas de prueba (ni viceversa). La incompatibilidad de modos es la causa número 1 de errores 401 — consulta Errores de autenticación comunes.
• El selector de modo en el panel (barra superior) cambia toda la vista entre las subcuentas en producción y de prueba.

Enlace de registro

El enlace de registro es único para tu cuenta de partner. Cada comercio que se registre a través de él quedará vinculado a ti.

https://dashboard.monei.com/signup&promo=<PARTNER_CODE>

Opcionalmente, puedes pasar un ID externo para identificar al comercio en tu propio sistema. El ID se devuelve en cada webhook.

https://dashboard.monei.com/signup&promo=<PARTNER_CODE>&mid=<EXTERNAL_ID>&h=<HASH>

• mid — tu ID de comercio externo.
• h — HMAC-SHA256(<EXTERNAL_ID>, <PARTNER_API_KEY>) en hexadecimal.

nota

Tu cuenta de partner puede configurarse para requerir un ID externo. Cuando está habilitado, el enlace de registro siempre debe incluir mid + h.

Integración

Envía tu clave de API de partner en la cabecera Authorization y el ID de cuenta del comercio en la cabecera MONEI-Account-ID en cada solicitud.

API REST

Referencia completa: API REST.

cURL

POST https://api.monei.com/v1/payments

curl --request POST 'https://api.monei.com/v1/payments' \
--header 'Authorization: <PARTNER_API_KEY>' \
--header 'MONEI-Account-ID: <MONEI_ACCOUNT_ID>' \
--header 'Content-Type: application/json' \
--header 'User-Agent: MONEI/<PARTNER_NAME>/0.1.0' \
--data-raw '{
  "amount": 110,
  "currency": "EUR",
  "orderId": "14379133960355",
  "description": "Test Shop - #14379133960355",
  "customer": {
    "email": "email@example.com"
   },
  "callbackUrl": "https://example.com/checkout/callback"
}'

Node.js

server.js

import {Monei} from '@monei-js/node-sdk';

// Initialize with Partner API Key, Account ID, and User-Agent
const monei = new Monei('<PARTNER_API_KEY>', {
  accountId: '<MONEI_ACCOUNT_ID>',
  userAgent: 'MONEI/<PARTNER_NAME>/0.1.0'
});

async function createMerchantPayment() {
  try {
    const payment = await monei.payments.create({
      amount: 110,
      currency: 'EUR',
      orderId: '14379133960355',
      description: 'Test Shop - #14379133960355',
      customer: {
        email: 'email@example.com'
      },
      callbackUrl: 'https://example.com/checkout/callback'
    });
    console.log('Payment created:', payment.id);
    // Handle the payment response (e.g., redirect URL)
  } catch (error) {
    console.error('Error creating payment:', error.message);
  }
}

createMerchantPayment();

PHP

server.php

<?php
require_once 'vendor/autoload.php';

use Monei\MoneiClient;
use Monei\Model\CreatePaymentRequest;
use Monei\Model\PaymentCustomer;

// Initialize with Partner API Key
$monei = new MoneiClient('<PARTNER_API_KEY>');

// Define primero el User-Agent: los SDK rechazan un Account ID sin él
$monei->setUserAgent('MONEI/<PARTNER_NAME>/0.1.0');
$monei->setAccountId('<MONEI_ACCOUNT_ID>');

try {
  $payment = $monei->payments->create(
      new CreatePaymentRequest([
        'amount' => 110,
        'currency' => 'EUR',
        'order_id' => '14379133960355',
        'description' => 'Test Shop - #14379133960355',
        'customer' => new PaymentCustomer([
          'email' => 'email@example.com'
        ]),
        'callback_url' => 'https://example.com/checkout/callback'
      ])
  );
  echo 'Payment created: ' . $payment->getId();
  // Handle the payment response (e.g., redirect URL)

} catch (\Exception $e) {
  echo 'Error creating payment: ' . $e->getMessage();
}
?>

Python

server.py

import Monei
from Monei import CreatePaymentRequest, PaymentCustomer

# Initialize with Partner API Key
monei = Monei.MoneiClient(api_key='<PARTNER_API_KEY>')

# Define primero el User-Agent: los SDK rechazan un Account ID sin él
monei.set_user_agent('MONEI/<PARTNER_NAME>/0.1.0')
monei.set_account_id('<MONEI_ACCOUNT_ID>')

try:
    payment = monei.payments.create(
        CreatePaymentRequest(
            amount=110,
            currency="EUR",
            order_id="14379133960355",
            description="Test Shop - #14379133960355",
            customer=PaymentCustomer(
                email="email@example.com"
            ),
            callback_url="https://example.com/checkout/callback"
        )
    )
    print(f'Payment created: {payment.id}')
    # Handle the payment response (e.g., redirect URL)
except Exception as e:
    print(f'Error creating payment: {e}')

API GraphQL

Referencia completa: API GraphQL.

POST https://graphql.monei.com

curl --request POST 'https://graphql.monei.com' \
--header 'Authorization: <PARTNER_API_KEY>' \
--header 'MONEI-Account-ID: <MONEI_ACCOUNT_ID>' \
--header 'Content-Type: application/json' \
--header 'User-Agent: MONEI/<PARTNER_NAME>/0.1.0' \
--data-raw '{"query":"{account {name status}}"}'

Pagos NFC presenciales

Referencia completa: SDK de MONEI Pay.

Acepta pagos con tarjeta directamente dentro de tu propia app de comercio, en iOS, Android, React Native o Web. Tu backend genera un token de autenticación POS de corta duración para el comercio y lo entrega al SDK en el dispositivo del comercio.

cURL

POST https://api.monei.com/v1/pos/auth-token

curl --request POST 'https://api.monei.com/v1/pos/auth-token' \
--header 'Authorization: <PARTNER_API_KEY>' \
--header 'MONEI-Account-ID: <MONEI_ACCOUNT_ID>' \
--header 'User-Agent: MONEI/<PARTNER_NAME>/0.1.0'

Node.js

server.js

import {Monei} from '@monei-js/node-sdk';

const monei = new Monei('<PARTNER_API_KEY>', {
  accountId: '<MONEI_ACCOUNT_ID>',
  userAgent: 'MONEI/<PARTNER_NAME>/0.1.0'
});

const {token} = await monei.posAuthToken.create();
// Send `token` to the merchant app

PHP

server.php

<?php
require_once 'vendor/autoload.php';

use Monei\MoneiClient;

$monei = new MoneiClient('<PARTNER_API_KEY>');
$monei->setUserAgent('MONEI/<PARTNER_NAME>/0.1.0');
$monei->setAccountId('<MONEI_ACCOUNT_ID>');

$result = $monei->posAuthToken->create();
$token = $result->getToken();
// Send $token to the merchant app
?>

Python

server.py

import Monei

monei = Monei.MoneiClient(api_key='<PARTNER_API_KEY>')
monei.set_user_agent('MONEI/<PARTNER_NAME>/0.1.0')
monei.set_account_id('<MONEI_ACCOUNT_ID>')

result = monei.pos_auth_token.create()
token = result.token
# Send token to the merchant app

La respuesta contiene un JWT válido durante 24 horas, con alcance al comercio identificado por MONEI-Account-ID. Pásalo al SDK en el dispositivo del comercio. Opcionalmente, puedes incluir pointOfSaleId / storeId en el cuerpo para limitar el token a un terminal o tienda específicos.

aviso

Los reembolsos nunca deben automatizarse. Cada reembolso requiere una instrucción escrita y trazable del comercio. Los partners son responsables de cualquier reembolso no autorizado y pueden ver su contrato rescindido.

Probar la integración

Puedes construir la integración de partner completa de extremo a extremo antes de que ningún comercio firme un contrato.

1. Registra un comercio de prueba a través de tu enlace de registro: https://dashboard.monei.com/signup&promo=<PARTNER_CODE>. No es necesario completar la incorporación — la subcuenta de prueba ya está activa.

2. Obtén el ID de la subcuenta de prueba: en el panel del comercio, activa el modo de prueba (selector en la barra superior) → Configuración → copia el ID de cuenta.

   Cabecera del panel de MONEI con el selector en Prueba, de modo que el panel muestra datos de prueba

3. Obtén tu clave de API de partner de prueba: inicia sesión en partners.monei.com → activa el modo de prueba → Configuración → Acceso a API → haz clic en Crear clave de API si aún no tienes una → copia la clave pk_test_*.

4. Llama a la API con ambas cabeceras, usando números de tarjeta de prueba y los simuladores de respuesta documentados en Pruebas:

curl --request POST 'https://api.monei.com/v1/payments' \
--header 'Authorization: pk_test_<...>' \
--header 'MONEI-Account-ID: <TEST_SUB_ACCOUNT_ID>' \
--header 'Content-Type: application/json' \
--data-raw '{"amount": 110, "currency": "EUR", "orderId": "test-1"}'

Errores de autenticación comunes

Cuando obtengas un error 401, comprueba lo siguiente en orden:

• Incompatibilidad de modos — usar una clave pk_live_* con un MONEI-Account-ID de prueba (o viceversa). La clave de partner y la subcuenta deben estar en el mismo modo.
• IP no incluida en la lista de permitidas — si registraste una lista de IPs permitidas (opcional pero recomendado), las llamadas deben originarse desde una de esas IPs. Para añadir o eliminar una IP, edita IPs permitidas en el Partner Dashboard, en Configuración → Seguridad.
• MONEI-Account-ID incorrecto — la subcuenta debe pertenecer a tu cuenta de partner. Las subcuentas de otros partners (o cuentas independientes) son rechazadas.
• MONEI-Account-ID ausente — sin él, la clave se autentica como el propio partner, lo que solo funciona para un pequeño subconjunto de endpoints exclusivos de partners. Para todas las operaciones de comercio, incluye la cabecera.

Webhooks

Configura los webhooks en el Partner Dashboard en Configuración → Webhooks. Cada webhook es una URL de endpoint junto con el subconjunto de tipos de eventos que deseas recibir.

Los webhooks de tu cuenta de partner reciben una distribución de eventos de todos los comercios vinculados a ella — no es necesaria ninguna configuración por subcuenta. El campo accountId del payload identifica al comercio.

Suscripción a eventos

Suscripciones de partner habituales:

Grupo	Eventos de interés
Ciclo de vida del comercio	account.pending, account.approved, account.rejected, account.activated, account.suspended, account.blocked, account.unblocked
Liquidaciones	settlement.completed, settlement.pending
Pagos (por comercio)	charge.succeeded, charge.failed, charge.refunded, charge.chargeback
Suscripciones (por comercio)	subscription.activated, subscription.canceled, subscription.past_due
Procesadores de pagos	payment_processor.created, payment_processor.updated, payment_processor.deleted
Facturación	account_invoice.paid, account_invoice.past_due

El catálogo completo está disponible en el selector de tipos de evento del panel al añadir o editar un webhook.

Payload

MONEI envía application/json con este envelope en cada evento:

Campo	Tipo	Descripción
id	string	ID del evento.
type	string	Tipo de evento (p. ej. charge.succeeded).
objectType	string	Uno de charge, subscription, account, account_invoice, settlement, payment_processor.
objectId	string	ID del objeto afectado.
accountId	string	Subcuenta del comercio a la que pertenece el evento. Úsalo para enrutar los eventos al comercio correcto en tu sistema.
livemode	boolean	true para eventos en producción, false para eventos de prueba. Hazlo coincidir con la clave de API que usas para verificar la firma.
createdAt	number	Timestamp del evento, en segundos Unix.
object	object	El objeto afectado. La estructura depende de objectType — consulta las pestañas a continuación.

charge

object es un pago — referencia completa de campos en Esquema de pago.

{
  "id": "evt_5fda0f3b7b2f4e0d…",
  "type": "charge.succeeded",
  "objectType": "charge",
  "objectId": "ch_8e2f…",
  "accountId": "<MERCHANT_SUB_ACCOUNT_ID>",
  "livemode": true,
  "createdAt": 1748390400,
  "object": {
    "id": "ch_8e2f…",
    "amount": 1099,
    "currency": "EUR",
    "status": "SUCCEEDED",
    "orderId": "ORDER-4421",
    "customer": {"email": "buyer@example.com"},
    "paymentMethod": {"method": "card", "card": {"brand": "VISA", "last4": "4242"}}
  }
}

subscription

object es una suscripción — referencia completa de campos en Esquema de suscripción.

{
  "id": "evt_…",
  "type": "subscription.activated",
  "objectType": "subscription",
  "objectId": "sub_…",
  "accountId": "<MERCHANT_SUB_ACCOUNT_ID>",
  "livemode": true,
  "createdAt": 1748390400,
  "object": {
    "id": "sub_…",
    "amount": 999,
    "currency": "EUR",
    "interval": "month",
    "intervalCount": 1,
    "status": "ACTIVE",
    "nextPaymentAt": 1751068800,
    "customer": {"email": "buyer@example.com"}
  }
}

account

object es la cuenta del comercio afectado. Se dispara con cada tipo de evento account.* y master_account.*.

Campo	Tipo	Descripción
id	string	ID de la subcuenta.
name	string	Nombre comercial.
status	string	PENDING_CONTRACT, PENDING_APPROVAL, APPROVED, ACTIVE, REJECTED, SUSPENDED, BLOCKED.
statusReason	string	Motivo legible por máquina del estado actual (cuando aplica).
statusNote	string	Nota en texto libre de MONEI Ops (cuando aplica).
test	boolean	true para la subcuenta gemela de prueba.
adminEmail	string	Email del administrador del comercio.
iban	string	IBAN de , ofuscado (solo los primeros 4 + los últimos 4 dígitos).
externalId	string	Identificador del comercio proporcionado por el partner (si usas el flujo de ID externo).
language	string	Código de idioma del panel.
billingPlan	string	Plan de facturación interno. MONEI_ONE en las cuentas nuevas; los antiguos MONEI_PLUS, MONEI_POS o MONEI_X en las anteriores (mira la nota siguiente).
blocked	boolean	true si MONEI ha bloqueado la cuenta.
churned	boolean	true si el comercio ha dado de baja el servicio.
churnReason / churnReasonOption / churnNote	string	Metadatos de baja (cuando churned: true).
contactPerson	object	{name, email, phone} del administrador del comercio.
business	object	{legalName, legalForm, email, phone, website, country, address, documentNumber, status, servicesDescription}.

info

billingPlan es un atributo de facturación interno, no forma parte del contrato de pagos. MONEI One es el plan único para cada comercio nuevo, por lo que las subcuentas nuevas devuelven MONEI_ONE. Los comercios dados de alta antes de su lanzamiento mantienen su plan original y siguen devolviendo MONEI_PLUS, MONEI_POS o MONEI_X. No condiciones tu integración a este campo.

{
  "id": "evt_…",
  "type": "account.approved",
  "objectType": "account",
  "objectId": "<MERCHANT_SUB_ACCOUNT_ID>",
  "accountId": "<MERCHANT_SUB_ACCOUNT_ID>",
  "livemode": true,
  "createdAt": 1748390400,
  "object": {
    "id": "<MERCHANT_SUB_ACCOUNT_ID>",
    "name": "ACME Shop",
    "status": "APPROVED",
    "test": false,
    "adminEmail": "owner@acme.com",
    "iban": "ES12********6789",
    "externalId": "merchant-7421",
    "language": "es",
    "billingPlan": "MONEI_ONE",
    "blocked": false,
    "business": {
      "legalName": "ACME COMERCIO SL",
      "documentNumber": "B12345678",
      "country": "ES",
      "website": "https://acme.com",
      "email": "info@acme.com",
      "status": "active"
    }
  }
}

account_invoice

object es la factura de MONEI del comercio por las tarifas de plataforma acumuladas. Se dispara con eventos account_invoice.*.

Campo	Tipo	Descripción
id	string	ID de la factura.
number	string	Número de factura legible impreso en el PDF.
accountId	string	Subcuenta a la que pertenece la factura.
status	string	PENDING, PAID, PAST_DUE, UNPAID.
period	object	{from, to} en segundos Unix que cubre el período de facturación.
currency	string	Código ISO 4217.
amount	number	Importe neto en unidades menores.
tax	number	Impuesto en unidades menores.
totalAmount	number	amount + tax, en unidades menores.
lineItems	array	Líneas de detalle por cobro: {name, quantity, unitType (money|percent), unitAmount, amount, currency}.
business	object	{legalName, documentNumber, iban (obfuscated), mandateSignatureTimestamp}.
createdAt	number	Timestamp de creación de la factura, en segundos Unix.

{
  "id": "evt_…",
  "type": "account_invoice.paid",
  "objectType": "account_invoice",
  "objectId": "inv_…",
  "accountId": "<MERCHANT_SUB_ACCOUNT_ID>",
  "livemode": true,
  "createdAt": 1748390400,
  "object": {
    "id": "inv_…",
    "number": "1/2026-14510",
    "accountId": "<MERCHANT_SUB_ACCOUNT_ID>",
    "status": "PAID",
    "period": {"from": 1773014400, "to": 1773619199},
    "currency": "EUR",
    "amount": 153,
    "tax": 0,
    "totalAmount": 153,
    "lineItems": [
      {
        "name": "Flat fee per Credit card transaction",
        "quantity": 1,
        "unitType": "money",
        "unitAmount": 24,
        "amount": 24,
        "currency": "EUR"
      },
      {
        "name": "MONEI daily platform usage fee",
        "quantity": 7,
        "unitType": "money",
        "unitAmount": 10,
        "amount": 70,
        "currency": "EUR"
      }
    ],
    "business": {
      "legalName": "ACME COMERCIO SL",
      "documentNumber": "B12345678",
      "iban": "ES93********0012"
    }
  }
}

payment_processor

object es un procesador de pagos del comercio, tal como el comercio lo ve en Configuración → Métodos de pago. Se dispara con payment_processor.created, payment_processor.updated y payment_processor.deleted.

Campo	Tipo	Descripción
id	string	ID del procesador de pagos, igual que objectId. monei:<paymentMethod> para MONEI, por ejemplo monei:card. Para un procesador con el que el comercio tiene contrato, el ID de ese procesador.
name	string	MONEI, o el nombre del banco del contrato cuando MONEI acepta el método de pago solo a través de ese banco. Para un procesador propio del comercio, el nombre que le dio el comercio o, si no tiene, una etiqueta con su marca y los datos de su cuenta.
paymentMethod	string	Método de pago que acepta el procesador, por ejemplo card o bizum.
status	string	ACTIVE, PENDING_ACTIVATION, UNAVAILABLE o DISABLED. Consulta la tabla siguiente.
previousStatus	string	El estado antes del cambio. Solo se envía en payment_processor.updated, y solo cuando el estado cambió.
test	boolean	true para un procesador de una subcuenta de prueba. Siempre es lo contrario de livemode.

Estado	Significado
ACTIVE	Acepta pagos.
PENDING_ACTIVATION	MONEI aún no ha terminado de configurarlo. Solo en procesadores de MONEI.
UNAVAILABLE	No puede aceptar pagos por un motivo que su interruptor de activación no controla: MONEI no puede aceptar el método de pago para la cuenta, o al procesador le faltan credenciales obligatorias.
DISABLED	Está desactivado. Para MONEI, el comercio desactivó MONEI para el método de pago.

• payment_processor.created: aparece un procesador. El comercio añade uno, o MONEI empieza a aceptar un método de pago para la cuenta.
• payment_processor.updated: cambia el name, el status o el paymentMethod de un procesador.
• payment_processor.deleted: desaparece un procesador. El comercio lo elimina, o MONEI deja de aceptar el método de pago para la cuenta. object contiene su último estado.

Un cambio que el comercio no puede ver no envía ningún evento, por ejemplo un cambio de credenciales que deja el estado igual.

Sigue estas reglas:

• Un método de pago se puede usar cuando uno de sus procesadores está ACTIVE. Un método de pago puede tener más de un procesador. Guarda el estado por accountId e id de procesador, no solo el último evento del método de pago. El id de un procesador de MONEI (monei:<method>) es el mismo en todas las cuentas.
• Elimina los duplicados por el id del evento. MONEI puede enviar el mismo evento más de una vez. Cada copia tiene el mismo id.
• No dependas del orden de los eventos. MONEI no garantiza el orden de entrega. createdAt es el momento en el que MONEI registró el cambio, en segundos. Los reintentos lo conservan, y dos eventos pueden tener el mismo createdAt. La hora de envío es t en la cabecera MONEI-Signature. Cuando dos eventos de un procesador no coinciden, concilia.
• Concilia con la consulta paymentProcessors de la API GraphQL. Envía el ID de cuenta del comercio en la cabecera MONEI-Account-ID. La consulta devuelve los procesadores actuales de esa cuenta. Úsala cuando empieces a usar estos eventos, cuando creas que has perdido un evento y cuando dos eventos no coinciden. No lista los procesadores eliminados. Cada cuenta tiene un solo modo (producción o prueba). Llama a la consulta con el accountId del evento y la clave de API de partner (producción o prueba) que coincida con livemode.

{
  "id": "9b2e6f…",
  "type": "payment_processor.updated",
  "objectType": "payment_processor",
  "objectId": "monei:bizum",
  "accountId": "<MERCHANT_SUB_ACCOUNT_ID>",
  "livemode": true,
  "createdAt": 1748390400,
  "object": {
    "id": "monei:bizum",
    "name": "MONEI",
    "paymentMethod": "bizum",
    "status": "DISABLED",
    "test": false,
    "previousStatus": "ACTIVE"
  }
}

Verificación de la firma

Cada solicitud incluye una cabecera MONEI-Signature con el formato t=<unix-seconds>,v1=<hex>. Calcula HMAC-SHA256("<t>.<rawBody>", <PARTNER_API_KEY>) y compáralo con v1. Usa la misma clave de API de partner (producción o prueba) que coincida con el livemode del evento. Guía completa: Verificar firma.

Entrega y reintentos

• Responde con 2xx para confirmar la recepción. Cualquier otro código (incluido 3xx) se trata como un fallo.
• MONEI reintenta las entregas fallidas con retroceso exponencial durante varios días y luego abandona.
• User-Agent: MONEI/1.0 identifica nuestras solicitudes.

nota

El accountCallbackUrl heredado configurado durante la incorporación del partner sigue funcionando — se dispara únicamente con account.pending, account.approved y account.rejected con un payload limitado — pero está siendo eliminado progresivamente. Las nuevas integraciones deben usar la configuración de webhooks del Partner Dashboard.

Gestiona tu cuenta de partner

Toda la gestión de la cuenta de partner es de autoservicio en el Partner Dashboard.

Usuarios autorizados

Invita a miembros adicionales de tu equipo en partners.monei.com/settings/users → Invitar a un usuario. Proporciona su email y nombre, y dales un rol o permisos individuales — recibirán una invitación por email. Todos los usuarios de partner deben verificar un número de teléfono para la autenticación en dos pasos por SMS. Consulta Tu equipo.

Seguridad

partners.monei.com/settings/security — tres controles independientes:

• IPs permitidas — cada llamada a la API contra tu clave de API de partner debe originarse desde una de estas IPs. Actúa como segunda línea de defensa si una clave se filtra: una clave robada desde fuera de tu infraestructura queda inutilizable.
• Dominios permitidos — restringe qué dominios pueden cargar la página de pago alojada para los comercios vinculados a tu cuenta. Evita que el checkout de tus comercios sea integrado por sitios no relacionados.
• Requerir ID externo — cuando está habilitado, cada comercio que se registre a través de tu enlace de registro debe llevar un válido mid + h (consulta Enlace de registro). Úsalo si solo quieres registros que se originen desde tu propio flujo de incorporación, nunca visitas directas al enlace.

Marca

partners.monei.com/settings/branding — sube tu logotipo. En la página de registro del comercio abierta desde tu enlace de registro, tu logotipo aparece junto a el de MONEI (separados por un +), señalando la asociación de co-branding. Úsalo para que los comercios reconozcan tu plataforma como el origen de la oferta de pagos en lugar de llegar a un registro de MONEI sin marca.

Notificaciones por email

partners.monei.com/settings/emails — añade listas de destinatarios adicionales para los emails operativos que MONEI envía sobre tu cuenta de partner:

• Emails de webhook — destinatarios alertados cuando la entrega de webhooks a tu endpoint comienza a fallar. Enrútalo a tu buzón de operaciones o guardia para que puedas reparar un endpoint roto antes de acumular eventos perdidos.
• Emails de baja — destinatarios alertados cuando un comercio vinculado a ti da de baja el servicio. Enrútalo a tu equipo de gestión de cuentas o finanzas para que puedan hacer seguimiento sin tener que consultar la API.