The Ecommerce plugin works with WooCommerce to manage voucher generation and delivery for Asset products. By integrating the plugin with the Voucher API, you can automate key processes such as:

  • Generating vouchers upon successful order completion.
  • Emailing vouchers directly to customers.
  • Tracking order statuses programmatically.

If you aren't using WordPress, you can still integrate with us, Read this article to learn how the Catalogue API works.


In order to run a WordPress plugin, you must have a WordPress site with a WooCommerce plugin. 


NB: All prices are sent to you as VAT exclusive, so you'll need to ensure that your WooCommerce settings are configured to set up the tax percentage and display the price inclusive of tax. For assistance with this, please refer to the WooCommerce documents here.


The plugin operates by listening for the woocommerce_order_payment_status_changed event, which is triggered whenever a WooCommerce order transitions to a paid status.

Once this event occurs:

  1. The plugin initiates a request to the Voucher API to generate a voucher for the purchased product(s).
  2. The API responds with a voucher, which is automatically emailed to the customer.
  3. The order status is updated programmatically based on the API call’s success or failure.

This setup ensures a streamlined process for managing digital assets, minimizing manual intervention.


Installation and Configuration.

Ensure you are the WordPress site administrator before starting the installation process. 

  1. Download the plugin from the WooCommerce store

  2. Install the Plugin on WordPress

    • Go to your WordPress admin dashboard.

    • Under the Plugins section, select "Add New."

    • Upload the plugin file and activate it.

  3. Configure the Plugin:
    • On the Snapplify Ecommerce Management Settings page, find your ‘Authentication Token’ and ‘Product Feed Webhook URL’. Email these details to [email protected].
    • Snapplify will then send you the API key
    • Add the API key provided by Snapplify to authenticate the plugin.
    • Save your settings.

  4. Verify Integration

    • Our team will complete the configuration on our side and respond to confirm that things are running.

    • Test the integration by making a sample purchase. 

    • Confirm that vouchers are issued correctly and that order statuses are updated appropriately.


Handling EFT Payments

If an order is paid via EFT and its status is set to Pending:

  1. Change the order status to Processing via Snapplify. This action triggers the API voucher call.

    Important: If you accidentally change the status to anything else:

    • Revert the status back to Pending.
    • Then change it to Processing again via Snapplify to ensure the API voucher call is re-triggered.
  2. Verify that the voucher has been issued correctly. This can be visible on the notes created within the order.


Error Handling

  • Snapplify Error Status appears if the API call fails due to a network error, configuration issue, or other technical problems.
  • Admin Actions Required:
    • Change the order status to Pending Payment.
    • Change it back to Processing to retry the API call.
Note: These statuses are managed programmatically by the plugin and cannot be manually set by users.


Here’s an overview of how the plugin operates:

  1. Customer Checkout: The customer completes their order using a valid payment method.
  2. Trigger API: WooCommerce triggers the woocommerce_order_payment_status_changed event.
  3. Voucher Generation: The Voucher API generates a voucher for the purchased product(s).
  4. Email Delivery: The voucher is emailed to the customer automatically.
  5. Order Updates: Order notes are updated, and the status transitions to Processing.

Once you have run the Ecommerce plugin, you'll need to manage the plugin through the WooCommerce settings.