INTEGRACIONES
API de pagos en cripto. Un endpoint para cobrar en cripto.
Crea enlaces de pago, recibe eventos de webhook y liquida fondos a cualquier dirección de billetera con una sola REST API. Funciona con cualquier lenguaje o framework. Los primeros 30 pagos gratis.
LO QUE OBTIENES
Hecho para comercios que quieren simplicidad.
REST API
REST API estándar en JSON. Crea pagos, consulta el estado y gestiona tu cuenta de forma programática desde cualquier lenguaje o framework.
Webhooks
Recibe notificaciones de eventos en tiempo real cuando los pagos se confirman, se completan o fallan. Lógica de reintentos configurable para entregas perdidas.
Múltiples modos de tarifa
Elige cómo se manejan las tarifas por pago: descontar del Gas Tank, descontar del monto del pago o trasladar las tarifas al pagador.
Soporte para smart contracts
Integración nativa de smart contracts para flujos de pago on-chain. Documentación completa de la arquitectura técnica disponible.
CÓMO FUNCIONA
Tres pasos hasta tu primer pago.
- 1
Obtén tu clave de API
Crea una cuenta gratuita en app.makapay.io y genera una clave de API desde tu panel, en Claves de API.
- 2
Crea un pago
Haz un POST a /api/payments con la dirección de tu billetera de comercio, la red, el token, el monto y el ID del pedido. Recibe un enlace de pago y un código QR en la respuesta.
- 3
Recibe eventos de webhook
Configura una URL de webhook para recibir eventos payment.completed. Tu sistema se actualiza automáticamente cuando los fondos se confirman on-chain.
Empieza a construir
De cero a tu primer pago en una sola petición
Crea un enlace de pago, recibe una URL y un webhook en cuanto los fondos se liquidan on-chain. Funciona con cualquier lenguaje o framework.
Crear un pago
curl -X POST https://app.makapay.io/api/payments \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"merchant": "0x742d35Cc6634C0532925a3b844Bc9e7595f8fE00",
"chainId": "137",
"token": "0xc2132D05D31c914a87C6611C10748AEb04B58e8F",
"amount": "100.00",
"orderId": "order-12345",
"description": "Premium subscription"
}'const res = await fetch("https://app.makapay.io/api/payments", {
method: "POST",
headers: {
"x-api-key": process.env.MAKAPAY_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
merchant: "0x742d35Cc6634C0532925a3b844Bc9e7595f8fE00",
chainId: "137", // Polygon
token: "0xc2132D05D31c914a87C6611C10748AEb04B58e8F", // USDT
amount: "100.00",
orderId: "order-12345",
description: "Premium subscription",
}),
});
const { url } = await res.json();
// Redirect your customer to `url` to complete paymentimport requests
res = requests.post(
"https://app.makapay.io/api/payments",
headers={"x-api-key": "YOUR_API_KEY"},
json={
"merchant": "0x742d35Cc6634C0532925a3b844Bc9e7595f8fE00",
"chainId": "137", # Polygon
"token": "0xc2132D05D31c914a87C6611C10748AEb04B58e8F", # USDT
"amount": "100.00",
"orderId": "order-12345",
"description": "Premium subscription",
},
)
url = res.json()["url"]
# Redirect your customer to `url` to complete paymentRespuesta
Obtienes una URL de pago alojada. Redirige a tu cliente allí o muéstrala como código QR.
{
"url": "https://app.makapay.io/pay/01234567-89ab-cdef-0123-456789abcdef"
}Gestionar el webhook
Apunta una URL de webhook a tu servidor y MakaPay enviará un evento payment.completed en cuanto el pago se liquide.
{
"event": "payment.completed",
"paymentId": "01234567-89ab-cdef-0123-456789abcdef",
"orderId": "order-12345",
"merchant": "0x742d35Cc6634C0532925a3b844Bc9e7595f8fE00",
"amount": "100.00",
"token": "0xc2132D05D31c914a87C6611C10748AEb04B58e8F",
"chainId": 137,
"status": "completed",
"transactionHash": "0x...",
"timestamp": 1704067200000
}Verificar la firma
Cada webhook va firmado. Verifica la cabecera X-Signature antes de confiar en el contenido.
const crypto = require("crypto");
function verifyWebhook(rawBody, signature, signingKey) {
const expected = crypto
.createHash("sha256")
.update(rawBody + signingKey)
.digest("hex");
return crypto.timingSafeEqual(
Buffer.from(expected, "hex"),
Buffer.from(signature, "hex"),
);
}Preguntas frecuentes
¿Cuál es la URL base de la API?
La URL base de la API de MakaPay es https://app.makapay.io/api. Autentícate usando el encabezado x-api-key con tu clave de API del panel.
¿Qué blockchains admite la API?
La API admite MakaChain, Ethereum, Polygon (MATIC) y BNB Chain. Las transacciones en MakaChain tienen cero tarifas de gas. Otras redes incurren en costos de gas variables.
¿Puedo crear pagos para varias direcciones de billetera distintas?
Sí. Cada solicitud de pago incluye un campo de dirección de billetera de comercio. Puedes especificar diferentes direcciones de destino por pago, lo cual es útil para configuraciones de marketplace y de varios vendedores.
¿Qué eventos de webhook están disponibles?
MakaPay envía eventos para los cambios de estado del pago, incluidos payment.completed, payment.failed y payment.expired. Puedes configurar tu URL de webhook y seleccionar los eventos desde el panel.
Integraciones
Acepta tu primer pago en cripto en 10 minutos.
Crea tu cuenta, carga tu Gas Tank y comparte tu primer enlace de pago. Sin tarifas mensuales. Sin tarifas de configuración. Los fondos van directo a tu billetera.