# Interroger les données d’émission de cartes

Utilisez Sigma ou Data Pipeline pour récupérer les informations sur les émissions de cartes

Les objets Issuing représentés dans Sigma ou Data Pipeline sont les objets [Authorization](https://docs.stripe.com/api/issuing/authorizations/object.md), [Transaction](https://docs.stripe.com/api/issuing/transactions/object.md), [Card](https://docs.stripe.com/api/issuing/cards/object.md) et [Cardholder](https://docs.stripe.com/api/issuing/cardholders/object.md). Les tables spécifiques aux objets Issuing se trouvent dans la section Issuing du schéma.

Les données Issuing de vos comptes connectés sont stockées dans les tables dont le nom commence par `connected_account_` (par exemple, `connected_account_issuing_authorizations`). Pour en savoir plus sur l’utilisation de *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) avec Sigma ou Data Pipeline, consultez la section [Connect](https://docs.stripe.com/stripe-data/query-connect-data.md) de la documentation.

## Autorisations

Un objet [Authorization](https://docs.stripe.com/api/issuing/authorizations/object.md) est créé chaque fois qu’une carte émise est utilisée pour effectuer un achat. Chaque ligne de la table `issuing_authorizations` stocke des données à propos de cet objet. Ces mêmes informations peuvent être récupérées via l’API et sont disponibles dans le [Dashboard Stripe](https://dashboard.stripe.com/test/issuing/authorizations). Veuillez noter que le champ [request history](https://docs.stripe.com/api/issuing/authorizations/object.md#issuing_authorization_object-request_history) est actuellement indisponible. Chaque autorisation créée sur votre compte est disponible sur Sigma ou Data Pipeline.

La colonne `card_id` de la table stocke l’ID de la carte bancaire utilisée pour effectuer l’achat. Pour en savoir plus sur la carte bancaire ayant initié l’autorisation, vous pouvez joindre cette colonne à la table `issuing_cards`.

Pour accéder aux transactions associées à une autorisation spécifique, vous pouvez joindre la colonne `authorization_id` à la table `issuing_transactions`.
![](https://b.stripecdn.com/docs-statics-srv/assets/issuing-authorization.a2435f764c18d190f70797814eb62878.svg)

La requête suivante calcule le nombre d’autorisations par état d’approbation.

```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
```

| mois       | approuvée | num_authorizations |
| ---------- | --------- | ------------------ |
| 2026-03-01 | false     | 506                |
| 2026-03-01 | véritable | 10 045        |

## Transactions

Un objet [Transaction](https://docs.stripe.com/api/issuing/transactions/object.md) Issuing représente un usage donné d’une carte émise entraînant une entrée ou une sortie de fonds sur votre compte Stripe (par exemple, un achat ou un remboursement). Les informations relatives à ces objets sont stockées dans la table `issuing_transactions`. Vous pouvez récupérer ces mêmes informations via l’API et elles sont également disponibles dans le [Dashboard Stripe](https://dashboard.stripe.com/test/issuing/transactions).

Pour consulter des détails supplémentaires sur la transaction, notamment les frais, vous pouvez accéder à l’[opération sur solde](https://docs.stripe.com/api.md#balance_transaction_object) correspondante. Pour cela, reliez la colonne `balance_transaction_id` à la colonne `id` de la table `balance_transactions`. Les opérations sur solde ne sont pas des objets propres à Issuing. Pour plus d’informations sur l’utilisation des opérations sur solde dans Sigma ou Data Pipeline, reportez-vous à la section [Transactions](https://docs.stripe.com/stripe-data/query-transactions.md) de la documentation.

La colonne `authorization_id` vous permet d’accéder à l’objet [Authorization](https://docs.stripe.com/api/issuing/authorizations/object.md) associé à la transaction en joignant la colonne `id` de la table `issuing_authorizations`. Cela peut fournir des détails supplémentaires sur la façon dont la transaction a été autorisée. La colonne `authorization_id` d’une transaction de délivrance peut être vide en cas de [saisie forcée](https://docs.stripe.com/issuing/purchases/transactions.md#handling-other-transactions) et dans certains cas de [remboursement](https://docs.stripe.com/issuing/purchases/transactions.md).

Vous pouvez également accéder à la carte bancaire et au titulaire de la carte impliqués dans la transaction par les colonnes `card_id` et `cardholder_id`. Les informations relatives à la carte bancaire sont stockées dans le tableau `issuing_cards` et celles du titulaire de la carte dans le tableau `issuing_cardholders`. Les objets [Card](https://docs.stripe.com/api/issuing/cards/object.md) et [Cardholder](https://docs.stripe.com/api/issuing/cardholders/object.md) peuvent fournir des informations supplémentaires à propos de l’initiateur de la transaction.
![](https://b.stripecdn.com/docs-statics-srv/assets/issuing-transaction.64c38a1e0dfaec61d29a8a967a24efc8.svg)

La requête suivante renvoie des informations sur les trois dernières [surcaptures](https://docs.stripe.com/issuing/purchases/transactions.md#handling-other-transactions). Elle joint la table `issuing_authorizations` pour déterminer si la transaction est une surcapture en comparant les montants des deux objets.

```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
```

| jour       | id                  | authorized_amount | captured_amount |
| ---------- | ------------------- | ----------------- | --------------- |
| 2026-03-20 | ipi_orWziM4j7CiRL8J | 150               | 151             |
| 2026-03-20 | ipi_orWziM4j7CiRL8J | 0                 | 1 000      |
| 2026-03-20 | ipi_orWziM4j7CiRL8J | 1450              | 1050            |

En utilisant Sigma ou Data Pipeline avec Issuing, vous avez la possibilité d’agréger les données. L’exemple suivant joint la table `balance_transactions` et agrège chacun des types de frais pour les transactions Issuing par mois.

```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
```

| mois       | fee_type   | net_fees | net_amount  |
| ---------- | ---------- | -------- | ----------- |
| 2026-03-01 | stripe-fee | 590      | 10 000 |
| 2026-04-01 | stripe-fee | 59       | 1 000  |
| 2026-05-01 | stripe-fee | 590      | 10 000 |

## Cartes bancaires

La table `issuing_cards` contient les données d’un objet [Card](https://docs.stripe.com/api/issuing/cards/object.md) donné. Ces mêmes informations sont disponibles via l’API et dans le [Dashboard Stripe](https://dashboard.stripe.com/test/issuing/cards). Le champ [spending controls](https://docs.stripe.com/api/issuing/cards/object.md#issuing_card_object-spending_controls) est actuellement indisponible.

Chaque carte émise possède un objet [Cardholder](https://docs.stripe.com/api/issuing/cardholders.md) associé, auquel il est possible d’accéder en joignant la table `issuing_cardholders` sur la colonne `cardholder_id`.
![](https://b.stripecdn.com/docs-statics-srv/assets/issuing-card.bde34e4a064958836ff7c665a3e71814.svg)

## Titulaires de carte

Les données de l’objet [Cardholder](https://docs.stripe.com/api/issuing/cardholders/object.md) sont stockées dans la table `issuing_cardholders`. Ces mêmes informations peuvent être récupérées via l’API ou le [Dashboard Stripe](https://dashboard.stripe.com/test/issuing/cardholders). Le champ [spending controls](https://docs.stripe.com/api/issuing/cards/object.md#issuing_card_object-spending_controls) est actuellement indisponible.

Cette table peut être jointe à d’autres tables pour fournir des informations sur l’entité qui a initié la transaction ou qui est titulaire de la carte émise.
![](https://b.stripecdn.com/docs-statics-srv/assets/issuing-cardholder.ad6a5836bbdf5b37f497cddace2e1e01.svg)

Dans l’exemple suivant, des informations sont récupérées sur les trois derniers titulaires de cartes créés.

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

| jour       | id                  | Adresse e-mail       | type            |
| ---------- | ------------------- | -------------------- | --------------- |
| 2026-03-01 | ich_orWziM4j7CiRL8J | j.duchamp@exemple.fr | individual      |
| 2026-03-01 | ich_orWziM4j7CiRL8J | entité@exemple.fr    | business_entity |
| 2026-03-01 | ich_orWziM4j7CiRL8J | j.dubois@exemple.fr  | individual      |

### Métadonnées

Les métadonnées de chaque objet Issuing sont stockées dans une table distincte. Le nom de ces tables est formé du nom de la table de l’objet, auquel est ajouté le suffixe `_metadata` (par exemple `issuing_transactions_metadata`). La table de métadonnées possède une clé étrangère pointant vers l’objet correspondant dans la table principale, que vous pouvez utiliser pour joindre les deux tables. Par exemple, pour chaque ligne de la table `issuing_transactions_metadata`, la colonne `issuing_transaction_id` référencera le champ `id` d’une ligne de la table `issuing_transactions`.

L’exemple suivant crée un dictionnaire à partir de la table des métadonnées de la table `issuing_transactions`. Celui-ci est ensuite utilisé pour accéder à la valeur de la clé de métadonnées `'my_label'` pour différentes transactions.

```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
```

| jour       | id                  | montant     | my_label_value |
| ---------- | ------------------- | ----------- | -------------- |
| 2026-03-01 | ipi_orWziM4j7CiRL8J | 2 000  | véritable      |
| 2026-03-01 | ipi_orWziM4j7CiRL8J | 100         | véritable      |
| 2026-03-01 | ipi_orWziM4j7CiRL8J | 10 000 | false          |