blindpay

BlindPay の統合

BlindPay はグローバルな決済 API です。1 つの統合で、銀行決済ネットワーク（ACH、wire、RTP、SWIFT、Pix、SPEI、ACH COP、Transfers 3.0、SEPA）と、7 つのチェーンに対応したステーブルコイン（USDC、USDT）を利用できます。すべての決済は内部でステーブルコインを介して決済されます。BlindPay は非カストディアル型の処理サービスです。資金は顧客の管理下に置かれ、取引が失敗した場合は送金元のウォレットまたは銀行口座に返金されます。

ドキュメントには 2 つの形式があり、リファレンスファイルでは両方をインラインで示しています。

• 抽象化形式：銀行決済ネットワークを中心に説明します。バーチャル口座、入金としての Payin、銀行振込としての Payout を扱います。ステーブルコイン部分は BlindPay が処理します。
• 高度な形式：ステーブルコインを中心に説明します。管理対象および外部ウォレット、チェーンとトークン、オンチェーン認可、クロスチェーン送金を扱います。

どちらも同じ API、キー、インスタンス、Webhook を使用します。回答する際は、ユーザーが構築しているものに合った形式を選んでください。

用語

receiver は customer に名称変更されました。API パスは /customers で、ID は引き続き re_ で始まります。従来の /receivers パスと receiver.* Webhook イベントは、2026 年 7 月の receivers から customers への移行終了に伴い廃止されました。以後は /customers と customer.* イベントのみを使用してください。

認証

すべての呼び出しにシークレット API キーが必要で、パスにはインスタンス ID を含めます。

curl --request GET \
  --url https://api.blindpay.com/v1/instances/in_000000000000/customers \
  --header 'Authorization: Bearer YOUR_API_KEY'

キーはインスタンスごとに発行されます。開発インスタンスはサンドボックスです（テストネット、シミュレーションされた法定通貨、USDC／USDT の代わりとなる USDB — 下記の「チェーンとトークン」を参照）。本番インスタンスでは実際の資金を扱います。サンドボックスと本番環境を参照してください。

2 つの基本フロー

どちらのフローも同じ 見積もりを取得してから実行する パターンです。これは BlindPay 自身の移行ドキュメントで一貫して使われている用語です。見積もりを作成し、有効期限が切れる前に実行してから、Webhook で結果を追跡します。

Payout：銀行口座への出金

1. 利用規約に同意 → tos_id
2. 顧客を作成（KYC／KYB）→ re_...、approved になるまで待機
3. 銀行口座を追加 → ba_...
4. Payout の見積もりを作成 → qu_...、1 回限りで使用可能 —「共通エラー」の「見積もりの期限切れ」を参照。宛先は bank_account_id、または登録済みの請求書（boleto、PIX QR コード、請求書）の支払いに使う payable_id です（Payableを参照）
5. Payout に資金を入金：管理対象ウォレットの残高には署名は不要です。外部ウォレットでは認可が必要です（EVM では ERC-20 approve、Stellar では署名済み XDR、Solana ではトークン委任）
6. Payout を実行 → po_...、その後 Webhook で追跡

Payoutから開始してください。

Payin：銀行口座からの入金

1. 利用規約に同意 → tos_id
2. 顧客を作成（KYC／KYB）→ re_...、approved になるまで待機
3. 入金先を選択：管理対象ウォレット（bl_...）、外部ブロックチェーンウォレット（bw_...）、または継続的な入金用のバーチャル口座を発行
4. Payin の見積もりを作成 → pq_... —「共通エラー」の「見積もりの期限切れ」を参照
5. Payin を実行 → pi_...、返された入金手順（Pix コード、CLABE、メモコード、ACH／wire の詳細）を支払人に提示
6. 資金が到着すると、BlindPay がステーブルコイン部分を処理して Webhook を送信

Payinから開始してください。

主なエンドポイント

すべてのパスには、https://api.blindpay.com/v1/instances/{instance_id} がプレフィックスとして付きます。

リソース	エンドポイント
顧客	/customers, /customers/{re}
利用規約	/e/instances/{instance_id}/tos（公開、キー不要）
銀行口座	/customers/{re}/bank-accounts
オフランプ用ウォレット	/customers/{re}/bank-accounts/{ba}/offramp-wallets
ブロックチェーンウォレット	/customers/{re}/blockchain-wallets, .../sign-message
管理対象ウォレット	/customers/{re}/wallets, .../wallets/{bl}/balance
バーチャル口座	/customers/{re}/virtual-accounts
ペイアウト見積もり	/quotes
ペイアウト	/payouts/evm, /payouts/stellar, /payouts/solana, /payouts/stellar/authorize
買掛金	/payables, /payables/{pb}（ペイアウトのフローで支払い：payable_id を指定して見積もりを取得）
ペイイン見積もり	/payin-quotes
ペイイン	/payins/evm
送金	/transfer-quotes, /transfers
RFI と上限	/customers/{re}/rfi, /customers/{re}/limit-increase
パートナー手数料	/partner-fees
Webhook	/webhook-endpoints, .../{we}/secret
アップロード	https://api.blindpay.com/v1/upload?instance_id={instance_id}

金額は常に最小通貨単位の整数です。100000 は $1,000.00 を表します。

ID のプレフィックス

プレフィックス	リソース
in_	インスタンス
re_	顧客（旧称 receiver）
ba_	銀行口座
bw_	外部ブロックチェーンウォレット
bl_	BlindPay 管理対象ウォレット
pb_	買掛金（登録済みの請求書）
va_	バーチャル口座
qu_	ペイアウト見積もり
po_	ペイアウト
pq_	ペイイン見積もり
pi_	ペイイン
tr_	送金
pf_	パートナー手数料
we_	Webhook エンドポイント

支払い方法

米国、ブラジル、メキシコ、コロンビア、アルゼンチン、欧州で利用できる10種類の銀行振込方式に加え、国際 SWIFT に対応しています。PSE や SEPA の特殊なケースを含む、各方式の国、通貨、方向（受取／送金）については、支払い方法を参照してください。各方式の決済速度と締め切り時刻については、締め切り時刻を参照してください。

チェーンとトークン

対応チェーンは7種類です：Ethereum、Polygon、Base、Arbitrum、Stellar、Solana、Tron（ベータ版）。本番インスタンスでは、メインネットのネットワーク名（ethereum、polygon、base、arbitrum、stellar、solana、tron）で実際の USDC／USDT を送金します。開発インスタンスでは、対応するテストネットで USDB（BlindPay のテストトークン）を送金します。一致しない組み合わせは拒否されます。各チェーンで利用できるトークンとテストネットのネットワーク名は、すべての見積もりリクエストを制御する列挙値です。最新情報を確認できる場所は対応チェーンです。

開発インスタンスでのテスト

見積もりの request_amount に特定の値を設定すると、結果を強制できます。

request_amount	結果
66600	failed
77700	refunded
その他の値	completed（ペイインは作成から約30秒後に自動完了します）

名を Fail にして顧客を作成すると、KYC の却下をシミュレートできます。テスト用ウォレットに USDB を入金するには、そのウォレット宛てのペイインを作成します。開発インスタンスでは、ペイインは作成から約30秒後に自動完了し、ウォレットに USDB が入金されます。

顧客の KYC ステータス

5つの kyc_status 値によって、顧客が実行できる操作が制御されます：verifying、approved、rejected、compliance_request、approved_rfi。各ステータスになる条件と審査にかかる時間については顧客を、compliance_request／approved_rfi の組み合わせについてはRFIを参照してください。

よくあるエラー

• please_accept_terms_of_service：顧客は現在の TOS バージョンに同意する必要があります
• 見積もりの有効期限切れ：expires_at を確認してください。固定の有効期間を想定しないでください。Payin、payout、transfer の見積もりはデフォルトで 5 分ですが、OTC（BRL のみ）の payin 見積もりは 10 秒で期限切れになり、SEPA payout の見積もりはさらに短い場合があります。期限切れになったら、新しい見積もりを作成してください。見積もりの有効期間を参照してください。
• 残高または許容量の不足：ウォレットの資金が不足しているか、ERC-20 の承認額が見積もり額を下回っています
• KYC が未承認：顧客はまだ approved に達していません。状態の一覧と RFI の処理方法については、上記の「顧客の KYC ステータス」を参照してください
• 未対応のトークン／チェーンの組み合わせ：対応チェーンを参照してください

リファレンスドキュメント

はじめに

• 概要 - BlindPay は、単一の統合で銀行ネットワークとステーブルコインを通じて資金を移動するグローバルな決済 API です。
• 全体像 - 1 つの REST API を通じて、銀行ネットワーク、ステーブルコインネットワーク、またはその両方に接続できます。仮想口座を発行して法定通貨の payin と payout を実行するほか、チェーンをまたいで USDC と USDT を保有、送信、受信できます。
• ステーブルコインから銀行への送金 - REST API だけを使い、開発環境で BlindPay が管理するウォレットから銀行口座へ、初めてのオフランプ payout を送信します。
• 銀行振込からステーブルコインへ - REST API だけを使い、開発環境で銀行振込を受け付け、同等額のステーブルコインを BlindPay から自動的に送金します。
• SDK - Node.js、Python、Go、PHP、Swift 用の BlindPay 公式 SDK に加え、OpenAPI 仕様と REST API リファレンスを提供します。
• AI を使った開発 - MCP サーバー、Agent Skills、REST API を使って、AI コーディングエージェントや AI ビルダーを BlindPay に接続します。

基本

• インスタンス - インスタンスは、スタックの各ステージに対応する独立した BlindPay 環境で、ダッシュボードから作成します。
• サンドボックスと本番環境 - 開発用インスタンスと本番用インスタンスの動作上の正確な違いと、切り替え時のチェックリストです。
• 請求 - BlindPay がバーチャルアカウント、トランザクション、パートナー手数料に対して請求する方法と、請求書の発行時期です。
• パートナー手数料 - 顧客のトランザクションに定率または定額の手数料を追加し、蓄積した収益を毎月引き出します。
• 顧客 - BlindPay を通じて決済やステーブルコインを送受信する個人または企業です。
• 利用規約 - 顧客の登録と KYC の開始前に、顧客が同意する必要のある法的契約です。
• RFI - BlindPay のコンプライアンスチームが顧客に追加書類を求めた際、プログラムから回答します。
• 限度額の引き上げ - 裏付け書類を提出して、顧客の1回あたり、1日あたり、または1か月あたりの送金限度額の引き上げを申請し、コンプライアンス審査の進捗を追跡します。
• アップロード - 顧客の KYC 書類や写真から、暗号化されたファイル URL を生成します。
• 書類の分析 - AI で KYC 書類を読み取り、提出前に承認率の指標を取得します。
• API キー - ダッシュボードで作成したインスタンス単位の API キーを使って、すべての BlindPay API リクエストを認証します。
• Webhook - API をポーリングする代わりに、顧客、決済、バーチャルアカウント、ウォレット、送金のリアルタイムイベントを受信します。
• Webhook イベント - ドメイン別に分類され、ペイロードの例が記載された BlindPay の Webhook イベントの完全な一覧です。
• Webhook の検証 - svix-id、svix-timestamp、svix-signature ヘッダーを使って、すべての BlindPay Webhook 呼び出しの署名を検証します。

出金（銀行口座への送金）

• 出金 - 受取人の銀行口座への出金を実行し、処理中から完了、失敗、返金済みまで追跡します。
• 銀行口座 - SWIFT、ACH、wire、RTP、Pix、PIX Safe、TED、SPEI、ACH COP、Transfers、SEPA、Faster Payments の各レールに対応する、BlindPay の出金先として受取人の銀行口座を追加します。
• 出金見積もり - 出金の実行前に為替レートと手数料の分担を確定し、レスポンスで正確な手数料の内訳と受取人の金額を確認します。
• 管理ウォレットを使った出金 - BlindPay 管理ウォレットから、オンチェーンでの承認や署名なしに、単一の REST 呼び出しで出金に資金を供給します。
• EVM を使った出金 - 外部 EVM ウォレットから出金に資金を供給し、ERC-20 トークンの送金を承認してから、出金を実行します。
• Stellar を使った出金 - 外部 Stellar ウォレットから出金に資金を供給し、出金を承認して XDR トランザクションに署名してから、出金を作成します。
• Solana を使った出金 - 外部 Solana ウォレットから出金に資金を供給し、トークンを BlindPay に委任してから、出金を作成します。
• オフランプウォレット - BlindPay のオフランプウォレットの概要、対応するチェーンとステーブルコイン、最低金額、および入金が自動的に法定通貨での出金に変換される仕組みです。

入金（銀行口座からの入金）

• 入金 - 入金を作成し、送金先に資金を届け、決済完了まで追跡します。
• 入金見積もり - 入金を作成する前に、金額、手数料の分配、送金先を確定します。
• ブロックチェーンウォレット - ステーブルコインの入金を受け取り、ステーブルコインの出金を行うために、外部の顧客管理ウォレットアドレスを登録します。
• 管理ウォレットへの入金 - 法定通貨での支払いを受け付け、相当額のステーブルコインをBlindPay管理ウォレットに届けます。署名なしでREST APIを2回呼び出すだけです。
• ブロックチェーンウォレットへの入金 - 法定通貨での支払いを受け付け、相当額のステーブルコインを顧客が管理するウォレットに届けます。

買掛金（登録済みの請求書の支払い）

• 買掛金 - 請求書、インボイス、ボレート、またはPIXコードを登録し、標準の出金フローで支払います。
• ボレートおよびPIXの買掛金 - ボレート、公共料金または税金の請求書、またはPIXコードを買掛金として登録し、標準の出金フローで支払います。
• インボイスの買掛金 - ACHまたは電信送金で米国の銀行口座に支払う仕入先のインボイスを登録します。必要に応じて、AIでPDFを読み取って事前入力できます。
• 管理ウォレットからの買掛金の支払い - 顧客が支払う請求書を登録し、オンチェーン承認やウォレットのプロンプトなしで、BlindPayがカストディするウォレットから支払います。
• EVMによる買掛金の支払い - 顧客が支払う請求書を登録し、見積もりを取得してERC-20の引き出しを承認し、出金を実行することで、外部のEVMウォレットから支払います。

仮想口座

• 仮想口座 - USDの銀行振込を受け取り、顧客のウォレット内のUSDCやUSDTなどのステーブルコインに自動決済される仮想口座（仮想銀行口座）を発行します。
• 仮想口座の作成 - 顧客側の前提条件や必須のコンプライアンス項目から、承認を確認するWebhookまで、BlindPay APIを使った仮想口座の作成方法を説明します。

ウォレット、送金、ステーブルコイン

• 保管 - 顧客の残高をBlindPay管理ウォレットに保管するか、顧客がすでに管理している外部ウォレットを登録します。
• 管理ウォレット - BlindPay管理ウォレットを作成し、残高を確認して、入金や出金に使用します。
• 送信 - BlindPay APIを使って、BlindPay管理ウォレットから別の管理ウォレットまたは任意の外部アドレスへステーブルコインを送信します。
• 送金見積もり - 送金を実行する前に、送信元ウォレット、送信先アドレス、トークン、ネットワーク、金額を確定する送金見積もりを作成します。
• 送金 - 送金見積もりに基づいてステーブルコインの送金を実行し、完了までBlindPay APIで追跡します。
• 受け取り - BlindPay管理ウォレットでステーブルコインを受け取り、wallet.inbound Webhookですべての入金を追跡します。

ナレッジベース（コンプライアンス、対応範囲、運用）

• カットオフ時間 - ACH、電信送金、SWIFT の受付締切と決済、即時送金ネットワーク、見積もりの有効期限、オンボーディングの SLA、返金所要時間。
• 情報提供依頼 - Request for Information（RFI）とは、顧客の承認前に不足している KYC または KYB の情報を BlindPay のコンプライアンスチームが求める手続きです。
• インスタンスに関する依頼 - BlindPay のコンプライアンスチームがお客様のアカウントについて追加情報を求める方法と、27 日間の期限が切れる前に回答する方法です。
• KYB 書類 - 事業者の KYB 検証に必要な書類。設立書類、所有権の証明、UBO の本人確認書類、住所証明が含まれます。
• KYC の基本 - BlindPay の顧客に必要な KYC 検証レベル、書類の品質基準、提出ガイドラインです。
• KYC 要件 - BlindPay の顧客に適用される検証レベル、必須項目、ステータス、制限、書類の品質、利用規約、RFI について説明します。
• NAICS コード - BlindPay のオンボーディング時に、自社の NAICS 産業コードを確認できます。
• 第三者のための送金 - ネスティングとは、BlindPay が把握できない当事者のために資金を移動することです。このガイドでは、その見分け方とコンプライアンスを遵守する方法を説明します。
• 保留中の取引 - BlindPay の監視システムによって不審な取引としてフラグが付けられ、コンプライアンス審査または情報提供依頼への対応待ちで保留されている取引です。
• 支払い方法 - BlindPay が対応するすべての銀行送金ネットワークを、国と通貨別に説明します。ACH、電信送金、RTP、SWIFT、Pix、PIX Safe、TED、SPEI、PSE、Transfers、SEPA、Faster Payments が含まれます。
• 支払い明細の表示名 - 受取人の銀行明細に送金者名がどのように表示されるかは、支払い方法と Named Account が有効かどうかによって異なります。
• 代理支払いと代理回収 - BlindPay における代理支払いと代理回収の仕組み、電信送金に顧客名が表示される条件、コンプライアンス上の境界について説明します。
• 禁止されている活動 - BlindPay で高リスクまたは禁止されている事業活動と、オンボーディング時および継続的なモニタリングで必要となる開示義務について説明します。
• 住所証明 - 事業者および個人の検証で受け付けられる住所証明書類と提出要件です。
• 却下理由 - 検証中に申請または書類が却下された際に返される理由コードとメッセージです。
• セルフカストディウォレット（ブラジル） - ブラジルの顧客は、外部ウォレットごとにセルフカストディ型かどうかを申告する必要があります。変更点、対象者、ダッシュボードまたは API での手続きについて説明します。
• 資金源 - 事業者の資金源および資産形成源を確認するために必要な書類です。
• 対応ブロックチェーン - BlindPay の入金、出金、ウォレット、送金におけるブロックチェーン、ステーブルコイン、機能ごとのチェーン対応状況について説明します。
• 対応国 - BlindPay が対応するすべての国を、標準、高リスク（Enhanced KYC が必要）、禁止の各区分で紹介します。
• SWIFT 送金の到達率 - SWIFT 送金が届く可能性を高めるための、コンプライアンス書類と受取人住所の形式に関する要件です。
• SWIFT のステータス - tracking_documents フィールドを使って、SWIFT 出金のコンプライアンス書類が保留、審査、承認の各段階でどのように追跡されるかを説明します。
• バーチャルアカウントの書類 - 資金源および資産形成源を裏付ける書類など、バーチャルアカウントの審査に必要な書類です。

移行ガイド（別のプロバイダーからの移行）

• Anchorage Digital から BlindPay への移行 - カストディには Anchorage Digital を引き続き使用し、ステーブルコインから法定通貨への処理を BlindPay に移行します。送金、出金、決済イベントを BlindPay の見積もり、支払い、Webhook に対応付けます。
• BitGo から BlindPay への移行 - BitGo との連携におけるステーブルコインから法定通貨への処理を BlindPay に移行します。ウォレット、送金、決済 Webhook を BlindPay の顧客、見積もり、支払い、Webhook イベントに対応付けます。
• Bridge から BlindPay への移行 - 既存の Bridge 連携を BlindPay API に移行します。顧客、外部アカウント、換金用アドレス、送金を、それぞれ対応する BlindPay の機能に対応付けます。
• Cobo から BlindPay への移行 - Cobo Payments との連携におけるステーブルコインから法定通貨への処理を BlindPay に移行します。必要に応じてウォレットのカストディには Cobo を引き続き使用し、チャージ用アドレス、注文モード、支払い先を、顧客、見積もり、支払いに置き換えます。
• Coinbase CDP から BlindPay への移行 - Coinbase Developer Platform との連携におけるステーブルコインから法定通貨へのオフランプ処理を BlindPay に移行します。CDP ウォレットでカストディを継続しながら、Pix、SPEI、SEPA、電信送金による支払いを追加します。
• Conduit から BlindPay への移行 - Conduit の国際送金連携を BlindPay に移行します。相手方、送金ルート、決済の追跡を、見積もりと実行のモデルに対応付けます。
• Crossmint から BlindPay への移行 - Crossmint が引き続きウォレット、チェックアウト、オーケストレーションを担当する一方で、連携におけるステーブルコインから法定通貨への処理を BlindPay に移行します。
• Dfns から BlindPay への移行 - MPC ウォレットのカストディには Dfns を引き続き使用し、ステーブルコインから法定通貨への処理を BlindPay に移行します。送金と取引所への出金を、見積もり、支払い、登録済み外部ウォレットに対応付けます。
• Dynamic から BlindPay への移行 - 埋め込みウォレットとサーバーウォレットには Dynamic を引き続き使用し、ステーブルコインから法定通貨へのオフランプ処理を BlindPay に移行します。Dynamic ウォレットを登録し、支払いの見積もりと実行を行い、Webhook を検証します。
• Fern から BlindPay への移行 - Fern のステーブルコイン連携を BlindPay に移行します。顧客、銀行口座、ウォレット、見積もり後に実行する入金と支払い、Svix 署名付き Webhook に対応付けます。
• Fireblocks から BlindPay への移行 - Fireblocks との連携におけるステーブルコインから法定通貨への支払い処理を BlindPay に移行します。Fireblocks はカストディアンとして引き続き使用し、受取人を再登録して、見積もり後に支払いを行うフローを再構築し、Webhook を移行します。
• 手動支払いから BlindPay への移行 - スプレッドシートと銀行ポータルを使った支払い業務を、監査可能なステートマシンを備えた、自動化された Webhook 駆動の API フローに移行します。
• Privy から BlindPay への移行 - 埋め込みウォレットとサーバーウォレットには Privy を引き続き使用し、ステーブルコインから法定通貨へのオフランプ処理を BlindPay に移行します。ウォレットを登録し、支払いの見積もりと実行を行い、Webhook を検証します。
• SWIFT 電信送金から BlindPay への移行 - 複数日かかる国際電信送金を、現地決済網を利用した同日中のステーブルコイン決済に置き換えます。BlindPay が対応していない送金ルートでは、SWIFT をフォールバックとして維持します。
• Turnkey から BlindPay への移行 - ウォレットと署名には Turnkey を引き続き使用し、Turnkey ベースの製品におけるステーブルコインから法定通貨へのオフランプ処理を BlindPay に移行します。支払いアカウント、見積もり、Webhook を対応付けます。
• Utila から BlindPay への移行 - カストディアン兼署名者として Utila を引き続き使用し、ステーブルコインから法定通貨への処理を BlindPay 経由にします。ボールト、ウォレット、トランザクション、Webhook を、それぞれ対応する BlindPay の機能に対応付けます。

AI ツール連携

• Bolt.new + BlindPay - BlindPay APIとコピー＆ペーストできるプロンプトを使って、Bolt.new（StackBlitz）アプリにステーブルコイン決済を追加します。払い出し、オンランプ、仮想口座の各フローに対応します。
• Claude Code + BlindPay - MCP サーバーとAgent Skillsを介してClaude CodeをBlindPayに接続します。ターミナルから自然言語で、払い出し、見積もり、仮想口座の操作を実行できます。
• Codex + BlindPay - MCP サーバーとAgent Skillsを介してOpenAI CodexをBlindPayに接続します。ターミナルまたはIDEから、払い出し、見積もり、仮想口座の操作を実行できます。
• Cursor + BlindPay - MCP サーバーとAgent Skillsを介してCursorをBlindPayに接続します。自然言語で送金、払い出し、送金ルートの照会を実行できます。
• Hermes Agent + BlindPay - MCP サーバーとAgent Skillsを使ってHermes AgentをBlindPayに接続します。Nous Researchのエージェントが自然言語でステーブルコインの払い出しと見積もりを実行します。
• Lovable + BlindPay - BlindPay APIとコピー＆ペーストできるプロンプトを使って、Lovableアプリにステーブルコイン決済を追加します。払い出し、USDC/USDTから法定通貨へのオンランプ、仮想口座に対応します。
• OpenClaw + BlindPay - MCP サーバーとAgent Skillsを使ってOpenClawをBlindPayに接続します。自律型エージェントが自然言語でステーブルコインの払い出しと見積もりを実行します。
• Replit + BlindPay - Replit Agentを使って、Replitアプリにステーブルコイン決済を追加します。BlindPay APIとReplit Secretsを利用した払い出し、オンランプ、仮想口座の各フローに対応します。
• v0 + BlindPay - BlindPay APIとコピー＆ペーストできるプロンプトを使って、v0（Vercel）のNext.jsアプリにステーブルコイン決済を追加します。払い出し、オンランプ、仮想口座の各フローに対応します。