# 決済代行業者向けの Issuing を導入する

決済代行業者向けの Issuing システムを設定します。

[決済代行業者専用モデル](https://docs.stripe.com/issuing/processor-only-issuing.md)を導入する前に、カード保有者に本人確認 (KYC) を行ってください。このモデルでは、[Cardholder オブジェクト](https://docs.stripe.com/api/issuing/cardholders.md)がすべての最終顧客を表します。

## Cardholder オブジェクトを作成する

カードの使用が許可された法人または個人を表す `Cardholder` オブジェクトを作成します。レスポンスには、カード保有者の一意の [id](https://docs.stripe.com/api/issuing/cardholders/object.md?lang=ruby#issuing_cardholder_object-id) が含まれます。

```curl
curl https://api.stripe.com/v1/issuing/cardholders \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "name=Jenny Rosen" \
  --data-urlencode "email=jenny.rosen@example.com" \
  --data-urlencode "phone_number=+18008675309" \
  -d status=active \
  -d type=individual \
  -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"
```

## カードを発行する

前のステップの `id` を渡して、カードを `Cardholder` に発行します。このとき、カードの [currency](https://docs.stripe.com/api/issuing/cards/create.md?lang=ruby#create_issuing_card-currency) と [type](https://docs.stripe.com/api/issuing/cards/object.md?lang=ruby#issuing_card_object-type) (`physical` または `virtual`) も含める必要があります。以下の例では、カード保有者の [shipping](https://docs.stripe.com/api/issuing/cards/create.md?lang=ruby#create_issuing_card-shipping) 情報も含まれています。

```curl
curl https://api.stripe.com/v1/issuing/cards \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d currency=usd \
  -d type=physical \
  -d "cardholder={{ISSUINGCARDHOLDER_ID}}" \
  -d "shipping[name]=Jenny Rosen" \
  -d "shipping[address][line1]=123 Main St" \
  -d "shipping[address][city]=San Francisco" \
  -d "shipping[address][state]=CA" \
  -d "shipping[address][postal_code]=94111" \
  -d "shipping[address][country]=US"
```

## カードを追跡する

カードの配送ステータスを追跡するには、[tracking_url](https://docs.stripe.com/api/issuing/cards/object.md#issuing_card_object-shipping-tracking_url) 属性または [tracking_number](https://docs.stripe.com/api/issuing/cards/object.md#issuing_card_object-shipping-tracking_number) 属性を使用します。`issuing_card.updated` Webhook をリッスンして [shipping.status](https://docs.stripe.com/api/issuing/cards/object.md#issuing_card_object-shipping-status) を更新することもできます。更新情報を受け取るには、配送業者が追跡サービスに対応している必要があります。

## カードを有効化

`shipping.status` が `delivered` であることを示す Webhook を受信したら、カードのステータスを更新してカードを有効化します。(この API を使用して、カードを一時的に無効化することもできます。)デフォルトでは、カードは作成時に無効になっています。

```curl
curl https://api.stripe.com/v1/issuing/cards/{{ISSUINGCARD_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \
  -d status=active
```

## オーソリ通知を設定する

`issuing_authorization.request` Webhook を設定して、発行されたカードでオーソリリクエストが行われたときに直ちに通知を受け取るようにします。これにより、オーソリを即座に承認または拒否できるため、完了する前に取引を許可するかブロックするかを制御できます。詳しくは、[Issuing のリアルタイムのオーソリ](https://docs.stripe.com/issuing/controls/real-time-authorizations.md)をご覧ください。

## オーソリの更新の登録

`issuing_authorization.create` Webhook イベントに登録します。この Webhook は、発行されたカードに対して新しいオーソリが作成された場合に通知します。この通知には、オーソリ結果に関する詳細 (オーソリの承認 / 拒否など) が表示されます。情報を参照してオーソリを追跡することはもちろん、エッジケース (承認後のネットワークによる支払い拒否など) を処理したり、オーソリの完了時にカード保有者の残高を保留すべきかどうかの判断を下せます。

## 取引の更新の登録

`issuing_transaction.create` Webhook イベントに登録します。この Webhook は、発行されたカードに対して新しい取引が作成されたときに通知します。これは、Stripe がオーソリの清算記録を受信したときに発生します。清算記録を拒否することはできませんが、必要であれば取引に対して不審請求を申し立てることは可能です。この Webhook を使用して確定された支出を追跡し、それに応じてカード保有者の残高を更新します。

取引は必ずしもオーソリに関連付けられている必要はありません ([キャプチャーの強制実行](https://docs.stripe.com/issuing/purchases/transactions.md?issuing-capture-type=force_capture)の場合)。また、取引金額も関連付けられているオーソリ額に一致する必要はありません ([partial_capture](https://docs.stripe.com/issuing/purchases/transactions.md?issuing-capture-type=partial_capture) または [over_capture](https://docs.stripe.com/issuing/purchases/transactions.md?issuing-capture-type=over_capture) の場合)。

## See also

- [レポート](https://docs.stripe.com/stripe-reports.md)
- [不審請求の申請](https://docs.stripe.com/issuing/purchases/disputes.md)
- [トークン化](https://docs.stripe.com/issuing/cards/digital-wallets.md)
- [3D セキュア (3DS)](https://docs.stripe.com/issuing/3d-secure.md)
- [プログラム管理](https://docs.stripe.com/issuing/program-management.md)