INTEGRATIES
API voor cryptobetalingen. Eén endpoint om in crypto betaald te worden.
Maak betaallinks, ontvang webhook-events en laat geld naar elk walletadres uitbetalen met één REST API. Werkt met elke programmeertaal en elk framework. Je eerste 30 betalingen zijn gratis.
WAT JE KRIJGT
Gemaakt voor ondernemers die het simpel willen houden.
REST API
Standaard JSON REST API. Maak betalingen aan, bekijk de status en beheer je account programmatisch vanuit elke taal of elk framework.
Webhooks
Ontvang realtime meldingen als betalingen worden bevestigd, voltooid of mislukken. Met instelbare retry-logica voor gemiste meldingen.
Meerdere kostenmodi
Kies per betaling hoe kosten worden verwerkt: afschrijven van je Gas Tank, aftrekken van het betaalbedrag of doorberekenen aan de betaler.
Ondersteuning voor smart contracts
Native integratie met smart contracts voor on-chain betaalflows. Volledige documentatie van de technische architectuur beschikbaar.
HOE HET WERKT
In drie stappen naar je eerste betaling.
- 1
Vraag je API-sleutel aan
Maak een gratis account aan op app.makapay.io en genereer een API-sleutel in je dashboard onder API Keys.
- 2
Maak een betaling aan
Stuur een POST naar /api/payments met je walletadres, netwerk, token, bedrag en order-ID. Je krijgt een betaallink en QR-code terug in de response.
- 3
Ontvang webhook-events
Stel een webhook-URL in om payment.completed-events te ontvangen. Je systeem wordt automatisch bijgewerkt zodra het geld on-chain is bevestigd.
Begin met bouwen
Van nul naar je eerste betaling met één verzoek
Maak een betaallink, krijg een URL terug en ontvang een webhook zodra het bedrag on-chain is afgewikkeld. Werkt met elke taal of framework.
Een betaling aanmaken
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 paymentRespons
Je krijgt een gehoste betaal-URL. Stuur je klant daarheen door of toon deze als QR-code.
{
"url": "https://app.makapay.io/pay/01234567-89ab-cdef-0123-456789abcdef"
}De webhook afhandelen
Wijs een webhook-URL naar je server en MakaPay POST een payment.completed-event zodra de betaling is afgewikkeld.
{
"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
}De handtekening verifiëren
Elke webhook is ondertekend. Verifieer de X-Signature-header voordat je de payload vertrouwt.
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"),
);
}FAQ
Wat is de basis-URL van de API?
De basis-URL van de MakaPay API is https://app.makapay.io/api. Authenticeer met de header x-api-key en de API-sleutel uit je dashboard.
Welke blockchains ondersteunt de API?
De API ondersteunt MakaChain, Ethereum, Polygon (MATIC) en BNB Chain. Transacties op MakaChain kosten geen gas. Op andere netwerken betaal je variabele gaskosten.
Kan ik betalingen aanmaken voor verschillende walletadressen?
Ja. Elk betaalverzoek bevat een veld voor het walletadres van de ontvanger. Je kunt per betaling een ander bestemmingsadres opgeven, handig voor marktplaatsen en platforms met meerdere verkopers.
Welke webhook-events zijn er?
MakaPay stuurt events bij statuswijzigingen van betalingen, waaronder payment.completed, payment.failed en payment.expired. Je webhook-URL en de events die je wilt ontvangen, stel je in via het dashboard.
Accepteer je eerste cryptobetaling binnen 10 minuten.
Maak je account aan, vul je Gas Tank en deel je eerste betaallink. Geen maandelijkse kosten. Geen opstartkosten. Het geld gaat direct naar je wallet.