Créer des liens de paiement avec Connect

Vous pouvez créer des liens de paiement pour des comptes connectés, ce qui permet d’utiliser plusieurs méthodes pour percevoir les paiements. Vous pouvez utiliser les paiements directs pour créer les liens de paiement directement sur le compte connecté. Vous pouvez aussi les créer sur la plateforme avec des transferts vers le compte connecté en mettant en place des paiements indirects. Vous pouvez également percevoir une commission de plateforme sur ces liens de paiement.

Créer un lien de paiement en utilisant le paiement direct

Pour créer un lien de paiement qui débite directement sur un compte connecté, créez un lien de paiement en étant authentifié comme le compte connecté. Pour que cela fonctionne, vous devez également créer le produit et le tarif du compte connecté.

curl https://api.stripe.com/v1/payment_links \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d "line_items[0][price]"=
{{PRICE_ID}} \
  -d "line_items[0][quantity]"=1

Lorsque vous utilisez le paiement direct, le compte connecté assume les frais Stripe, les remboursements et les contestations de paiement.

Créer un lien de paiement en utilisant le paiement indirect

Pour créer un lien de paiement qui débite sur la plateforme et crée des transferts automatiques vers un compte connecté, créez le lien de paiement en renseignant l’ID du compte connecté comme valeur de transfer_data[destination].

curl https://api.stripe.com/v1/payment_links \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price]"=
{{PRICE_ID}} \
  -d "line_items[0][quantity]"=1 \
  -d "transfer_data[destination]"=
{{CONNECTED_ACCOUNT_ID}}

Pour que cela fonctionne, vous devez également créer le produit et le tarif sur compte de la plateforme. Les transferts automatiques sont réalisés au nom de la plateforme.

Pour les paiements indirects, Payment Links utilise les paramètres de marque du compte de votre plateforme sur la page de paiement. Pour en savoir plus, veuillez consulter la section Personnaliser la marque.

Créer un lien de paiement qui utilise le paiement indirect et on_behalf_of

Vous pouvez également créer un paiement indirect avec le paramètre on_behalf_of défini sur l’ID du compte connecté (par défaut, il s’agit de la plateforme). Le paramètre on_behalf_of détermine l’entité de règlement, ce qui détermine :

• Quel libellé de relevé bancaire est présenté à l’utilisateur final
• Quels adresse et numéro de téléphone sont présentés à l’utilisateur final
• Quelle devise de règlement est utilisée pour le paiement
• Quelle marque le client voit sur la page de paiement

curl https://api.stripe.com/v1/payment_links \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price]"=
{{PRICE_ID}} \
  -d "line_items[0][quantity]"=1 \
  -d on_behalf_of=
{{CONNECTED_ACCOUNT_ID}} \
  -d "transfer_data[destination]"=
{{CONNECTED_ACCOUNT_ID}}

Traiter les commandes passées via les liens de paiement

Une fois qu’un utilisateur a payé via votre lien de paiement, vous devez activer vos comptes connectés pour le traitement, si nécessaire.

Configurez un endpoint de webhook dans le Dashboard.

Créez ensuite un endpoint HTTP sur votre serveur pour surveiller les paiements effectués. Veillez à remplacer la clé secrète du endpoint (whsec_...) de cet exemple par votre propre clé.

# Using Sinatra.
require 'sinatra'
require 'stripe'

set :port, 4242

# Set your secret key. Remember to switch to your live secret key in production.
# See your keys here: https://dashboard.stripe.com/apikeys
Stripe.api_key = 
'sk_test_BQokikJOvBiI2HlWgH4olfQ2'

# If you are testing your webhook locally with the Stripe CLI you
# can find the endpoint's secret by running `stripe listen`
# Otherwise, find your endpoint's secret in your webhook settings in
# the Developer Dashboard
endpoint_secret = 'whsec_...'

post '/webhook' do
  payload = request.body.read
  sig_header = request.env['HTTP_STRIPE_SIGNATURE']

  event = nil

  # Verify webhook signature and extract the event.
  # See https://stripe.com/docs/webhooks#verify-events for more information.
  begin
    event = Stripe::Webhook.construct_event(
      payload, sig_header, endpoint_secret
    )
  rescue JSON::ParserError => e
    # Invalid payload.
    status 400
    return
  rescue Stripe::SignatureVerificationError => e
    # Invalid Signature.
    status 400
    return
  end

  if event['type'] == 'checkout.session.completed'
    session = event['data']['object']
    connected_account_id = event['account']
    handle_completed_checkout_session(connected_account_id, session)
  end

  status 200
end

def handle_completed_checkout_session(connected_account_id, session)
  # Fulfill the purchase
  puts 'Connected account ID: ' + connected_account_id
  puts session.to_s
end

Pour en savoir plus, consultez notre guide d’exécution.