API de Magic Pay
Integra transferencias SPEI en tu aplicación en minutos. Envía y recibe pagos programáticamente con una API REST simple y confiable. Todos los endpoints son POST a https://magicpay.b4a.io/functions.
Inicio Rápido
Obtén tus credenciales
Regístrate en admin.magicpay.mx para recibir tu apiKey, application-id y rest-api-key.
Autentícate
Los headers x-parse-application-id y x-parse-rest-api-key se envían en cada request. Tu apiKey de merchant va en el body del request.
Abona saldo
Consulta tu CLABE maestra con getMerchantInfo y transfiere fondos desde tu banco para empezar a dispersar.
Envía y recibe SPEIs
Usa speiTransfer para enviar y newReceiverAccount para generar CLABEs receptoras. Configura webhooks para recibir notificaciones en tiempo real.
Autenticación
Todas las peticiones a la API son POST y deben incluir los siguientes headers:
| Header | Descripción |
|---|---|
| Content-Type | Siempre application/json |
| x-parse-application-id | Tu Application ID proporcionado por Magic Pay |
| x-parse-rest-api-key | Tu REST API Key proporcionado por Magic Pay |
Además de los headers, tu apiKey de merchant viaja en el body de cada request como un parámetro más.
Base URL
https://magicpay.b4a.io/functionsFormato de respuesta
Todas las respuestas siguen el formato de Parse Cloud. En caso de éxito, los datos vienen dentro del campo result. En caso de error, la respuesta incluye code y error.
{
"result": { ...data... }
}{
"code": 141,
"error": "Mensaje de error"
}Notas técnicas
- Todos los montos están en MXN (Pesos Mexicanos).
- Los timestamps (
createdAt) son milisegundos desde epoch (Unix time × 1000). - Las fechas en filtros (
before/after) aceptan formato"YYYYMMDD"o timestamp en milisegundos. - La comisión se calcula como
transferFee × 1.16(incluye 16% IVA). - Las CLABEs generadas por newReceiverAccount usan el banco STP (prefijo
646). - El catálogo de bancos se sincroniza con el oficial de Banxico. Cuando la cuenta destino es una CLABE de 18 dígitos, el banco se detecta automáticamente por el prefijo.