送金 API
送金 API を使用すると、Omiseアカウントの残高から受取人の銀行口座に資金を送金できます。送金は支払いプロセスの最終ステップであり、加盟店、ベンダー、または個人に資金を移動します。
概要
送金では以下のことができます：
- 受取人への送金 - Omise残高から銀行口座に送金
- 支払いのスケジュール設定 - 受取人への送金タイミングを管理
- 送金ステータスの追跡 - 保留中、送信済み、支払済み、失敗した送金を監視
- メタデータの管理 - 照合とレポート用のカスタムデータを添付
- 失敗の処理 - 失敗した送金を特定して再試行
送金のライフサイクル
- 作成 - 受取人への送金を開始
- 保留中 - 送金は処理待ちのキューに入っている
- 送信済み - 送金は銀行システムに送信された
- 支払済み - 資金が受取人の銀行口座に正常に到達
- 失敗 - 送金が失敗（残高不足、無効なアカウントなど）
主要な概念
受取人
送金には受取人（確認済みの銀行口座の送金先）が必要です。送金を開始する前に受取人を作成する必要があります。
残高要件
送金は利用可能な残高から引き落とされます。送金を作成する前に十分な資金があることを確認してください。
処理時間
- タイ国内: 国内銀行送金は1〜2営業日
- 国際: 送金先の国によって3〜7営業日
送金限度額
送金限度額はアカウント設定と受取人の確認ステータスによって異なります。カスタム限度額についてはサポートにお問い合わせください。
認証
すべての送金エンドポイントには認証のためにシークレットキーが必要です。クライアントサイドのコードでシークレットキーを公開しないでください。
利用可能なエンドポイント
| メソッド | エンドポイント | 説明 |
|---|---|---|
| POST | /transfers | 新しい送金を作成 |
| GET | /transfers/:id | 特定の送金を取得 |
| GET | /transfers | すべての送金を一覧表示 |
| PATCH | /transfers/:id | 送金を更新 |
| DELETE | /transfers/:id | 保留中の送金をキャンセル |
一般的なユースケース
マーケットプレイスの支払い
自動手数料控除を伴う成功した取引後に売り手に資金を送金します。
アフィリエイトコミッション
メタデータに保存されたパフォーマンス指標に基づいて、アフィリエイトへの月次送金をスケジュールします。
銀行口座への返金
元の支払い方法ではなく、顧客の銀行口座に直接返金を処理します。
ベンダーへの支払い
会計システムと統合された自動送金でサプライヤーやベンダーに支払います。
送金失敗コード
送金が失敗した場合、failure_code属性が理由を示します：
| コード | メッセージ | 説明 |
|---|---|---|
insufficient_balance | "insufficient balance" | 送金額が利用可能な資金を超えている |
invalid_recipient | "invalid recipient" | 受取人が無効または未確認 |
invalid_bank_account | "invalid bank account" | 銀行口座の詳細が正しくない |
transfers_suspended | "transfers suspended" | アカウントの送金が停止されている |
transfer_deleted | "transfer deleted" | 削除された送金を処理しようとしている |
transfer_sent | "transfer already sent" | 既に送信された送金を再送信しようとしている |
transfer_failed | "transfer failed" | 一般的な送金処理の失敗 |
bank_not_found | "bank not found" | 指定された銀行が見つからない |
account_not_found | "account not found" | 銀行口座が見つからない |
name_mismatch | "name mismatch" | 口座名義人名が一致しない |
送金ステータス値
| ステータス | 説明 |
|---|---|
pending | 送金は処理待ちのキューに入っている |
sent | 送金は銀行システムに送信された |
paid | 資金が受取人の銀行口座に到達 |
failed | 送金が失敗（failure_codeを確認） |
ベストプラクティス
- 送金を開始する前に受取人を確認する
- 十分な資金があることを確認するために残高を確認する
- 照合と追跡のためにメタデータを使用する
- 送金ステータスの変更を監視するためにWebhookを実装する
- 再試行ロジックで失敗を適切に処理する
- 本番送金を処理する前にテストモードで徹底的にテストする
関連リソース
お困りですか？ 送金限度額、処理時間、または統合支援についてはsupport@omise.coにお問い合わせください。