Woosage50 API

Woosage50 API

Introduction

Woosage50 has its own REST API that is used by the Woosage50 Service to transfer data between the website and Sage.

The Woosage50 API is an extension of the WordPress API and uses the endpoint https://WEBSITE-URL/wp-json/woosage/v1/ where WEBSITE-URL is the URL of the website where the Woosage50 plugin is installed.

The API was developed to replace the use of the WooCommerce API to ensure only the relevant data is being transmitted, in order to speed up processing and place less of a burden on the website. It performs a wide range of functions relating to orders processing, stock updates and products, using the HTTP GET and POST methods. 

Note: The Woosage50 API does not use the PUT, PATCH or DELETE HTTP methods

Authentication

In order for the Woosage50 Service to access the API it has to be authenticated each time it is used using API keys passed with each call. There are two keys that are created in WooCommerce (see this article) and then stored in an encrypted configuration file that is used by the Woosage50 Service and supplied during installation.

The default method of of authentication (i.e. how the keys are passed to, and authenticated by, the website) is referred to as OAUTH 1.0, whereby the keys are encoded and passed in the Request Headers.  Alternatively, the keys can be passed as  an encoded parameter.

The Woosage50 API offers a basic authentication method that can be used where the server or website security settings prevent the above being used. This method can either encode the keys as a username & password string in the headers or pass the keys as parameters. 

The authentication method and means of passing the keys is held in an encrypted config file that is created prior to the installation by the Woosage Support team and once set this should not require changing unless the website is moved to another server or security settings are changed,

Errors

As mentioned above, REST API errors should only occur when changes are made to the server or website security settings. However, if the service or website is unavailable then REST API error 10026 may occur.  The details of the cause of the error will be reported in the log and via email with the following message.

There was a REST API error. If this persists please contact Woosage Support.

The error may be temporary (i.e. the website is down) and may resolve itself during subsequent processing cycles. If not, then support@woosage.com giving details of full error message, including the details of the cause.



    • Related Articles

    • Woosage Invoice Matching

      Woosage has always matched the website customer payments to sales invoices in Sage, when the invoice has been created by Woosage. However, when the invoice has been created from a sales order the payment created when the invoice is posted is a ...

    • Woosage50 Website Cache Issues

      Woosage50 has a REST API that the Woosage50 Service uses to transfer data to and from the website via the Woosage50 plugin and it is important that the API is not cached by your website. Websites can cache pages and other data at the server level or ...

    • Issues with the Woosage50Service Connecting to the Website

      Occasionally, we encounter issue when the Woosage50 Service tires to connect to the website, due to website security settings. Common causes and solutions are: Website or host server blocks API request – This could be caused by one of the following: ...

    • Next Release

      The next release is currently in Development and is targeted for release before the end of December 2025. On release, this the Latest Release article will be updated with the plugin and service version numbers. Availability of the release by the ...

    • Woosage50 Subscriptions

      Woosage subscription are created using Zoho Subscriptions, which links to our accounting system Zoho Books ( both third-party applications), which automatically deals with collecting payments and emailing invoices and ensures continuous operation of ...