Earning programs

Get all earning programs available to all or specific customers

List programs

Get a list of all earning programs.

GEThttps://dev-api.joy.so/rest_api/v1/earning

Header parameters

Response

200

OK

Headers

Body

application/json

dataarray of object

Request

JavaScriptCurlPython

const response = await fetch('https://dev-api.joy.so/rest_api/v1/earning', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "data": [
    {
      "showLoyaltyPage": false,
      "social": "text",
      "urlLocation": "text",
      "limitUnit": "text",
      "urlAccount": "text",
      "title": "text",
      "type": "text",
      "signUpGuide": "text",
      "enabledAntiCheat": false,
      "hasLimit": false,
      "action": "text",
      "shopId": "text",
      "event": "text",
      "startDate": "2024-11-21",
      "expired": false,
      "id": "text",
      "changeProgramTitle": false,
      "isDraft": false,
      "rateMoney": "text",
      "createdAt": "2024-11-21T06:31:06.080Z",
      "giftStatus": "text",
      "status": false,
      "updatedAt": "2024-11-21T06:31:06.080Z"
    }
  ]
}

Get an earning program

Retrieve an earning program by its ID.

GEThttps://dev-api.joy.so/rest_api/v1/earning/{programId}

Path parameters

programId*string

Header parameters

Response

200

OK

Headers

Body

application/json

successboolean

programobject

Request

JavaScriptCurlPython

const response = await fetch('https://dev-api.joy.so/rest_api/v1/earning/{programId}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "success": false,
  "program": {
    "id": "text",
    "limitUnit": "text",
    "includeProducts": [],
    "autoRemovePoints": false,
    "earnBy": "text",
    "type": "text",
    "title": "text",
    "productPointsCalculator": {
      "color": "text",
      "type": "text",
      "font": "text"
    },
    "hasLimit": false,
    "typeProductMatch": "text",
    "typeCondition": "text",
    "statusProductPointsCalculator": false,
    "shopId": "text",
    "event": "text",
    "conditions": [
      {
        "field": "text",
        "typeMatch": "text",
        "content": "text"
      }
    ],
    "enableCardPage": false,
    "excludeProducts": [],
    "statusUseCondition": false,
    "status": false,
    "createdAt": "2024-11-21T06:31:06.080Z",
    "updatedAt": "2024-11-21T06:31:06.080Z",
    "appliedCollectionIds": []
  }
}

List all earning programs available to a specific customer

GEThttps://dev-api.joy.so/rest_api/v1/earning-programs-by-customer

Query parameters

Header parameters

Response

200

OK

Headers

Body

application/json

dataarray of object

Request

JavaScriptCurlPython

const response = await fetch('https://dev-api.joy.so/rest_api/v1/earning-programs-by-customer', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "data": [
    {
      "id": "4c34m1vNgXivLXJmrEFB",
      "excludePOSOrderProducts": false,
      "limitUnit": "minute",
      "includeProducts": [],
      "rateMoney": 100,
      "autoRemovePoints": true,
      "earnBy": "price",
      "type": "earning",
      "title": "Place Order",
      "excludeOSOrderProducts": false,
      "priority": 0,
      "hasLimit": false,
      "typeProductMatch": "all",
      "typeCondition": "all",
      "shopId": "umN0f3GKyQC3XS1AwVWg",
      "event": "place_order",
      "conditions": [
        {
          "field": "title",
          "typeMatch": "contains",
          "content": ""
        }
      ],
      "limitInterval": 1,
      "giftStatus": "none",
      "status": true,
      "excludeProducts": [
        {
          "image": {
            "src": "https://cdn.shopify.com/s/files/1/0680/3950/8203/products/gift_card.png?v=1703045153"
          },
          "images": [
            {
              "updated_at": "2023-12-19T23:05:53-05:00",
              "src": "https://cdn.shopify.com/s/files/1/0680/3950/8203/products/gift_card.png?v=1703045153",
              "product_id": 8209413800171,
              "admin_graphql_api_id": "gid://shopify/ProductImage/40721516593387",
              "alt": "Gift card that shows text: Generated data gift card",
              "width": 2881,
              "created_at": "2023-12-19T23:05:53-05:00",
              "variant_ids": [],
              "id": 40721516593387,
              "position": 1,
              "height": 2881
            }
          ],
          "options": [
            {
              "product_id": 8209413800171,
              "values": [
                "$10",
                "$25",
                "$50",
                "$100"
              ],
              "name": "Denominations",
              "id": 10444919046379,
              "position": 1
            }
          ],
          "handle": "gift-card",
          "id": 8209413800171,
          "variants": [
            {
              "inventory_quantity": 0,
              "src": "https://cdn.shopify.com/s/files/1/0680/3950/8203/products/gift_card.png?v=1703045153",
              "price": "10",
              "option3": null,
              "option1": "$10",
              "id": 44438017409259,
              "option2": null,
              "title": "$10"
            }
          ],
          "title": "Gift Card"
        }
      ],
      "statusUseCondition": true,
      "changeProgramTitle": false,
      "expired": false,
      "isDraft": false,
      "appliedPlaceOrderTo": "all",
      "earnPoint": 12,
      "earnPointsTiers": {
        "1Fe1kqHZbE7Alx1GmFEC": {
          "earnPoint": 12
        }
      },
      "createdAt": "2023-12-20T04:16:40.318Z",
      "translateTitle": "وضع الطلب",
      "updatedAt": "2024-08-30T09:50:37.994Z",
      "isEarned": false
    }
  ]
}

Calculate Earning Points

Calculate the points a user would earn for a given activity without actually awarding the points.

POSThttps://dev-api.joy.so/rest_api/v1/earn/calc-points

Header parameters

Body

application/json

products*array of object

shopifyCustomerIdnumber

sourceNameenum

webpos

Response

200

OK

Headers

Body

application/json

dataobject

successboolean

Request

JavaScriptCurlPython

const response = await fetch('https://dev-api.joy.so/rest_api/v1/earn/calc-points', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "products": [
        {
          "id": 8209413964011,
          "quantity": 1,
          "price": 630
        }
      ]
    }),
});
const data = await response.json();

Response

200

{
  "data": {
    "pointsEarn": 264,
    "products": [
      {
        "title": "The Multi-managed Snowboard",
        "vendor": "Multi-managed Vendor",
        "tags": [
          "Premium",
          "Snow",
          "Snowboard",
          "Sport",
          "Winter"
        ],
        "variants": {
          "nodes": [
            {
              "id": "gid://shopify/ProductVariant/44438017671403"
            }
          ]
        },
        "resourcePublicationsV2": {
          "nodes": [
            {
              "publication": {
                "name": "Online Store"
              }
            }
          ]
        },
        "published_scope": "web",
        "id": 8209413964011,
        "type": "",
        "collections": [
          {
            "title": "Automated Collection",
            "published_scope": "web"
          }
        ]
      }
    ]
  },
  "success": true
}

Social Interaction Points

Calculate and award points for a social interaction activity.

POSThttps://dev-api.joy.so/rest_api/v1/earn/interact-social

Header parameters

Body

application/json

shopifyCustomerId*number

earningId*number

Response

200

OK

Headers

Body

application/json

successboolean

dataobject

Request

JavaScriptCurlPython

const response = await fetch('https://dev-api.joy.so/rest_api/v1/earn/interact-social', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "shopifyCustomerId": 7106943058056,
      "earningId": "Y224ET3WNTuVHbEf0nib"
    }),
});
const data = await response.json();

Response

200

{
  "success": true,
  "data": {
    "newPoint": 100
  }
}