Stripe Connect via Affiliate

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 338 false true false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type 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 { "metadata" { "affiliate id" "acct #######" } } example line items array "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) 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 c onnected 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 https //dashboard stripe com/account/payouts 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 https //stripe com/docs/payouts#standard 7 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