Finances API

Finances API 概要 (Finances API Overview)

Finances API は、セラーが銀行口座へのペイアウト（支払金）、ローン/返済、送料など、eBayアカウントの財務情報を確認/追跡するために使用されます。

返される情報は、My eBayの Seller Hub（セラーハブ）の Payments（支払い）タブで利用可能な情報と似ています。

技術概要 (Technical overview)

Finances API には以下のメソッドが含まれています：

  • getPayout: このメソッドは、特定のペイアウトの情報を取得します。
  • getPayouts: このメソッドは、指定されたフィルタ条件に一致する1つ以上のペイアウトの情報を取得します。
  • getPayoutSummary: このメソッドは、指定されたフィルタ条件に一致するペイアウトの集計情報を取得します。
  • getTransactions: このメソッドは、指定されたフィルタ条件に一致する1つ以上の取引（トランザクション）の情報を返します。
  • getTransactionSummary: このメソッドは、指定されたフィルタ条件に一致する取引の集計情報を返します。
  • getTransfer: このメソッドは、指定された送金の詳細を返します。
  • getSellerFundsSummary: このメソッドは、セラーへのペイアウトを通じてまだ分配されていない資金の集計情報を返します。
  • getBillingActivities: このメソッドは、セラーのフィルタリングされた請求アクティビティを返します。

ビジネスユースケース (Business use cases)

Finances APIの一般的なユースケースは以下の通りです：

  • 1つ以上の特定のペイアウトのステータスを確認する。
  • eBay Seller Capitalのローン返済を確認および追跡する。
注: eBay Seller Capital は一部のマーケットプレイスでのみ利用可能です。現在のマーケットプレイスの適格性については、eBay Seller Capital資金調達プログラムのマーケットプレイス利用可能性を参照してください。
  • 指定された期間内に行われた販売取引の数を確認する。
  • 指定された期間内にeBayに支払われた手数料と請求の合計額を確認する。
  • 現在ペイアウト可能だがまだ処理されていない資金の合計額を確認する。
  • セラーの請求アクティビティを取得する。

Finances APIの要件と制限 (Finances API requirements and restrictions)

Finances API はマーケットプレイスやユーザーによって制限されておらず、「スタンドアロン」APIと見なすことができます。ユーザーは、Finances API を使用するために他のeBayパブリックAPIと統合する必要はありません。

重要! Finances API をクエリするためのソースとして、Notification API 以外のAPIレスポンスや通知を使用しないでください。支払いデータの可用性が欠如しているため、不変のレスポンスやシステムエラーが発生する可能性があります。たとえば、商品が販売された後、支払いが正常に実行された後にのみ取引が表示されるため、Finances API に支払い取引が表示されるまでにタイムラグが生じる場合があります。
注: PayPalなどのeBay資金以外の方法で購入された配送ラベルの請求とクレジットは、Finances API ではサポートされていません。
注: EUおよび英国の決済規制要件により、EU/UKのセラーが行う特定のAPI呼び出し（すべての Finances API メソッドを含む）には、デジタル署名による追加のセキュリティ検証が必要です。影響を受けるAPIおよびHTTPペイロードに含める署名の作成プロセスについては、Digital Signatures for APIs を参照してください。
注: Finances API は Team Access をサポートしていません。ペイアウトや取引などの財務情報は、呼び出しを行ったユーザーに対してのみ返されます。このAPIのメソッドを使用して他のユーザーの財務情報を返すことはできません。

eBay Seller Capital資金調達プログラムのマーケットプレイス利用可能性

eBay Seller Capital資金調達は、現在以下のeBayマーケットプレイスで利用可能です：

  • ドイツ (EBAY_DE)
  • イギリス (EBAY_GB)

ローン返済取引の取得は、現在サポートされているマーケットプレイスに限定されています。

トップに戻る