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

Transfers from your connected account’s Stripe balance are instant and available 24x7 in the US, or take 1 business day in the UK and euro area countries. This allows you to quickly and easily utilize earned funds from Stripe Payments for spend with Stripe Issuing.

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

Use the retrieve balance endpoint to get your available Stripe balance amounts broken down by source_type.

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

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