Stripe Connect via Affiliate

3min

Introduction
﻿Stripe Connect allows for you to manage and route payments and payouts between sellers, customers, service providers, and other entities.
Piggybacking on Chord's Affiliate Program infrastructure, Chord allows for the routing and transfer of payments dowsntream to a connected Stripe account by enabling a few store variables in your Chord OMS and by passing the connected Stripe account's account ID (i.e. affiliate_id) into each line item of your order payload.
NOTE: The account ID variable (i.e. to be referred to as affiliate_id) must be added in the metadata object of each line item intended to be paid out to a Stripe Connected Account. This line-item-based set-up allows for multiple line items within an order to be paid for and paid out to separate merchants, if necessary.
Chord OMS Store Variables to Configure
Affiliate




AFFILIATE_COMMISSION_PERCENTAGE
Integer
The default commission amount paid on affiliate orders or line items. (defaults to 10)
AFFILIATE_REVERSALS_ENABLED
enabled or disabled
When enabled, when a refund is processed for an order with an associated affiliate payment, a transfer reversal will occur to reverse the commission payment.(defaults to disabled)
AFFILIATE_TRANSFER_TIME_IN_MINUTES
Integer
Number of minutes after a payment is captured or a return is processed to wait before initiating the transfer or reversal with Stripe Connect. (defaults to 10)
Enabling the Account ID at the Line Item Level
You must acquire your connected account's Account ID prior to this step. See steps below.
In order to associate the appropriate Account ID (known moving forward as affiliate_id) to each line-item within your order, the affiliate_id must be added to each line item's metadata object.
Example Metadata object:
JSON
{
    "metadata": {
        "affiliate_id" : "acct_#######" 
    }
}
{
    "metadata": {
        "affiliate_id" : "acct_#######" 
    }
}
﻿
Example line_items array:
JSON
"line_items": [
        {
            "id": 42790,
            ...
            "metadata": {
                "affiliate_id": "acct_111111122222333"
            },
           ...
      }
]     
"line_items": [
        {
            "id": 42790,
            ...
            "metadata": {
                "affiliate_id": "acct_111111122222333"
            },
           ...
      }
]     
﻿
Example of updating line_item.metadata.affiliate_id in addToCart (using Chord's Update Order Line Item endpoint):
JS
async addToCart(cart, sku, quantity, affiliateCode, brand) {
    const url = `/api/orders/${cart.number}/line_items`

    const payload = {
      line_item: {
        sku: sku,
        quantity: quantity,
        metadata: {}
      }
    }

    if (affiliateCode) {
      payload.line_item.metadata.affilate_id = affiliateCode
    }

    const response = await axiosClient.post(url, payload)
    return response.data
  }
async addToCart(cart, sku, quantity, affiliateCode, brand) {
    const url = `/api/orders/${cart.number}/line_items`

    const payload = {
      line_item: {
        sku: sku,
        quantity: quantity,
        metadata: {}
      }
    }

    if (affiliateCode) {
      payload.line_item.metadata.affilate_id = affiliateCode
    }

    const response = await axiosClient.post(url, payload)
    return response.data
  }
﻿
Creating a Connected Account in Stripe
Proceed with the steps below if your merchant's Connected Account has not yet been created.
To connect a Connected Account in Stripe, you have to create and share an invite link with the merchant by completing the following steps:
﻿
Click on “Connected Accounts” in the left panel of your stripe dashboard and click on “Create” to create a new invite link
Is it recommended to select “Express - Select your Country and click Continue
﻿
﻿
You might need to adjust a few of your settings before being able to click Continue - Navigate to your Settings
﻿
﻿
Stripe has determined some basic recommendations for creating connected accounts, for your users to receive funds on your platform. These recommended settings can be found here.
‌Click Create if you had to make modifications to your settings and click Continue after selecting Express
﻿
Copy the link and share it with the affiliate so that they can follow the steps to connect to stripe.
Once copied and shared, you can select Done.
﻿
Connected Account Side
The merchant will copy and paste the link to a new browser.  Then, the merchant will be taken through the following steps to provide all necessary information about their entity, such as SSN, Name, Nature of business, and Bank account info.
﻿
﻿
﻿
Provide the name of your Company or Individual along with the phone number and email address
Click Continue.  
A verification code will be sent to your phone number provided.
﻿
Fill out pertinent information and click Continue.
Once done, you will be able to access a Dashboard in Stripe and create settings for your payouts
Fetch Connected Account's Stripe Account
Once the merchant has created their stripe account, they will display under Connected Accounts, along with the Status of their application.
﻿
﻿
Once it has a Status of Complete, open that record and copy the Account ID
Miscellaneous
By default, Stripe automatically creates payouts of your available account balance based on the schedule specified in the Dashboard. The schedule depends on your country and whether your business operates in a higher-risk industry.
When a payment is received, it’s initially reflected as a pending balance (less any Stripe fees). This balance becomes available according to your payout schedule. For instance, it takes seven calendar days from receiving payment to being paid out for Stripe accounts on a 7 calendar day schedule.
Most banks deposit payouts into your bank account as soon as they receive them, though some may take a few extra days to make them available. To edit the payout, navigate to your Connected Account and click on the specific account.
﻿
﻿
Click Edit payout schedule
And create your own schedule 
﻿
﻿

Updated 10 Sep 2024

Did this page help you?

Affiliate Programs

Shipping

Affiliate
AFFILIATE_COMMISSION_PERCENTAGE	Integer	The default commission amount paid on affiliate orders or line items. (defaults to 10)
AFFILIATE_REVERSALS_ENABLED	enabled or disabled	When enabled, when a refund is processed for an order with an associated affiliate payment, a transfer reversal will occur to reverse the commission payment.(defaults to disabled)
AFFILIATE_TRANSFER_TIME_IN_MINUTES	Integer	Number of minutes after a payment is captured or a return is processed to wait before initiating the transfer or reversal with Stripe Connect. (defaults to 10)