MakeCrypto

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étodoRuta
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

Clave API de MakePay

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

Clave API de MakePay o público

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/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

Clave API de MakePay

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

Clave API de MakePay

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

Clave API de MakePay

Uso

Enviar solicitud de pago

Envía o reenvía el enlace alojado al email del cliente.

GET/api/partner/v1/makepay/subscriptions

Auth

Clave API de MakePay

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

Clave API de MakePay

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

Clave API de MakePay

Uso

Listar o actualizar clientes

Devuelve perfiles de clientes MakePay o crea/actualiza clientes por email.

POST/api/partner/v1/makepay/customers

Auth

Clave API de MakePay

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

Clave API de MakePay

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

Clave API de MakePay

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

Clave API de MakePay

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

Clave API de MakePay

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

Clave API de MakePay

Uso

Listar entregas de webhook

Consulta intentos de entrega de webhooks de pago y suscripción, junto con su estado de reintento.

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",
    "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"
    }
  }
}

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,
  "paymentRequestEmailSent": false,
  "paymentRequestEmailError": null,
  "paymentLink": {
    "id": "8d15bb78-d0f8-45ef-88d7-2a1f1f79644b",
    "uid": "01hzy4k6p4w9y2x7e2z7n8a2xm",
    "status": "active",
    "expires_at": "2026-04-19T12:00:00.000Z",
    "created_at": "2026-04-19T00:00:00.000Z",
    "updated_at": "2026-04-19T00:00:00.000Z",
    "publicUrl": "https://makepay.io/payment/01hzy4k6p4w9y2x7e2z7n8a2xm",
    "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"
      },
      "asset": "ETH.USDT-0xdac17f958d2ee523a2206206994597c13d831ec7",
      "runtimeMode": "merchant_target_net_v2",
      "billingVersion": "v2",
      "merchantName": "Merchant Co",
      "merchantPaymentLinkTheme": "system"
    }
  }
}

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 "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.

¿Necesitas ayuda con la configuración de partner?

Abre la vista de detalles del enlace de pago en MakeCrypto para copiar los snippets generados para un UID de pago real, o vuelve al portal para gestionar la configuración del merchant.

Abrir portal