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

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

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

curl https://api.stripe.com/v1/tokens \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -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_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -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_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d "values[]"=32 \
  -d "values[]"=45

curl https://api.stripe.com/v1/topups \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -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 残高から Issuing 残高に売上を送金するには、Balance Transfer API のプライベートベータに登録する必要があります。

curl https://api.stripe.com/v1/balance_transfers \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -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 残高を確認するには、Balance (残高) API の GET エンドポイントを呼び出し、連結アカウントの ID をヘッダーに渡します。

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

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

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

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

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