Dotix

This plugin will enable the connection between your app and WooCommerce orders for digital credits usage. It can be used to check the remaining credits in one order, or consume them.

Usage

Redirect to your app link on order paid page, carring on the order key.

Let’s assume the order_key=wc_order_xQhmRjJ7, your app URL is https://app.EXAMPLE.com/refill, your WordPress URL is https://EXAMPLE.com/

1. On the order Thank You page, show a button Go back to app.EXAMPLE.

2. In https://app.EXAMPLE.com/refill, call https://EXAMPLE.com/wp-json/dotix/v1/order/wc_order_xQhmRjJ7 with $_POST[ 'num' ] = 'max', assume the consumed credits is 42 in returned JSON.

3. Add 42 credits into the corresponding user account.

REST APIs

1) Show balance:
Method: GET
URL: https://EXAMPLE.com/wp-json/dotix/v1/order/wc_order_xQhmRjJ7
Return: {"_res":"ok", "order_id":45, "status":"completed", "balance":"142"}
// NOTE: only the order with status=completed can be consumed credits.

2) Consume 100 credits:
Method: POST
URL: https://EXAMPLE.com/wp-json/dotix/v1/order/wc_order_xQhmRjJ7
Data: [ 'num' => 100 ]
Return: {"_res":"ok", "order_id":45, "consumed":"100", "balance":"42"}

3) Consume all credits:
Method: POST
URL: https://EXAMPLE.com/wp-json/dotix/v1/order/wc_order_xQhmRjJ7
Data: [ 'num' => 'max' ]
Return: {"_res":"ok", "order_id":45, "consumed":"42", "balance":"0"}

For all errors, will return {“_res”:”err”, “_msg”:”error_msg_tag or content”}

Order Status

If an order contains only items that have valid credit in product detail, once the order is paid, the status will change to completed automatically instead of processing.

The reason to do this is because some unpaid getways (Bank Wire, Cheque, Cash on delivery) will have status processing once the order is placed while not paid. Thus we can’t use processing to detect if the order is paid or not.

To make the credits in the orders with the unpaid gateways available, please update the order status to completed.

Error Message Tag In REST API

Error code: wrong_hash
Description: The order key doesn’t match any order.

Error code: wrong_status
Description: The order isn’t in processing/completed status, maybe not paid yet?

Error code: lack_of_param
Description: Need to specify the ammount to consume. Either numeric or a fixed string max.

Error code: lack_of_bal
Description: Not enough balance left in this order.

1.5

• Bypassed version check to speed up WP v6.

1.4 – Aug 14 2020

• WordPress v5.5 REST compatibility.

1.3.1 – Apr 17 2020

• Typo in REST error tag code.

1.3 – Apr 17 2020

• Consume REST API now used JSON for results.

1.2.3 – Oct 2 2019

• GUI CSS tweaks.

1.2.2 – Oct 2 2019

• Appended CSS class to frontend elements.

1.2.1 – Oct 1 2019

• Compatibility when products are removed.

1.2 – Oct 1 2019

• Settings for barcode on/off and size.
• Settings for credit name.

1.1.1 – Sep 26 2019

• [GUI] Minor style changes.

1.1 – Aug 23 2019

• [App] Support DotixApp connection.

1.0 – Aug 20 2019

• 🎉 Initial Release.