Printify Integration in Violet Rails

[alis-khadka]

@alis-khadka

SECTION - START

Currency

Printify has two currency settings;

• catalog currency: This is the currency in which we can view different product prices in Printify's catalog.
• billing currency : This is the currency in which the shop owner will be charged by Printify.

We can find further details about it over Printify webpage. LINK 1, LINK 2

The Printify's products API does not provide any details regarding the currency being used. It only returns the price in figures.

So, to overcome this barrier, we would have to manually set the currency, which is being used or has been setup in Printify platform, in Violet-Rails end. It will be saved under a shop api-resource's properties as below; TEST-NET LINK

This currency information will be used to show the prices in products-listing, product-detail, cart and Stripe's checkout page.

Note: For now, we are using USD currency over the test-net.

SECTION - END

@Pralish

SECTION - START

HOW TO RUN PRINTIFY PLUGIN INSTALER SCRIPT

https://github.com/restarone/violet_rails/pull/1557

Export variables

• cd to violet_rails root

Required Variables

• export SHOP_NAME="Restarone"
• export PRINTIFY_API_KEY="your api key"

Optional Variables

• export STRIPE_SECRET_KEY="your stripe secret key"
• export PRODUCTS_PAGE_SLUG="your products page url"
• export BUSINESS_NAME="your business name in printify account"

Run Installer

In development

• docker-compose run --rm -e SHOP_NAME -e PRINTIFY_API_KEY -e STRIPE_SECRET_KEY -e PRODUCTS_PAGE_SLUG -e BUSINESS_NAME solutions_app rails r ./plugins/installers/printify_stripe_e_commerce.rb

In production

• rails r ./plugins/installers/printify_stripe_e_commerce.rb

In test server with dokku

• dokku run -e SHOP_NAME -e PRINTIFY_API_KEY -e STRIPE_SECRET_KEY -e PRODUCTS_PAGE_SLUG -e BUSINESS_NAME <APP_NAME> rails r ./plugins/installers/printify_stripe_e_commerce.rb

Variables

SHOP_NAME:

Name of the printify shop you want to sync to violet rails.

PRINTIFY_API_KEY:

https://github.com/restarone/violet_rails/assets/50227291/22a2853d-1d99-4fc0-8dc8-2a81e31eb67e

STRIPE_SECRET_KEY:

https://github.com/restarone/violet_rails/assets/50227291/1d92065c-c04c-4a45-a656-46017466429c

BUSINESS_NAME:

Business name in your printify account.

https://github.com/restarone/violet_rails/assets/50227291/ce67a088-6412-4c02-8f68-1b2c8392e945

PRODUCTS_PAGE_SLUG:

The url you want for your products list page. Default is 'products'

https://github.com/restarone/violet_rails/assets/50227291/125c9681-84ac-49c6-ab7e-8e6d784abcbe

STORE MANAGEMENT

How to hide product from the store:

https://github.com/restarone/violet_rails/assets/50227291/6698994e-1d33-4073-bc6e-6d18cd88a92c

How to change who pays processing fees (Pass On to customer or Absorb Fees)

If pass_processing_fees_to_customer is set to true, the Convenience fee, ie. the stripe processing fee (2.9% + $0.30) and stripe tax collection charge (0.5% if sales tax enabled) will be passed to customers

https://github.com/restarone/violet_rails/assets/50227291/6b703d35-7b29-437f-b49e-43947cb4e9b1

DEBUGGING

If any feature is not working, please check shop_logs namespace. We store error logs there.

Stuck in publishing state?

• Run sync_printify_products plugin

https://github.com/restarone/violet_rails/assets/50227291/08e24d9f-b816-4cb8-9aa5-376f1771e7f1

How to check if Printify webhooks are created?

• On rails console

PRINTIFY_API_KEY="your api key"

PRINTIFY_HEADERS = {                                             
  "Content-Type" => 'application/json;charset=utf-8',
  "Authorization" => "Bearer #{PRINTIFY_API_KEY}" 
}

shop_id = ApiNamespace.friendly.find('shops').api_resources.first.properties['printify_shop_id']

response = HTTParty.get("https://api.printify.com/v1/shops/#{shop_id}/webhooks.json", headers: PRINTIFY_HEADERS)

JSON.parse(response.body)

SECTION - END

@Ayon95

SECTION - START

SECTION - END

[alis-khadka]

@Pralish @Ayon95

Lets work on above documentation in our respective section whenever we add some contents to it. And, in the end, we can compile the contents and finalize it.