API Reference

Several behaviours in Loyalife are configurable per program — including points-to-currency conversion rate, token lifetime, OTP expiry duration, OTP attempt limits, redemption thresholds, and rate limits. The values documented here reflect defaults or common configurations. For the exact values that apply to your integration, contact your Xoxoday implementation contact or reach out to support@xoxoday.com.

Base URL

All API endpoints share the same base domain:

https://loyalife-api.xoxoday.in

This is the production base URL. A staging environment is also available — contact your Xoxoday implementation contact for the staging URL specific to your program.

Authentication

Every endpoint (except GenerateAuthToken itself) requires a bearer token in the Authorization header:

Authorization: bearer {token}

See Authentication for details on obtaining and refreshing tokens.

Modules

Module	Path Prefix	APIs
OAuth / Auth	`/lbms-ingress/oauth/`	1
Member (CPD)	`/lbms-ingress/member/`	9
Transaction (TXN)	`/lbms-ingress/transaction-lm/`	6
Payment Gateway (PG)	`/lbms-ingress/pg-lm/`	3

Common Response Shape

All responses use a standard envelope. See Response Format.

{
  "results": {
    "IsSucessful": true,
    "ErrorCode": "000",
    "ExceptionMessage": "Success",
    "ReturnObject": { },
    "Count": 0
  }
}

Common Parameters

Parameter	Type	Description
`ProgramId` / `pintProgramId`	integer	Your loyalty program ID, issued at onboarding.
`RelationReference`	string	The member’s unique identifier (e.g. `jane.doe@example.com`).
`RelationType`	integer	`4` = customer (used in almost all endpoints).
`TransactionCurrency`	string	`"DEFAULT"` unless your program uses a specific currency code.

⌘I

Overview

Core Concepts

Authentication

Member Management

OTP

Transactions

Points Redemption

API Reference

Base URL

Authentication

Modules

Common Response Shape

Common Parameters

​Base URL

​Authentication

​Modules

​Common Response Shape

​Common Parameters

Base URL

Authentication

Modules

Common Response Shape

Common Parameters