Referral

Use Rest API to retrieve the shortened link for refferal

Get referral link

post

Header parameters

X-Joy-Loyalty-App-Keystringoptional

Example: {{appKey}}

X-Joy-Loyalty-Secret-Keystringoptional

Example: {{secretKey}}

Body

emailstringrequired

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://dev-api.joy.so/rest_api/v1/referral/getLink' \
  --header 'Content-Type: application/json' \
  --data '{
    "email": "[e-mail]"
  }'

200

200

{
  "data": {
    "urlReferral": "https://joy-dev.com/i/Ln2M"
  }
}

OK

Get list refer by shopify customer id

get

Path parameters

shopifyCustomerIdstringrequired

Header parameters

X-Joy-Loyalty-App-Keystringoptional

Example: {{appKey}}

X-Joy-Loyalty-Secret-Keystringoptional

Example: {{secretKey}}

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://dev-api.joy.so/rest_api/v1/referral/{shopifyCustomerId}'

200

200

{
  "data": [
    {
      "id": "J9JT65z3Ne8vHUo1lItr",
      "referralCustomerEmail": "[e-mail]",
      "email": "h*****[e-mail],",
      "couponCode": "JOY-02Q47LXBY1OJ",
      "customerId": "EFqXuCw5jszwXCJ5N6b2",
      "statusReferral": "pending_referral",
      "createdAt": "2024-09-22T17:02:26.394Z",
      "updatedAt": "2024-09-22T17:02:26.394Z"
    },
    {
      "id": "A8JT65z3Ne8cHUo1lItr",
      "referralCustomerEmail": "[e-mail]",
      "email": "a*****[e-mail],",
      "couponCode": "JOY-02Q47LXBY1OJ",
      "customerId": "EFqXuCw5jszwXCJ5N6b2",
      "statusReferral": "complete_referral",
      "createdAt": "2024-08-22T17:02:26.394Z",
      "updatedAt": "2024-08-22T17:02:26.394Z"
    },
    {
      "id": "9OJT65z3Ne8cHUo1lItr",
      "referralCustomerEmail": "[e-mail]",
      "email": "b*****[e-mail],",
      "couponCode": "JOY-02Q47LXBY1OJ",
      "customerId": "EFqXuCw5jszwXCJ5N6b2",
      "statusReferral": "cancel_referral",
      "createdAt": "2024-07-22T17:02:26.394Z",
      "updatedAt": "2024-07-22T17:02:26.394Z"
    }
  ],
  "count": 3,
  "pageInfo": {
    "hasPre": false,
    "hasNext": false
  }
}

OK

Get total redeemed coupons and points earned from referrals

get

Path parameters

shopifyCustomerIdstringrequired

Header parameters

X-Joy-Loyalty-App-Keystringoptional

Example: {{appKey}}

X-Joy-Loyalty-Secret-Keystringoptional

Example: {{secretKey}}

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://dev-api.joy.so/rest_api/v1/referral/summary/{shopifyCustomerId}'

200

200

{
  "data": {
    "totalRedeemCoupon": 1,
    "totalPointEarnRefer": 2720
  }
}

OK