Inicio rápido de la API

Elegir un equipo y una clave API

Crea una clave API de MakePay desde el portal de MakeCrypto o desde la pestaña de pruebas API cuando hayas iniciado sesión. La pestaña de pruebas API carga tus equipos, filtra claves API de MakePay, abre el modal de creación de claves cuando el equipo seleccionado todavía no tiene una clave MakePay y puede enviar solicitudes autenticadas con el ID y el secreto de la clave seleccionada.

URL base

Todas las rutas de la API partner de MakeCrypto están versionadas bajo el origen de producción.

https://www.makecrypto.io/api/partner/v1

Para desarrollo local, usa tu origen local de MakeCrypto con la misma estructura de rutas.

Autenticación

Las integraciones de servidor deben enviar un ID de clave API de MakePay y un secreto API en cada solicitud. El secreto se devuelve solo cuando se crea la clave API, así que guárdalo en un gestor de secretos del lado servidor y nunca lo envíes a navegadores de clientes.

Primera solicitud de lectura

Empieza con una solicitud de lectura antes de crear enlaces de pago reales. Una respuesta correcta confirma que el ID de clave, el secreto, el scope de producto MakePay y la empresa propietaria de la clave son válidos.

curl "https://www.makecrypto.io/api/partner/v1/makepay/payment-links" \
  -H "x-makecrypto-key-id: MAKEPAY_API_KEY_ID" \
  -H "x-makecrypto-key-secret: MAKEPAY_API_SECRET" \
  -H "Accept: application/json"

Primera solicitud de creación

Crea enlaces de pago desde tu servidor cuando un pedido, una factura o una sesión de checkout esté lista para pagar.

curl -X POST "https://www.makecrypto.io/api/partner/v1/makepay/payment-links" \
  -H "x-makecrypto-key-id: MAKEPAY_API_KEY_ID" \
  -H "x-makecrypto-key-secret: MAKEPAY_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
  "status": "active",
  "sendPaymentRequestEmail": false,
  "payload": {
    "title": "Website order #1042",
    "description": "Checkout for order #1042",
    "amount": "129.99",
    "fiatCurrency": "USD",
    "currency": "USDT",
    "orderId": "order_1042",
    "customerEmail": "buyer@example.com",
    "returnUrl": "https://merchant.example/orders/1042",
    "successUrl": "https://merchant.example/orders/1042/success",
    "failureUrl": "https://merchant.example/orders/1042/failure",
    "expirationTime": "12h",
    "metadata": {
      "cartId": "cart_7M2V",
      "source": "api"
    }
  }
}'

Lista operativa de comprobación

• Crea la clave API con el producto makepay.
• Configura el activo de destino predeterminado de la empresa antes de crear enlaces.
• Guarda el secreto API fuera del control de código fuente y de bundles frontend.
• Trata los UIDs de enlaces de pago como identificadores públicos, pero conserva IDs internos de pedido en payload.orderId o payload.metadata.
• Escucha webhooks o consulta el estado del enlace/sesión desde el portal hasta que tu flujo de webhook backend esté activo.