Skip to main content
POST
/
{locale}
/
shop
/
auth
/
send-app-link
curl -X POST "https://staging-api.loyalty.lt/lt/shop/auth/send-app-link" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key" \
  -H "X-API-Secret: your_api_secret" \
  -d '{
    "shop_id": 123,
    "phone": "+37060000000",
    "customer_name": "Jonas"
  }'
{
  "success": true,
  "code": 200,
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "message": "App download link sent successfully"
}

Send App Download Link

Send an SMS to a customer with a link to download the Loyalty.lt mobile app. Useful for onboarding new customers at point of sale.

Endpoint

POST /{locale}/shop/auth/send-app-link

Authentication

X-API-Key
string
required
API key from Partners Portal
X-API-Secret
string
required
API secret from Partners Portal

Path Parameters

locale
string
required
Language code for localized SMS message (e.g., en, lt)

Request Body

phone
string
required
Customer’s phone number in international formatFormat: +[country_code][number] (E.164)Example: +37060000000
shop_id
integer
required
Shop ID - identifies which shop location is sending the invite
customer_name
string
Optional customer name for personalized messageMax length: 255 characters
language
string
Language for SMS message (lt or en)Default: Uses locale from URL path

Response

success
boolean
true if SMS was sent successfully
message
string
Confirmation message
curl -X POST "https://staging-api.loyalty.lt/lt/shop/auth/send-app-link" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key" \
  -H "X-API-Secret: your_api_secret" \
  -d '{
    "shop_id": 123,
    "phone": "+37060000000",
    "customer_name": "Jonas"
  }'
{
  "success": true,
  "code": 200,
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "message": "App download link sent successfully"
}

Error Codes

CodeDescription
1100Validation failed (invalid phone format)
1005Partner not authenticated
1607SMS service failed

SMS Content

The SMS contains:
  • Personalized greeting (if customer_name provided)
  • Partner/shop name
  • App Store and Google Play download links
  • Brief description of loyalty benefits

Use Cases

POS Onboarding

Invite customers to join loyalty program during checkout

New Customer Welcome

Send app link after creating loyalty card for new customer