カード発行データのクエリ

Sigma または Data Pipeline 内で使用される Issuing オブジェクトには、Authorizations (オーソリ)、Transactions (取引)、Cards (カード)、および Cardholders (カード保有者) が含まれます。Issuing 特有のテーブルは、スキーマの Issuing セクションにあります。

連結アカウントの Issuing データは、connected_account_ が前に付いたテーブル (connected_account_issuing_authorizations など) 内にあります。Sigma または Data Pipeline で Connect を使用する詳細については、ドキュメントの Connect セクションをご覧ください。

オーソリ

発行されたカードを使用して購入が行われると、Authorization (オーソリ) オブジェクトが作成されます。issuing_authorizations テーブル内の各行は、このオブジェクトに関するデータを表します。同じ情報を API で取得したり、Stripe ダッシュボードで入手したりできます。request history フィールドは現在使用できません。アカウントで作成されたすべてのオーソリは、Sigma または Data Pipeline で使用できます。

このテーブルの card_id 列には、購入に使用されたカードの ID が格納されます。オーソリを開始したカードに関する追加情報を取得するには、この列と issuing_cards テーブルを結合します。

特定のオーソリに関連する取引にアクセスするには、issuing_transactions テーブルの authorization_id 列を結合します。

次のクエリは、承認ステータスごとにグループ化されたオーソリの件数を計算します。

取引

発行されたカードが使用され、購入完了や返金など Stripe アカウントへの出入金が発生した場合、Issuing Transaction (取引) オブジェクトで表されます。これらのオブジェクトに関する情報は、issuing_transactions テーブル内に格納されます。同じ情報を API で取得したり、Stripe ダッシュボードで入手したりできます。

手数料などの取引に関する追加について、詳細は関連する取引残高にアクセスしてください。アクセスするには、balance_transactions テーブルの balance_transaction_id 列と id 列を結合します。取引残高は、Issuing 固有のオブジェクトではありません。Sigma または Data Pipeline で取引残高を使用する場合は、ドキュメントの取引セクションで詳細をご確認ください。

authorization_id 列を issuing_authorizations テーブルの id 列で結合すると、Transaction に関連付けられた Authorization (オーソリ) オブジェクトにアクセスできます。ここで、取引がどのようにオーソリされたかについて追加の詳細を得られます。Issuing 取引の authorization_id 列は、キャプチャーの強制実行の場合や、一部の返金のインスタンスでは空になることがあります。

また、card_id 列と cardholder_id 列を介して、取引で使用されたカードとそのカード保有者の両方にアクセスすることもできます。カードに関する情報は issuing_cards テーブルに、カード保有者に関する情報は issuing_cardholders テーブルに格納されています。Card (カード) オブジェクトおよび Cardholder (カード保有者) オブジェクトを参照して、取引を開始した当事者についての情報を得ることができます。

次のクエリは、直近の 3 件のオーバーキャプチャーに関する情報を返します。issuing_authorizations テーブルを結合し、2 つのオブジェクトの金額を比較して、取引がオーバーキャプチャーかどうかを判断します。

Issuing で Sigma または Data Pipeline を使用することのメリットの 1 つは、データを集計する機能です。次の例は、balance_transactions テーブルを結合し、Issuing 取引の各タイプの月額手数料を集計します。

カード

issuing_cards テーブルには、個々の Card (カード) オブジェクトに関する情報が含まれます。同じ情報を API で取得したり、Stripe ダッシュボードで入手したりできます。spending controls フィールドは現在使用できません。

発行された各カードには、関連付けられた Cardholder (カード保有者) があります。これは、cardholder_id 列で issuing_cardholders テーブルを結合することでアクセスできます。

カード保有者

Cardholder (カード保有者) データは、issuing_cardholders テーブル内に格納されます。同じ情報を API で取得したり、Stripe ダッシュボードで入手したりできます。spending controls (支出監理) フィールドは現在使用できません。

このテーブルを別のテーブルに結合して、取引を開始したエンティティや、発行されたカードを所有するエンティティに関する情報を取得することができます。

次の例では、直近に作成された有効な 3 人のカード保有者に関する情報を取得します。

メタデータ

各 Issuing オブジェクトのメタデータは、個別のテーブルに格納されます。これらのテーブルの名前は、オブジェクトのテーブルの名前の最後に _metadata を付けたものです (issuing_transactions_metadata など)。メタデータテーブルには、プライマリーテーブルの対応オブジェクトへの外部キーが含まれ、これを使用して 2 つのテーブルを結合できます。たとえば、issuing_transactions_metadata テーブルの各行には、issuing_transactions テーブルの id 行を参照する issuing_transaction_id 列があります。

次の例では、issuing_transactions テーブルのメタデータテーブルからディクショナリーを作成します。次に、それを使用していくつかの取引のメタデータキー 'my_label' の値にアクセスします。