Stripe Accounts

Managing Stripe Subaccounts and Stripe Connect

Stripe has a feature called Stripe Connect, which enables different types of charges and payouts. Stripe Connect is fully integrated with Paydock. This page describes how to activate and manage subaccounts via the Paydock API. Before you proceed, make sure you have connected Stripe to your Paydock account, either via API or the Paydock dashboard.

To get started, set up a Stripe subaccount (known as a connected account) for each user that receives money on your platform. These accounts are created when a user signs up for your platform. The type of account you choose for your user determines the Stripe integration you'll need to build (from being Stripe-hosted to completely custom) and how operational responsibilities, such as chargebacks, user support, etc., are managed. There are three account types you can use with Connect, each of which is designed for different use cases:

  • Standard
  • Express
  • Custom
To get more information on the different account types available for Stripe Connect, please review this resource from Stripe.

Connect Stripe subaccounts using API 

To create a Stripe account, send this API request POST https://api-sandbox.paydock.com/ v1/gateways/:gateway_id/accounts:
curl --location --request POST 'https://api-sandbox.paydock.com/v1/gateways/:gateway_id/accounts' \
--header 'x-user-secret-key: {{secretkey}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "email": "jenny.rosen@example.com",
    "company_name": "Company Pty LTD",
    "reference": "Ref to Account",
    "business_type": "company",
    "address": {
        "city": "My City",
        "line1": "Address Line 1",
        "line2": "Address Line 2",
        "postal_code": "4920",
        "country": "US"
    },
    "meta": {
        "type": "custom",
        "capabilities": {
            "card_payments": {
                "requested": true
            },
            "transfers": {
                "requested": true
            }
        },
        "company": {
            "registration_number": "664558728"
        }
    }
}

To find out more about the account capabilities, i.e. which payment methods it can process and what information is required, please click here.

To transfer funds to connected accounts, include the "transfers" capability in the "meta" section in the API call. Connected accounts with the "card_payments" capability can directly process credit and debit card charges.

Once you have created a Stripe account with the abovementioned API request, you can use it for running charges based on the previously chosen capabilities. In the "Charge" API call, include the "meta" object where you will specify the connected account ID:

"meta": {
	"stripe_destination_account_id": "acct_1032D82eZvKYlo2C",
	"stripe_destination_amount": 230
}
	

where:

  • "stripe_destination_account_id" is an ID of the existing, connected Stripe account used to create Stripe Connect destination charges (the ID of the Stripe account you created above);
  • " stripe_destination_amount" is an amount to transfer to the destination account without creating an application fee.

Connect Stripe subaccounts through the Paydock dashboard

  1. Log into your Paydock Production or Sandbox account;
  2. Navigate to Services from the menu on the left;
  3. Click on the Actions button near the Stripe gateway;
  4. Choose the Add Subaccount option from the dropdown;
  5. Add a new account by clicking the Add New tab from the top of the page;
  6. Complete all the fields to add a Stripe account;
  7. Click Create after filling in the fields;
  8. You have successfully connected the Stripe subaccount to Paydock!

After connecting the account, you will be redirected to the page with the added subaccounts. To view all connected subaccounts at one time, choose the View Subaccounts option from the Actions menu.

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.

Still need help? Contact Us Contact Us