How to Access Stripe Connect API for Marketplace Payments in Ruby

Integrate Stripe Connect in Ruby

• Include the Stripe gem in your Ruby application by adding it to your Gemfile:

  gem 'stripe'
  

   

• Install the gem using bundler:

  bundle install
  

   

• Require the Stripe library in your application code:

  require 'stripe'
  

Configure Stripe

• Set your Stripe API key and client ID. It's essential to store these securely, for example by using environment variables:

  Stripe.api_key = ENV['STRIPE_SECRET_KEY']
  client_id = ENV['STRIPE_CLIENT_ID']
  

Create Connected Accounts

• To create a connected account for a user on your platform, use the following code example. This process involves redirecting the user to Stripe's onboarding form:

  account = Stripe::Account.create({
    type: 'express'
    business_type: 'individual',
    country: 'US',
  })
  

   

• Generate an account link to redirect the user for onboarding:

  account_link = Stripe::AccountLink.create({
    account: account.id,
    refresh_url: 'https://example.com/reauth',
    return_url: 'https://example.com/return',
    type: 'account_onboarding',
  })
  

   

• Redirect the user to `account_link.url` for completing their Stripe account setup.

Handle Marketplace Charges

• Use Stripe's built-in features to charge a customer and transfer funds to the connected account:

  charge = Stripe::Charge.create({
    amount: 1000,
    currency: 'usd',
    customer: 'cus_xxx',
    transfer_data: {
      destination: 'acct_xxx',
    },
  })
  

   

• To handle marketplace fees, use the `application_fee_amount` attribute:

  charge = Stripe::Charge.create({
    amount: 1000,
    currency: 'usd',
    customer: 'cus_xxx',
    transfer_data: {
      destination: 'acct_xxx',
    },
    application_fee_amount: 123,
  })
  

Use Webhooks for Payment Events

• Implement webhooks to listen for events related to your Stripe account and connected accounts.

   

• Set up a webhook endpoint in your Stripe dashboard and handle the events in your application code. This helps in processing successful transfers, payments, and more:

  webhook_secret = 'whsec_xxx'
  payload = request.body.read
  sig_header = request.env['HTTP_STRIPE_SIGNATURE']
  
  event = nil
  
  begin
    event = Stripe::Webhook.construct_event(
      payload, sig_header, webhook_secret
    )
  rescue JSON::ParserError => e
    status 400
    return
  rescue Stripe::SignatureVerificationError => e
    status 400
    return
  end
  
  case event.type
  when 'charge.succeeded'
    charge = event.data.object
    # Handle successful charge
  when 'account.updated'
    account = event.data.object
    # Handle account updates
  end
  

Testing Your Stripe Integration

• Use Stripe's test mode to experiment with API endpoints, webhooks, and transactions without affecting real funds.

 

• Utilize Stripe's test card numbers and accounts for simulating various scenarios, such as successful payments or declined card transactions.

Additional Resources

• Refer to the [Stripe Connect documentation](https://stripe.com/docs/connect) for comprehensive details on implementing different features.

 

• Utilize the Ruby SDK's documentation for further customization and advanced use-cases.