Stripe Connect via Affiliate

introduction https //docs stripe com/connect/how connect works allows for you to manage and route payments and payouts between sellers, customers, service providers, and other entities piggybacking on chord's https //docs chord co/affiliate programs 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 { "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 https //chord stoplight io/docs/chord oms/5ca7631abac5c 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 https //dashboard stripe com/connect/settings/profile ‌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 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 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