WEBHOOK

Webhook de Transferencias

Magic Pay envía un POST a tu URL de webhook cuando una transferencia que tú iniciaste cambia de estado (paid, returned o failed). Configura la URL en admin.magicpay.mx.

Ejemplo de Payload

JSON

{
  "token": "tu_webhook_token",
  "id": "abc123def456",
  "transferId": "PAY20240115001",
  "trackingId": "PAY20240115001",
  "status": "paid",
  "failureReason": null,
  "account": "012180015025354012",
  "bank": "BBVA MEXICO"
}

Campos del payload

Campo	Tipo	Descripción
token	string	Token de autenticación configurado en tu dashboard
id	string	ID interno de Magic Pay
transferId	string	Tu ID de transferencia
trackingId	string	Clave de rastreo SPEI
status	string	paid \| returned \| failed
failureReason	string \| null	Razón del fallo o devolución
account	string	Cuenta destino
bank	string	Banco destino

Tu servidor debe responder con HTTP 200. Si no responde correctamente, Magic Pay reintentará la notificación.