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

Sigma または Data Pipeline を使用して、カード発行情報を取得します。

Sigma または Data Pipeline 内で使用される Issuing オブジェクトには、[Authorizations (オーソリ)](https://docs.stripe.com/api/issuing/authorizations/object.md)、[Transactions (取引)](https://docs.stripe.com/api/issuing/transactions/object.md)、[Cards (カード)](https://docs.stripe.com/api/issuing/cards/object.md)、および [Cardholders (カード保有者)](https://docs.stripe.com/api/issuing/cardholders/object.md) が含まれます。Issuing 特有のテーブルは、スキーマの Issuing セクションにあります。

コネクテッドアカウントの Issuing データは、`connected_account_` を先頭に持つテーブル (例: `connected_account_issuing_authorizations`) で確認できます。Sigma または Data Pipeline で *Connect* (Connect is Stripe's solution for multi-party businesses, such as marketplace or software platforms, to route payments between sellers, customers, and other recipients) を使用する方法の詳細については、ドキュメントの [Connect](https://docs.stripe.com/data/query-connect-data.md) セクションをご覧ください。

## 認証

発行されたカードが購入に使用されると、[オーソリ](https://docs.stripe.com/api/issuing/authorizations/object.md)オブジェクトが作成されます。`issuing_authorizations` テーブルの各行は、このオブジェクトに関するデータを表します。同じ情報は API でも取得でき、[Stripe ダッシュボード](https://dashboard.stripe.com/test/issuing/authorizations)でも確認できます。現在、[request history](https://docs.stripe.com/api/issuing/authorizations/object.md#issuing_authorization_object-request_history) フィールドは利用できません。アカウントで作成されたすべてのオーソリは、Sigma または Data Pipeline で利用できます。

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

特定のオーソリに関連する取引にアクセスするには、`issuing_transactions` テーブルの `authorization_id` 列を結合します。
![](https://b.stripecdn.com/docs-statics-srv/assets/issuing-authorization.a2435f764c18d190f70797814eb62878.svg)

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

```sql
select
  date_trunc('month', created) as month,
  count(case when approved then 1 end) as num_approved_authorizations,
  count(*) as total_num_authorizations
from issuing_authorizations
where date_trunc('month', created) between date_trunc('month', date_add('month', -13, date(data_load_time)))
                                        and date_trunc('month', date_add('month', -1, date(data_load_time)))
group by 1
order by 1 desc, 2
limit 2
```

| 月 | approved | num_authorizations |
| --- | --- | --- |
| 2026-09-01 | false | 506 |
| 2026-09-01 | true | 10,045 |

## 取引

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

手数料などの取引に関する詳細は、関連する[取引残高](https://docs.stripe.com/api.md#balance_transaction_object)にアクセスしてください。アクセスするには、`balance_transaction_id` 列と `balance_transactions` テーブルの `id` 列を結合します。取引残高は、Issuing 固有のオブジェクトではありません。Sigma または Data Pipeline で取引残高を使用する場合は、ドキュメントの[取引](https://docs.stripe.com/data/query-transactions.md)セクションで詳細をご確認ください。

`authorization_id` 列を `issuing_authorizations` テーブルの `id` 列で結合すると、Transaction に関連付けられた [Authorization (オーソリ)](https://docs.stripe.com/api/issuing/authorizations/object.md) オブジェクトにアクセスできます。ここで、取引がどのようにオーソリされたかについて追加の詳細を得られます。Issuing 取引の `authorization_id` 列は、[キャプチャーの強制実行](https://docs.stripe.com/issuing/purchases/transactions.md#handling-other-transactions)の場合や、一部の[返金](https://docs.stripe.com/issuing/purchases/transactions.md)のインスタンスでは空になることがあります。

また、`card_id` 列と `cardholder_id` 列を介して、取引で使用されたカードとそのカード保有者の両方にアクセスすることもできます。カードに関する情報は `issuing_cards` テーブルに、カード保有者に関する情報は `issuing_cardholders` テーブルに格納されています。[Card (カード)](https://docs.stripe.com/api/issuing/cards/object.md) オブジェクトおよび [Cardholder (カード保有者)](https://docs.stripe.com/api/issuing/cardholders/object.md) オブジェクトを参照して、取引を開始した当事者についての情報を得ることができます。
![](https://b.stripecdn.com/docs-statics-srv/assets/issuing-transaction.64c38a1e0dfaec61d29a8a967a24efc8.svg)

次のクエリは、直近の 3 件の[オーバーキャプチャー](https://docs.stripe.com/issuing/purchases/transactions.md#handling-other-transactions)に関する情報を返します。`issuing_authorizations` テーブルを結合し、2 つのオブジェクトの金額を比較して、取引がオーバーキャプチャーかどうかを判断します。

```sql
select
  date_format(it.created, '%Y-%m-%d') as day,
  it.id,
  ia.amount as authorized_amount,
  -1 * it.amount as captured_amount
from issuing_transactions it
join issuing_authorizations ia
on it.authorization_id=ia.id
where
  it.type='capture' and
  -1 * it.amount > ia.amount --- This checks if this transaction was overcaptured
order by day desc
limit 3
```

| 日 | id | authorized_amount | captured_amount |
| --- | --- | --- | --- |
| 2026-09-13 | ipi_orWziM4j7CiRL8J | 150 | 151 |
| 2026-09-13 | ipi_orWziM4j7CiRL8J | 0 | 1,000 |
| 2026-09-13 | ipi_orWziM4j7CiRL8J | 1450 | 1050 |

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

```sql
select
  date_trunc('month', it.created) as month,
  fd.type as fee_type,
  sum(fd.amount) as net_fees,
  sum(it.amount) as net_amount
from issuing_transactions it
inner join balance_transactions bt
on bt.id=it.balance_transaction_id
inner join balance_transaction_fee_details fd
on fd.balance_transaction_id=bt.id
group by 1,2
order by month desc, fee_type
```

| 月 | fee_type | net_fees | net_amount |
| --- | --- | --- | --- |
| 2026-09-01 | stripe-fee | 590 | 10,000 |
| 2026-10-01 | stripe-fee | 59 | 1,000 |
| 2026-11-01 | stripe-fee | 590 | 10,000 |

## カード

`issuing_cards` テーブルには、個々の [Card (カード)](https://docs.stripe.com/api/issuing/cards/object.md) オブジェクトに関する情報が含まれます。同じ情報を API で取得したり、[Stripe ダッシュボード](https://dashboard.stripe.com/test/issuing/cards)で入手したりできます。[spending controls](https://docs.stripe.com/api/issuing/cards/object.md#issuing_card_object-spending_controls) フィールドは現在使用できません。

発行された各カードには、関連付けられた [Cardholder (カード保有者)](https://docs.stripe.com/api/issuing/cardholders.md) があります。これは、`cardholder_id` 列で `issuing_cardholders` テーブルを結合することでアクセスできます。
![](https://b.stripecdn.com/docs-statics-srv/assets/issuing-card.bde34e4a064958836ff7c665a3e71814.svg)

## カード保有者

[Cardholder (カード保有者)](https://docs.stripe.com/api/issuing/cardholders/object.md) データは、`issuing_cardholders` テーブル内に格納されます。同じ情報を API で取得したり、[Stripe ダッシュボード](https://dashboard.stripe.com/test/issuing/cardholders)で入手したりできます。[spending controls (支出監理)](https://docs.stripe.com/api/issuing/cards/object.md#issuing_card_object-spending_controls) フィールドは現在使用できません。

このテーブルを別のテーブルに結合して、取引を開始したエンティティや、発行されたカードを所有するエンティティに関する情報を取得することができます。
![](https://b.stripecdn.com/docs-statics-srv/assets/issuing-cardholder.ad6a5836bbdf5b37f497cddace2e1e01.svg)

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

```sql
select
  date_format(created, '%Y-%m-%d') as day,
  id,
  email,
  type
from issuing_cardholders
where status='active'
limit 3
```

| 日 | id | メールアドレス | タイプ |
| --- | --- | --- | --- |
| 2026-09-01 | ich_orWziM4j7CiRL8J | j.smith@example.com | individual |
| 2026-09-01 | ich_orWziM4j7CiRL8J | entity@example.com | business_entity |
| 2026-09-01 | ich_orWziM4j7CiRL8J | j.doe@example.com | individual |

### メタデータ

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

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

```sql
with transactions_metadata_dictionary as (
  select
    issuing_transaction_id,
    map_agg(key, value) metadata_dictionary
  from issuing_transactions_metadata
  group by 1
)

select
  date_format(it.created, '%Y-%m-%d') as day,
  it.id,
  it.amount,
  metadata_dictionary['my_label'] as my_label_value
from issuing_transactions it
left join transactions_metadata_dictionary
  on it.id = transactions_metadata_dictionary.issuing_transaction_id
where element_at(metadata_dictionary, 'my_label') is not null
order by day desc
limit 3
```

| 日 | id | 金額 | my_label_value |
| --- | --- | --- | --- |
| 2026-09-01 | ipi_orWziM4j7CiRL8J | 2000 | true |
| 2026-09-01 | ipi_orWziM4j7CiRL8J | 100 | true |
| 2026-09-01 | ipi_orWziM4j7CiRL8J | 10000 | false |