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

3. Show banner widget

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.

Note:

When you add the Custom Program Promotion block to your theme, the banner display behavior depends on how many programs are active and whether a Program ID is provided.


Case 1: You have only one active custom programs

If your store has only one active program, you do not need to enter a Program ID. The app will automatically detect the active program and display its banner message.


Case 2: You have many active custom programs

  • If you add a specific Program ID, the Koin block will display only the banner of the program matching that Program ID.


  • If you don't add a specific Program, the Koin block will show all active program banner widgets in a carousel format and you can click the previous / next buttons to view through all available banners.



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: 02/01/2026

Was this article helpful?

Share your feedback

Cancel

Thank you!