# B2B 決済の連携ガイド

Issuing を使用して B2B 決済システムを構築します。

[SaaS プラットフォーム向け組み込みファイナンス](https://stripe.com/guides/introduction-to-embedded-finance)の使用方法に関する入門ガイドをご覧ください。

Stripe [Issuing](https://docs.stripe.com/issuing/how-issuing-works.md) を使って、アメリカの B2B 決済システムを構築します。それにより、担当者、従業員、あるいは請負業者が代理で購入する際に利用できるカードを作成できます。

このガイドでは、以下の方法について説明します。

- Issuing 残高に資金を追加する方法
- 自社用にバーチャルカードを作成する方法
- こうしたカードを使用して Issuing 残高から資金を支出する方法

## Before you begin

1. 登録して [Stripe アカウント](https://dashboard.stripe.com/register)を作成します。
1. ダッシュボードから*サンドボックス* (A sandbox is an isolated test environment that allows you to test Stripe functionality in your account without affecting your live integration. Use sandboxes to safely experiment with new features and changes)環境で [Issuing を有効](https://dashboard.stripe.com/issuing/activate)にします。

## 資金を追加する

カードを使用して資金を使用するには、アカウントの Issuing 残高に資金を追加します。この残高は Issuing に留保された資金を表し、他の Stripe プロダクトからの収入、入金、売上からは安全に切り離されています。

[ダッシュボード](https://dashboard.stripe.com/balance/overview#issuing-summary)から資金を追加できます。

## カード保有者とカードを作成する

### カード保有者を作成する

[Cardholder (カード保有者)](https://docs.stripe.com/api/.md#issuing_cardholder_object) は、Issuing 残高からカードへの資金追加が承認された会社または法人です。`Cardholder` オブジェクトには、カードに表示される [name (名前)](https://docs.stripe.com/api/issuing/cardholders/object.md#issuing_cardholder_object-name) や [billing (請求先)](https://docs.stripe.com/api/issuing/cardholders/object.md#issuing_cardholder_object-billing) 住所 (通常は企業住所) など、関連する詳細が含まれています。

以下の API コールにより、新しい `Cardholder` が作成されます。

```curl
curl https://api.stripe.com/v1/issuing/cardholders \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "name=Company Card" \
  --data-urlencode "email=company@example.com" \
  --data-urlencode "phone_number=+18008675309" \
  -d status=active \
  -d type=company \
  -d "billing[address][line1]=123 Main Street" \
  -d "billing[address][city]=San Francisco" \
  -d "billing[address][state]=CA" \
  -d "billing[address][postal_code]=94111" \
  -d "billing[address][country]=US"
```

Stripe は指定された情報が格納された `Cardholder` オブジェクトを返し、`issuing_cardholder.created` Webhook イベントを送信します。

### カードを作成する

カードを作成し、カードの承認済みユーザーにする `Cardholder` に関連付けます。

以下の例では、[バーチャルカード](https://docs.stripe.com/issuing/cards/virtual.md)の作成方法を示しています。ただし、本番環境では、[物理カード](https://docs.stripe.com/issuing/cards/physical.md)を作成してカード保有者に配送することもできます。

```curl
curl https://api.stripe.com/v1/issuing/cards \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d currency=usd \
  -d type=virtual \
  -d "cardholder={{ISSUINGCARDHOLDER_ID}}"
```

Stripe は `Card` オブジェクトを作成時に返し、`issuing_card.created` Webhook イベントを送信します。

```json
{
  "id": "ic_1NvPjF2SSJdH5vn2OVbE7r0b",
  "object": "issuing.card",
  "brand": "Visa",
  ...
  "status": "inactive",
  "type": "virtual"
}
```

ユーザーがカードを使用できるようにするには、カードを有効化する必要があります。バーチャルカードは、作成に使用した API コールを使用して有効化できますが、物理カードは別途有効化する必要があります。準備ができたら、`status` に `active` のマークを付けてカードを有効化します。

```curl
curl https://api.stripe.com/v1/issuing/cards/ic_1NvPjF2SSJdH5vn2OVbE7r0b \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d status=active
```

この時点で、有効なカードがカード保有者に関連付けられています。カードとカード保有者の情報を確認するには、[Issuing ページ](https://dashboard.stripe.com/issuing/overview)をご覧ください。

```json
{
  "id": "ic_1NvPjF2SSJdH5vn2OVbE7r0b",
  "object": "issuing.card",
  "brand": "Visa",
  ...
  "status": "active",
  "type": "virtual"
}
```

詳細については、以下をご覧ください。

- [バーチャルカード](https://docs.stripe.com/issuing/cards/virtual.md)
- [物理カード](https://docs.stripe.com/issuing/cards/physical.md)
- [Connect で Issuing のダッシュボードを使用する](https://docs.stripe.com/issuing/connect.md#using-dashboard-issuing)
- [API でカードを作成する](https://docs.stripe.com/api/issuing/cards.md)

## カードを使用する

### オーソリを作成する

関連付けられた残高へのカードアクティビティーの影響を確認するには、テストオーソリを生成します。これは、ダッシュボードの **Issuing ページ**か、[Authorization API](https://docs.stripe.com/api/issuing/authorizations.md) に対する以下のコールを使用して実行できます。

```curl
curl https://api.stripe.com/v1/test_helpers/issuing/authorizations \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "card={{ISSUINGCARD_ID}}" \
  -d amount=1000 \
  -d authorization_method=chip \
  -d "merchant_data[category]=taxicabs_limousines" \
  -d "merchant_data[city]=San Francisco" \
  -d "merchant_data[country]=US" \
  -d "merchant_data[name]=Rocket Rides" \
  -d "merchant_data[network_id]=1234567890" \
  -d "merchant_data[postal_code]=94107" \
  -d "merchant_data[state]=CA"
```

承認後、Stripe は[キャプチャー](https://docs.stripe.com/issuing/purchases/transactions.md)を待っている間に `pending` 状態の `Authorization` を作成します。売上のキャプチャーに使用する オーソリの `id` に注意してください。

```json
{"id": "iauth_1NvPyY2SSJdH5vn2xZQE8C7k",
  "object": "issuing.authorization",
  "amount": 1000,
  ...
  "status": "pending",
  "transactions": []
}
```

### 売上をキャプチャーする

以下のコードを使用して売上をキャプチャーします。

```curl
curl -X POST https://api.stripe.com/v1/test_helpers/issuing/authorizations/{{ISSUINGAUTHORIZATION_ID}}/capture \
  -u "<<YOUR_SECRET_KEY>>:"
```

オーソリがキャプチャーされると、Stripe は Issuing の[取引](https://docs.stripe.com/issuing/purchases/transactions.md)を作成し、オーソリの `status` が `closed` に設定されます。

## See also

- [支出管理](https://docs.stripe.com/issuing/controls/spending-controls.md)
- [Issuing のオーソリ](https://docs.stripe.com/issuing/purchases/authorizations.md)
- [Issuing の取引](https://docs.stripe.com/issuing/purchases/transactions.md)
- [Stripe Issuing カードとプラットフォーム向け金融口座を使用する](https://docs.stripe.com/financial-accounts/connect/account-management/issuing-cards.md)
- [取引の不正利用の管理](https://docs.stripe.com/issuing/manage-fraud.md)