Stripe Accounts

We have added new functionality with Stripe Connect accounts that allows a way of routing payments between a business, customers, and recipients who need to get paid. The new functionality helps create and update accounts using Stripe and stores information inside Paydock for any future payments.

Currently, this functionality is available through the API only but we are in the process to add this to the dashboard as well.

Before you proceed with creating a Stripe account, you need to activate the Stripe gateway at Paydock as described in our API documentation and helpdesk article. Once done, you will get a gateway ID that later will be used for creating accounts.

To start with, set up a Stripe account (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 need to build (from being Stripe-hosted to completely custom) and operational responsibilities such as chargebacks, user support, etc. There are three account types you can use with Connect, each of which is designed for different use cases:

  • Standard

  • Express

  • Custom

To find out more information on the different account types at Stripe, please click here

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.

If you want to be able to transfer funds to connected accounts, you can 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.  Fill in the fields to add a Stripe account;

  7. Click Create after filling the fields;

  8. You have successfully connected the Stripe account to Paydock!

After connecting the account, you will be redirected to the page with added subaccounts. If you wish to move to the page with all connected subaccounts at once, you need to 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