REQUIREMENTS

This page outlines the key requirements for integrating with the BOGOS app. Please read this page carefully before moving to any other pages.

1. BOGOS app installed

Install BOGOS app: https://apps.shopify.com/freegifts

Please refer to BOGOS' Demo store for all features demo: Demo store

If you need integration in a development environment, contact BOGOS via live chat or email at [e-mail]

2. Integration options

BOGOS provides 2 integration options. Option 1 involves calling the API for integration, while Option 2 involves integrating via BOGOS JS/SDK, which requires installing the package.

2.1. Integration with BOGOS API

• Endpoint API:

https://api.bogos.io/

• Authorization:

You must add the following header to all API requests:

{
   authorization: "Bearer $token",
   verify: ""; //Contact BOGOS for help
}

• Generate token:

You can generate the $token using either jsonwebtoken or jwt-encode. Here’s an example:

const jwt = require('jsonwebtoken');

const payload = {
  integration: "" //Contact BOGOS for help
};

const secretKey = 'secret_key'; //contact bogos for secret_key
const token = jwt.sign(payload, secretKey, {expiresIn: 120})

• Next step:

Once you’ve successfully generated the token, proceed to review the BOGOS API documentation for detailed endpoint references and response structures. This will help you complete the integration logic and ensure your system communicates correctly with BOGOS.

2.2 Integration with BOGOS JS/SDK

3. Hide gift product (cloned product)

You can use tag (bogos-gift) or handle (*-sca_clone_freegift) to hide the cloned product.