Referencia API

API de enlaces de pago

Crea, lista, inspecciona, pausa, archiva y envía enlaces de pago de MakePay.

Rutas

Usa estas rutas para crear y gestionar enlaces de pago alojados de MakePay desde MakeCrypto.

Método	Ruta
GET	`/api/partner/v1/companies`
Auth Sesión Uso Listar empresas del usuario Devuelve los equipos disponibles para las herramientas del portal del usuario MakeCrypto autenticado.
POST	`/api/partner/v1/onboarding/company`
Auth Secreto de onboarding de partner Uso Crear enlace de onboarding de empresa Crea un borrador de onboarding prellenado por el partner y devuelve una URL de reclamo para el merchant.
GET	`/api/partner/v1/makepay/payment-links`
Auth MakePay API key or OAuth Uso Listar o crear enlaces de pago Lee los enlaces de pago de la empresa de la clave API o crea enlaces de checkout alojado MakePay.
POST	`/api/partner/v1/makepay/payment-links`
Auth MakePay API key, OAuth, or public Uso Listar o crear enlaces de pago Lee los enlaces de pago de la empresa de la clave API o crea enlaces de checkout alojado MakePay.
POST	`https://www.makepay.io/api/public/anonymous-payment-links`
Auth Público Uso Create anonymous payment link Public MakePay endpoint for one-time anonymous checkout links with explicit settlement priorities, branding, and optional webhooks.
POST	`/gateway/pay/{makepayKeyId}`
Auth Clave pública de formulario Uso Enviar formulario HTML de pago Recibe campos de formulario del navegador, crea un enlace de pago alojado y redirige al comprador al checkout.
GET	`/api/partner/v1/makepay/payment-links/{uid}`
Auth MakePay API key or OAuth Uso Obtener o actualizar enlace de pago Lee el detalle de un enlace de pago o cambia su estado a active, paused o archived.
PATCH	`/api/partner/v1/makepay/payment-links/{uid}`
Auth MakePay API key or OAuth Uso Obtener o actualizar enlace de pago Lee el detalle de un enlace de pago o cambia su estado a active, paused o archived.
POST	`/api/partner/v1/makepay/payment-links/{uid}/send-request-email`
Auth MakePay API key or OAuth Uso Enviar solicitud de pago Envía o reenvía el enlace alojado al email del cliente.
GET	`/api/partner/v1/makepay/subscriptions`
Auth MakePay API key or OAuth Uso Listar o crear suscripciones Devuelve planes de suscripción recurrente de MakePay o crea una suscripción y la primera factura.
POST	`/api/partner/v1/makepay/subscriptions`
Auth MakePay API key or OAuth Uso Listar o crear suscripciones Devuelve planes de suscripción recurrente de MakePay o crea una suscripción y la primera factura.
GET	`/api/partner/v1/makepay/customers`
Auth MakePay API key or OAuth Uso Listar o actualizar clientes Devuelve perfiles de clientes MakePay o crea/actualiza clientes por email.
POST	`/api/partner/v1/makepay/customers`
Auth MakePay API key or OAuth Uso Listar o actualizar clientes Devuelve perfiles de clientes MakePay o crea/actualiza clientes por email.
POST	`/api/partner/v1/makepay/customers/{customerId}/portal`
Auth MakePay API key or OAuth Uso Crear enlace del portal de cliente Genera bajo demanda una URL firmada del portal de cliente MakePay válida por 24 horas.
GET	`/api/partner/v1/timezones`
Auth Público Uso Listar zonas horarias Devuelve identificadores de zona horaria IANA soportados.
GET	`/api/partner/v1/makepay/settings`
Auth MakePay API key or OAuth Uso Leer o actualizar configuración de MakePay Lee o actualiza liquidación, redirecciones, comisiones y manejo de pagos incompletos.
PUT	`/api/partner/v1/makepay/settings`
Auth MakePay API key or OAuth Uso Leer o actualizar configuración de MakePay Lee o actualiza liquidación, redirecciones, comisiones y manejo de pagos incompletos.
GET	`/api/partner/v1/makepay/destination-assets`
Auth MakePay API key or OAuth Uso Listar activos de destino Devuelve los activos de liquidación soportados y el activo predeterminado actual.
GET	`/api/partner/v1/makepay/webhook-requests`
Auth MakePay API key or OAuth Uso Listar entregas de webhook Consulta intentos de entrega de webhooks de pago y suscripción, junto con su estado de reintento.
GET	`/api/partner/v1/makepay/webhook-subscriptions/current`
Auth grant-bound OAuth Uso Read current webhook subscription Read the webhook subscription owned by the current OAuth grant without revealing its signing secret.
PUT	`/api/partner/v1/makepay/webhook-subscriptions/current`
Auth grant-bound OAuth Uso Create or update webhook subscription Create, reactivate, update, or explicitly rotate the current OAuth grant's MakePay payment webhook subscription.
DELETE	`/api/partner/v1/makepay/webhook-subscriptions/current`
Auth grant-bound OAuth Uso Disable current webhook subscription Disable the current OAuth grant's webhook subscription and erase its stored signing secret.

Crear un enlace de pago

La ruta de creación inserta un enlace de pago MakePay, resuelve la marca del merchant y los valores predeterminados de liquidación, inyecta campos de facturación en runtime y devuelve la URL pública de checkout.

POST /api/partner/v1/makepay/payment-links

json

{
  "status": "active",
  "sendPaymentRequestEmail": false,
  "payload": {
    "title": "Website order #1042",
    "description": "Checkout for order #1042",
    "amount": "129.99",
    "fiatCurrency": "USD",
    "currency": "USDT",
    "feePaidBy": "merchant",
    "skipQuoteAcceptance": true,
    "lineItems": [
      {
        "id": "plan",
        "name": "Starter package",
        "unitAmount": "119.99",
        "quantity": 1
      }
    ],
    "extraCharges": [
      {
        "id": "shipping",
        "name": "Shipping",
        "kind": "shipping",
        "unitAmount": "10.00",
        "quantity": 1
      }
    ],
    "optionalItems": [
      {
        "id": "priority_setup",
        "name": "Priority setup",
        "unitAmount": "19.99",
        "quantity": 1,
        "adjustableQuantity": {
          "enabled": true,
          "minimum": 1,
          "maximum": 3
        }
      }
    ],
    "orderId": "order_1042",
    "customerEmail": "buyer@example.com",
    "invoicePdfUrl": "https://merchant.example/invoices/1042.pdf",
    "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"
    }
  }
}

Para un botón de checkout de navegador sin código o low-code, consulta Pago por envío de formulario. Acepta un POST HTML simple, crea el mismo tipo de enlace de pago alojado y redirige al comprador al checkout de MakePay.

Configuración requerida

La empresa debe tener un activo de destino MakePay predeterminado. Si la liquidación no está configurada, la ruta devuelve 409 con errorCode: "onboarding_required".

Campos de importe y activo

Usa payload.amount para el importe visible al cliente. Envía payload.asset para un activo de destino exacto o payload.currency cuando el activo predeterminado de la empresa pueda resolver la cadena. Si una moneda está habilitada en varias cadenas y no existe un predeterminado coincidente en la empresa, envía payload.asset explícitamente.

Expiración

payload.expirationTime acepta 15m, 1h, 12h, 24h, 72h o never. La API guarda el timestamp expires_at resuelto en el enlace de pago.

Respuesta de creación

json

{
  "ok": true,
  "companyId": "8d15bb78-d0f8-45ef-88d7-2a1f1f79644b",
  "paymentRequestEmailSent": false,
  "paymentRequestEmailError": null,
  "paymentLink": {
    "id": "3a85f64-5717-4562-b3fc-2c963f66afa6",
    "uid": "01hzy4k6p4w9y2x7e2z7n8a2xm",
    "donation_slug": null,
    "link_type": "one_time",
    "source": "api",
    "status": "active",
    "amount": "129.99",
    "fiatAmount": "129.99",
    "fiatCurrency": "USD",
    "currency": "USDT",
    "asset": "ETH.USDT-0xdac17f958d2ee523a2206206994597c13d831ec7",
    "title": "Website order #1042",
    "label": "Website order #1042",
    "description": "Checkout for order #1042",
    "orderId": "order_1042",
    "customerEmail": "buyer@example.com",
    "clientId": null,
    "metadata": {
      "source": "api"
    },
    "payload": {
      "title": "Website order #1042",
      "description": "Checkout for order #1042",
      "amount": "129.99",
      "fiatCurrency": "USD",
      "currency": "USDT",
      "asset": "ETH.USDT-0xdac17f958d2ee523a2206206994597c13d831ec7",
      "runtimeMode": "merchant_target_net_v2",
      "billingVersion": "v2",
      "merchantName": "Merchant Co",
      "merchantPaymentLinkTheme": "system",
      "customerEmail": "buyer@example.com",
      "orderId": "order_1042",
      "skipQuoteAcceptance": true,
      "metadata": {
        "source": "api"
      }
    },
    "latestSession": null,
    "timelineEvents": [],
    "publicUrl": "https://makepay.io/payment/01hzy4k6p4w9y2x7e2z7n8a2xm",
    "created_at": "2026-04-19T00:00:00.000Z",
    "updated_at": "2026-04-19T00:00:00.000Z",
    "expires_at": "2026-04-19T12:00:00.000Z",
    "dashboardUrl": "https://www.makecrypto.io/home/makepay/payment-links?orderUid=01hzy4k6p4w9y2x7e2z7n8a2xm"
  }
}

Listar enlaces de pago

Usa la ruta de listado para conciliación back-office, dashboards y pruebas de humo.

curl

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"

Obtener detalle del enlace de pago

Usa la ruta de detalle cuando ya tienes un UID de enlace de pago y necesitas el enlace normalizado, la URL pública de checkout, la última sesión de pago y eventos de timeline.

curl

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

Pausar o archivar un enlace de pago

Usa la ruta de estado para impedir que un enlace pueda pagarse o para ocultarlo de operaciones activas.

curl

curl -X PATCH "https://www.makecrypto.io/api/partner/v1/makepay/payment-links/PAYMENT_LINK_UID" \
  -H "x-makecrypto-key-id: MAKEPAY_API_KEY_ID" \
  -H "x-makecrypto-key-secret: MAKEPAY_API_SECRET" \
  -H "Idempotency-Key: order_1042_update_v1" \
  -H "Content-Type: application/json" \
  -d '{"status":"paused"}'

status debe ser active, paused o archived.

Enviar un email de solicitud de pago

MakeCrypto puede enviar el enlace alojado directamente al email del cliente del payload del enlace de pago, o a un email alternativo en el cuerpo de la solicitud.

curl

curl -X POST "https://www.makecrypto.io/api/partner/v1/makepay/payment-links/PAYMENT_LINK_UID/send-request-email" \
  -H "x-makecrypto-key-id: MAKEPAY_API_KEY_ID" \
  -H "x-makecrypto-key-secret: MAKEPAY_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"email":"buyer@example.com"}'

Solo se pueden enviar por email enlaces de pago activos. Los enlaces completados no pueden reenviarse.