統合
暗号資産決済API。暗号資産で受け取るための1つのエンドポイント。
単一のREST APIで支払いリンクの作成、webhookイベントの受信、任意のウォレットアドレスへの資金決済が可能。任意の言語やフレームワークで動作。最初の30件の支払いは無料。
ご利用内容
シンプルさを求めるマーチャント向けに構築。
REST API
標準JSON REST API。任意の言語やフレームワークからプログラムで支払いの作成、ステータス確認、アカウント管理が可能。
ウェブフック
支払いが確認、完了、失敗したときにリアルタイムイベント通知を受け取れます。未配信時の再試行ロジックを構成可能。
複数の手数料モード
支払いごとの手数料処理方法を選択:Gas Tankから差し引き、支払い金額から差し引き、または支払者に手数料を負担。
スマートコントラクトサポート
オンチェーン決済フロー向けネイティブスマートコントラクト統合。完全な技術アーキテクチャドキュメントを利用可能。
使い方
最初の支払いまでの3ステップ。
- 1
APIキーを取得
app.makapay.ioで無料アカウントを作成し、ダッシュボードのAPI KeysからAPIキーを生成。
- 2
支払いを作成
/api/paymentsにマーチャントウォレットアドレス、ネットワーク、トークン、金額、注文IDをPOST。レスポンスで支払いリンクとQRコードを受け取れます。
- 3
webhookイベントを受け取る
webhook URLを設定してpayment.completedイベントを受け取れます。オンチェーンで資金が確認されるとシステムが自動更新。
開発を始める
たった1回のリクエストで最初の支払いまで
決済リンクを作成するとURLが返り、オンチェーンで着金した瞬間にwebhookが届きます。あらゆる言語・フレームワークで動作します。
決済を作成する
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 paymentレスポンス
ホスト型の決済URLが返されます。顧客をそこへリダイレクトするか、QRコードとして表示してください。
{
"url": "https://app.makapay.io/pay/01234567-89ab-cdef-0123-456789abcdef"
}Webhookを処理する
WebhookのURLを自社サーバーに設定すると、決済が確定した瞬間にMakaPayがpayment.completedイベントをPOSTします。
{
"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
}署名を検証する
すべてのwebhookは署名されています。ペイロードを信頼する前にX-Signatureヘッダーを検証してください。
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"),
);
}よくある質問
APIのベースURLは何ですか?
MakaPay APIのベースURLはhttps://app.makapay.io/apiです。ダッシュボードのAPIキーでx-api-keyヘッダーを使って認証。
APIはどのブロックチェーンをサポートしますか?
APIはMakaChain、Ethereum、Polygon (MATIC)、BNB Chainをサポート。MakaChainトランザクションはガス代ゼロ。他のネットワークは変動ガスコストが発生。
複数の異なるウォレットアドレス向けの支払いを作成できますか?
はい。各支払いリクエストにマーチャントウォレットアドレスフィールドが含まれます。支払いごとに異なる宛先アドレスを指定可能で、マーケットプレイスやマルチベンダー設定に便利。
利用可能なwebhookイベントは何ですか?
MakaPayはpayment.completed、payment.failed、payment.expiredを含む支払いステータス変更のイベントを送信。ダッシュボードでwebhook URLを構成し、イベントを選択可能。
最初の暗号資産支払いを10分で受け入れる。
アカウントを作成し、Gas Tankに資金を入れ、最初の支払いリンクを共有します。月額料金なし。セットアップ料金なし。資金は直接ウォレットに入ります。