POST

newReceiverAccount

Crea una CLABE única (banco STP, prefijo 646) asociada a tu merchant para identificar pagos entrantes. Todos los pagos SPEI recibidos en esa CLABE disparan tu webhook con el metadata asociado.

Endpoint

POSThttps://magicpay.b4a.io/functions/newReceiverAccount

Headers

Header	Valor
Content-Type	application/json
x-parse-application-id	YOUR_APP_ID
x-parse-rest-api-key	YOUR_REST_KEY

Parámetros

Nombre	Tipo	Requerido	Descripción
apiKey	string	Sí	Tu API key de merchant.
metadata	object	No	Objeto JSON con datos arbitrarios que se asociarán a la CLABE. Se reenvían en el webhook de pago. Útil para asociar un cliente, orden, etc.

Ejemplo de Request

cURL

curl -X POST 'https://magicpay.b4a.io/functions/newReceiverAccount' \
  -H 'Content-Type: application/json' \
  -H 'x-parse-application-id: YOUR_APP_ID' \
  -H 'x-parse-rest-api-key: YOUR_REST_KEY' \
  -d '{
  "apiKey": "pk_live_xxxxxxxxxxxxx",
  "metadata": {
    "clientId": "CLI-001",
    "orderId": "ORD-2024-001"
  }
}'

JavaScript

const response = await fetch('https://magicpay.b4a.io/functions/newReceiverAccount', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-parse-application-id': 'YOUR_APP_ID',
    'x-parse-rest-api-key': 'YOUR_REST_KEY',
  },
  body: JSON.stringify({
      "apiKey": "pk_live_xxxxxxxxxxxxx",
      "metadata": {
          "clientId": "CLI-001",
          "orderId": "ORD-2024-001"
      }
  }),
});

const data = await response.json();
console.log(data);

Ejemplo de Respuesta

JSON

{
  "result": {
    "clabe": "646180202710010018",
    "bank": "STP",
    "metadata": {
      "clientId": "CLI-001",
      "orderId": "ORD-2024-001"
    }
  }
}

La CLABE generada es permanente y única. Todos los pagos SPEI recibidos en esa CLABE se notifican a tu webhook con el metadata asociado.