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

カードの使用が許可された法人または個人を表す Cardholder オブジェクトを作成します。レスポンスには、カード保有者の一意の id が含まれます。

curl https://api.stripe.com/v1/issuing/cardholders \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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 と type (physical または virtual) も含める必要があります。以下の例では、カード保有者の shipping 情報も含まれています。

curl https://api.stripe.com/v1/issuing/cards \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d currency=usd \
  -d type=physical \
  -d cardholder=ich_123 \
  -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 属性または tracking_number 属性を使用します。issuing_card.updated Webhook をリッスンして shipping.status を更新することもできます。更新情報を受け取るには、配送業者が追跡サービスに対応している必要があります。

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

curl https://api.stripe.com/v1/issuing/cards/ic_123 \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d status=active

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

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

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

取引は必ずしもオーソリに関連付けられている必要はありません (キャプチャーの強制実行の場合)。また、取引金額も関連付けられているオーソリ額に一致する必要はありません (partial_capture または over_capture の場合)。

カードネットワークの日次売上処理額を確認するには、issuing_settlement Webhook に登録します。この Webhook を使用して、金額がその日の取引と一致しているかどうかも確認できます。

issuing_settlement.created イベントは、所定日にカードネットワークとの間で売上処理を行う金額を示します。これは、銀行口座から引き落とされる金額と一致します。Stripe は、Issuing 取引と不審請求の申し立てを Settlement オブジェクトに関連付けます。すべての取引が見つかったら、売上処理のステータスに completed のマークを付けます。詳しくは、Settlement API をご覧ください。

特定のカード保有者の残高への影響を把握・追跡するには、売上処理に関連する transaction オブジェクトと Dispute Settlement Detail (不審請求の解決情報) オブジェクトをまとめます。