Alimenter les soldes Issuing avec Connect

Pour effectuer des transactions avec une carte émise, vous devez d’abord affecter des fonds au solde Issuing du compte connecté associé à cette carte. Le solde Issuing contient les fonds réservés à une carte, et permet de séparer en toute sécurité ces fonds de vos gains, de vos virements et de vos fonds relevant d’autres produits Stripe.

Utiliser les fonds d’un compte bancaire

Pour alimenter un solde Issuing à partir d’un compte externe, deux options s’offrent à vous, chacune correspondant à une configuration différente : l’ajout de fonds par prélèvement et l’ajout de fonds par virement.

• L’ajout de fonds par prélèvement est l’option par défaut aux États-Unis et n’est pas disponible dans l’UE ni au Royaume-Uni. Pour utiliser cette option, vous devez vérifier les comptes bancaires externes, ce qui retarde généralement le transfert des fonds (jusqu’à 5 jours ouvrables). Cette option vous permet de contrôler et d’identifier la banque d’où provient votre recharge.
• L’ajout de fonds par virement est disponible au Royaume-Uni et dans l’UE, et en version bêta aux États-Unis. Cette option vous permet de transférer des fonds vers Stripe depuis votre compte bancaire. Elle peut également vous permettre de recevoir les fonds le jour même, selon le processus utilisé (ACH ou virement bancaire, par exemple).

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

curl https://api.stripe.com/v1/topups \
  -u 
sk_test_VePHdqKTYQjKNInc7u56JBrQ
: \
  -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}}"

Utiliser les fonds du solde Stripe d’un compte connecté

Pour transférer des fonds de votre solde Stripe vers votre solde Issuing, vous devez demander un accès à la version bêta privée de l’API Balance Transfer.

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

Pour les États-Unis, les transferts depuis le solde Stripe de votre compte connecté sont instantanés et disponibles 24 heures sur 24, 7 jours sur 7. Pour le Royaume-Uni et les pays de la zone euro, ils sont effectués en un jour ouvrable. Ainsi, vous pouvez affecter rapidement et facilement les fonds provenant des paiements Stripe à vos dépenses effectuées avec Stripe Issuing.

Vous pouvez modifier le montant dans la limite du solde Stripe disponible uniquement. Tant que le transfert est en attente, les fonds ne seront pas disponibles dans le solde Issuing.

Utilisez l’endpoint de récupération de solde pour obtenir les montants disponibles de votre solde Stripe par source_type.

Demander un accès anticipé

L’accès à l’API Balance Transfer est actuellement limité aux utilisateurs de la version bêta. Seuls les clients Issuing peuvent accéder à la version bêta. Pour demander l’accès, connectez-vous à votre compte Stripe et actualisez la page. Pour en savoir plus, contactez Stripe.

Récupérer un solde Issuing

Pour consulter le solde Issuing actuel d’un compte connecté, appelez l’endpoint GET de l’API Balance en transmettant l’ID du compte connecté dans l’en-tête.

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

Cette opération renvoie l’objet balance avec un objet issuing correspondant, qui inclut le solde disponible actuel :

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

Verser un solde Issuing sur un compte externe

Les fonds d’un solde Issuing peuvent également être virés vers le compte bancaire externe d’un compte connecté à l’aide de l’endpoint POST de l’API Payouts en assignant la valeur issuing au paramètre source_balance du virement.

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