Articles on: Installation Guidelines

Create Custom Program with Koin

If you want to set up Credit program with specific conditions, such as:

  • Send credits for specific products, collections or customers
  • Send credits for First order or second order only
  • Send credits when customers create new account

Then Custom Program will be the perfect tool to help you design those flows. Koin’s custom program works with Shopify Flows, which give you uncountable scenarios to issue credits.

Here is the detailed instruction to set up a Custom Program

1. Create a custom program in Koin

  • Open Koin app > Program > Custom Program > Create


  • If the pre-built templates are suitable for your case, you can click Use template. If there is no suitable template, click Build your own to start from scratch.
  • On Step 1, fill the necessary information such as: Credit amount, Expired Date (optional), Delay time, Promotion message..
  • On Step 2, you will see the program ID, which will be used later on Shopify Flow


If you use our template, on this step, there is a button to download the pre-built Shopify Flow


Now go to Shopify Flow to create a specific flow to issue credit.

2. Create a Shopify Flow and connect to the program

  • Choose Create workflow if you start from scratch
  • Choose Import if you use Koin template and have already had a template from step 1 above


On Flow setting tab:

  • Click Select a trigger, and then select the trigger that starts the workflow (e.g: Review reward, Customer joined segment, etc)
  • (Optional) Select the condition that must be met before running Issue store credit action
Depending on the scenario, the Trigger and conditions are different. If you don’t know what should be used, contact us for help
  • Select the action to issue store credit
  • Paste the Program ID from Step 1 above here, to connect the Flow with the correct program


3. Run the program and test

Go back to Koin’s setting tab and click Finish > Publish to run the Program


Optional: If you want to show a banner on Cart or product page to notify customers, go to Promotion Widgets setting > Custom program promotion to set up.


Now test the flow and check if the credit is sent properly. You can reach out to us via Chatbox if you need help reviewing the program.

Updated on: 08/08/2025

Was this article helpful?

Share your feedback

Cancel

Thank you!