Asignar pagos a tiendas y puntos de venta

Adjunta un storeId y/o un pointOfSaleId a los pagos que creas a través de la API para agrupar las transacciones por tienda y punto de venta — para informes, analítica y control de acceso de usuarios. Como un punto de venta pertenece a una tienda, adjuntar un pointOfSaleId también asocia el pago a esa tienda.

Encuentra cada ID en el dashboard. Abre Configuración → Tiendas para leer el storeId de una tienda:

Página Tiendas en los ajustes del panel de MONEI, con las tiendas de tu cuenta

Abre Configuración → Puntos de venta para leer el pointOfSaleId de un punto de venta:

Página Puntos de venta en los ajustes del panel de MONEI, con los puntos de venta de tu cuenta

Solo necesitas indicarlos al crear el pago; las operaciones posteriores como la confirmación, la captura o el reembolso heredan la asociación por defecto.

La asignación de pagos con storeId o pointOfSaleId no está disponible en las integraciones estándar con plataformas de e-commerce como Shopify, PrestaShop, Wix y WooCommerce. Esta opción solo se aplica en implementaciones a medida.

Error común: usuarios restringidos y visibilidad de pagos

Cuando vinculas un usuario autorizado a una tienda o punto de venta, ese usuario solo ve los pagos etiquetados con ese storeId o pointOfSaleId. Cualquier pago creado sin el ID correspondiente es invisible para ese usuario en el dashboard. Si usas usuarios restringidos, asegúrate de que cada pago lleva el storeId/pointOfSaleId correcto: pásalo en la API o deja que el usuario cree el pago en el dashboard o MONEI Pay (que hereda su asignación automáticamente).

Crear un pago con storeId o pointOfSaleId

cURL

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

curl --request POST 'https://api.monei.com/v1/payments' \
--header 'Authorization: pk_test_3c140607778e1217f56ccb8b50540e00' \
--header 'Content-Type: application/json' \
--data-raw '{
    "amount": 110,
    "currency": "EUR",
    "orderId": "14379133960355",
    "description": "Test Store - #14379133960355",
    "storeId": "e5f28150d9e8974c58ab5ec9c4a880f8734dcf05",
    "pointOfSaleId": "5e3f3fa8b9585e908e1b51d2c7914e61e7403078"
}'

Node.js

server.js

const {Monei, PaymentTransactionType} = require('@monei-js/node-sdk');
const monei = new Monei('pk_test_36cf3e8a15eff3f5be983562ea6b13ec');
monei.payments.create({
  amount: 110,
  currency: 'EUR',
  orderId: '14379133960355',
  description: 'Test Store - #14379133960355',
  storeId: 'e5f28150d9e8974c58ab5ec9c4a880f8734dcf05',
  pointOfSaleId: '5e3f3fa8b9585e908e1b51d2c7914e61e7403078'
});

PHP

server.php

$monei = new Monei\MoneiClient('pk_test_36cf3e8a15eff3f5be983562ea6b13ec');
$monei->payments->create(new Monei\Model\CreatePaymentRequest([
  'amount' => 110,
  'currency' => 'EUR',
  'order_id' => '14379133960355',
  'description' => 'Test Store - #14379133960355',
  'store_id' => 'e5f28150d9e8974c58ab5ec9c4a880f8734dcf05',
  'point_of_sale_id' => '5e3f3fa8b9585e908e1b51d2c7914e61e7403078'
]));

Los siguientes parámetros son obligatorios:

• amount positive integer - Importe que se pretende cobrar con este pago. Un entero positivo que representa cuánto cobrar en la (p. ej., 100 céntimos para cobrar 1,00 USD)
• currency string - Código de moneda ISO de tres letras, en mayúsculas. Debe ser una moneda compatible.
• orderId string - Un ID de pedido de tu sistema. Un identificador único que sirve para el pago con tu sistema interno.
• storeId string - Identificador único de la tienda. Si se especifica, el pago se asocia a esa tienda.
• pointOfSaleId string - Identificador único del punto de venta. Si se especifica, el pago se asocia a ese punto de venta (y a su tienda).

Ambos son opcionales: pasa uno, los dos o ninguno. Consulta todos los parámetros de la solicitud disponibles.

Prioridad de la URL de notificación del punto de venta

Un punto de venta de tipo QR puede definir una URL de notificación por defecto en su configuración de pagos. Cuando un pago se crea con el pointOfSaleId de ese punto de venta y no pasas un callbackUrl, MONEI notifica a la URL del punto de venta cuando el pago se completa. Si sí pasas un callbackUrl al crear el pago, tu valor tiene prioridad y el valor por defecto del punto de venta no se aplica. Trata la notificación como cualquier callback de pago: verifica la firma MONEI-Signature y responde 200 OK (consulta recibir eventos webhook).

Configuración de tiendas y puntos de venta

La creación de tiendas y puntos de venta, la configuración de pagos (importes fijos, datos requeridos del cliente, emails con QR de pedido), los códigos QR y enlaces de pago permanentes, y la por tienda en IBAN propio se gestionan desde el dashboard — consulta tiendas y puntos de venta.