統合

暗号資産決済API。暗号資産で受け取るための1つのエンドポイント。

単一のREST APIで支払いリンクの作成、webhookイベントの受信、任意のウォレットアドレスへの資金決済が可能。任意の言語やフレームワークで動作。最初の30件の支払いは無料。

ご利用内容

シンプルさを求めるマーチャント向けに構築。

REST API

標準JSON REST API。任意の言語やフレームワークからプログラムで支払いの作成、ステータス確認、アカウント管理が可能。

ウェブフック

支払いが確認、完了、失敗したときにリアルタイムイベント通知を受け取れます。未配信時の再試行ロジックを構成可能。

複数の手数料モード

支払いごとの手数料処理方法を選択:Gas Tankから差し引き、支払い金額から差し引き、または支払者に手数料を負担。

スマートコントラクトサポート

オンチェーン決済フロー向けネイティブスマートコントラクト統合。完全な技術アーキテクチャドキュメントを利用可能。

使い方

最初の支払いまでの3ステップ。

  1. 1

    APIキーを取得

    app.makapay.ioで無料アカウントを作成し、ダッシュボードのAPI KeysからAPIキーを生成。

  2. 2

    支払いを作成

    /api/paymentsにマーチャントウォレットアドレス、ネットワーク、トークン、金額、注文IDをPOST。レスポンスで支払いリンクとQRコードを受け取れます。

  3. 3

    webhookイベントを受け取る

    webhook URLを設定してpayment.completedイベントを受け取れます。オンチェーンで資金が確認されるとシステムが自動更新。

開発を始める

たった1回のリクエストで最初の支払いまで

決済リンクを作成するとURLが返り、オンチェーンで着金した瞬間にwebhookが届きます。あらゆる言語・フレームワークで動作します。

決済を作成する

cURL
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"
  }'

レスポンス

ホスト型の決済URLが返されます。顧客をそこへリダイレクトするか、QRコードとして表示してください。

JSON
{
  "url": "https://app.makapay.io/pay/01234567-89ab-cdef-0123-456789abcdef"
}

Webhookを処理する

WebhookのURLを自社サーバーに設定すると、決済が確定した瞬間にMakaPayがpayment.completedイベントをPOSTします。

payment.completed
{
  "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ヘッダーを検証してください。

verify-webhook.js
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に資金を入れ、最初の支払いリンクを共有します。月額料金なし。セットアップ料金なし。資金は直接ウォレットに入ります。