WEBHOOK

Webhook de Pagos Recibidos

Se envía un POST a tu servidor cuando recibes un pago SPEI en alguna de tus CLABEs. Incluye los datos completos del pagador y el metadata configurado en `newReceiverAccount`.

Ejemplo de Payload

JSON

{
  "token": "tu_webhook_token",
  "id": "xyz789abc012",
  "amount": 5000,
  "payerAccount": "072180012345678901",
  "bank": "BANORTE",
  "payerName": "EMPRESA SA DE CV",
  "payerRFC": "ESA210101AAA",
  "receiverAccount": "646180202710010018",
  "description": "PAGO FACTURA 001",
  "tracking": "MXBANORTE20240115123456",
  "numReference": "1234567",
  "metadata": {
    "clientId": "CLI-001",
    "orderId": "ORD-2024-001"
  }
}

Campos del payload

Campo	Tipo	Descripción
token	string	Token de autenticación configurado en tu dashboard
id	string	ID interno de Magic Pay
amount	number	Monto recibido en MXN
payerAccount	string	CLABE del pagador
bank	string	Banco del pagador
payerName	string	Nombre del pagador
payerRFC	string	RFC del pagador
receiverAccount	string	Tu CLABE donde se recibió el pago
description	string	Concepto de pago
tracking	string	Clave de rastreo SPEI
numReference	string	Referencia numérica
metadata	object \| null	Metadata asociado a la CLABE receptora

Responde con HTTP 200 para confirmar la recepción. Magic Pay reintentará en caso de fallo.