メインコンテンツへスキップ
バージョン: 最新版

Capability API

Capability APIは、アカウントで利用可能な機能、対応している決済方法、取引限度額、地域設定に関する情報を返します。

概要​

Capability APIを使用して以下のことができます：

  • 決済方法の確認 - アカウントで有効化されているすべての決済方法の一覧を取得
  • 取引限度額の確認 - 課金、振込、分割払いの最小・最大金額を確認
  • 通貨サポートの確認 - 各決済方法で利用可能な通貨を確認
  • トークン化オプションへのアクセス - Apple Pay、Google Pay、その他のトークン化方法の利用可能性を確認

主な機能​

機能説明
決済方法設定を含む有効な決済方法の一覧
取引限度額課金、振込、分割払いの最小・最大金額
対応銀行振込と口座振替で利用可能な銀行
カードブランド対応カードネットワーク（Visa、Mastercard、JCBなど）
トークン化利用可能なデジタルウォレット連携

認証​

Capability APIは公開鍵と秘密鍵の両方の認証を受け付けます：

  • 公開鍵 - クライアントサイドのコードで安全に使用可能
  • 秘密鍵 - 完全な詳細を含むサーバーサイドリクエスト用

利用可能なエンドポイント​

クイック例​

curl https://api.omise.co/capability \
  -u pkey_test_xxx:

レスポンス構造​

capabilityオブジェクトには以下が含まれます：

  • country - アカウントの国コード
  • payment_methods - 利用可能な決済方法の配列
  • limits - さまざまな操作の取引限度額
  • banks - 振込で対応している銀行
  • tokenization_methods - 利用可能なトークン化オプション（Apple Pay、Google Pay）
  • zero_interest_installments - 加盟店負担の分割払いが有効かどうか