Connect で Issuing 残高に資金を追加する

発行されたカードを取引に使用するには、事前にカードに関連付けられた連結アカウントの Issuing 残高に資金を割り当てる必要があります。Issuing 残高にはカードに予約された資金が保持され、利益、入金、他の Stripe プロダクトからの資金から安全に分離されます。

銀行口座から資金供給する

外部口座から Issuing 残高への資金追加には「資金の追加」と「資金の引き出し」という 2 つのオプションがあり、それぞれ設定が異なります。

• 資金の引き出しは、アメリカのデフォルトの資金追加オプションですが、ユーロ圏やイギリスでは利用できません。外部銀行口座を確認する必要があり、通常の場合、送金の遅延が発生します (最大 5 営業日)。このオプションを使用すると、トップアップ (資金追加) の発生元の銀行の管理と特定が可能になります。
• 資金の追加はイギリスとユーロ圏で利用でき、アメリカではベータ機能として利用できます。このオプションを使用すると、ご自身の銀行口座からの資金を Stripe に補充できます。資金の追加では、使用する処理方法 (ACH、電信送金など) によっては同日中に入金を受けることもできます。

curl https://api.stripe.com/v1/tokens \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d "bank_account[country]"=US \
  -d "bank_account[currency]"=usd \
  -d "bank_account[account_holder_name]"="Jenny Rosen" \
  -d "bank_account[account_holder_type]"=individual \
  -d "bank_account[routing_number]"=110000000 \
  -d "bank_account[account_number]"=000000000009

curl https://api.stripe.com/v1/sources \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d type=ach_debit \
  -d currency=usd \
  -d token={{TOKEN_ID}} \
  -d "owner[address][line1]"="510 Townsend Street" \
  -d "owner[address][city]"="San Francisco" \
  -d "owner[address][state]"=California \
  -d "owner[address][country]"=US \
  --data-urlencode "owner[email]"="jenny.rosen@example.com" \
  -d "owner[name]"="Jenny Rosen" \
  -d "owner[phone]"=5554443333

curl https://api.stripe.com/v1/sources/{{SOURCE_ID}}/verify \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d "values[]"=32 \
  -d "values[]"=45

curl https://api.stripe.com/v1/topups \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -H "Stripe-Account: {{CONNECTED_STRIPE_ACCOUNT_ID}}" \
  -d "amount"=2000 \
  -d "currency"="usd" \
  -d "description"="Top-up for week of May 31" \
  -d "destination_balance"="issuing" \
  -d "statement_descriptor"="Top-up" \
  -d "source"="{{SOURCE_ID}}"

連結アカウントの Stripe 残高から資金供給する

Stripe 残高から Issuing 残高に売上を送金するには、Balance Transfer API のプライベートベータに登録する必要があります。

curl https://api.stripe.com/v1/balance_transfers \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -H "Stripe-Account: {{CONNECTED_STRIPE_ACCOUNT_ID}}" \
  -d amount=1000 \
  -d currency=usd \
  -d "source_balance[type]"=payments \
  -d "destination_balance[type]"=issuing

連結アカウントの Stripe 残高からの送金は、アメリカでは 24 時間 365 日利用でき、即座に実行されます。イギリスとユーロ圏では 1 営業日以内に実行されます。これにより、Stripe Payments で得られた売上をすばやく簡単に Stripe Issuing での支払いに利用できます。

利用可能な Stripe 残高を上限とする金額を移動できます。送金が保留されているあいだは、Issuing 残高の資金を利用できません。

残高の取得エンドポイントを使用して、source_type ごとに分類された利用可能な Stripe 残高の金額を取得できます。

早期アクセスをリクエストする

Balance Transfer API へのアクセスは現在、ベータユーザーに限定されています。ベータにご参加いただくには、Issuing の利用者である必要があります。ベータへのアクセスをリクエストするには、Stripe アカウントにログインしてページを更新してください。詳細は Stripe にお問い合わせください。

Issuing 残高を取得する

連結アカウントの現在の Issuing 残高を確認するには、Balance (残高) API の GET エンドポイントを呼び出し、連結アカウントの ID をヘッダーに渡します。

curl https://api.stripe.com/v1/balance \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
"

balance オブジェクトが対応する issuing オブジェクトとともに返されます。issuing オブジェクトには現在の利用可能残高が含まれています。

{
  "object": "balance",
...
    "issuing": {
    "available": [
      {
        "amount": 100,
        "currency": "usd"
      }
    ]
  },
  "livemode": false
}

Issuing 残高を外部口座に入金する

Issuing 残高にある資金は、Payouts (入金) API の POST エンドポイントを使用し、入金の source_balance に issuing を指定することで、連結アカウントの外部の銀行口座に入金できます。

curl https://api.stripe.com/v1/payouts \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d source_balance=issuing \
  -d amount=100 \
  -d currency=usd