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

HeaderValor
Content-Typeapplication/json
x-parse-application-idYOUR_APP_ID
x-parse-rest-api-keyYOUR_REST_KEY

Parámetros

NombreTipoRequeridoDescripción
apiKeystringTu API key de merchant.
metadataobjectNoObjeto 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 -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"
  }
}'

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.