Insert Transaction API

Insert Transaction

curl --request POST \
  --url https://loyalife-api.xoxoday.in/lbms-ingress/transaction-lm/API/Transaction/InsertTransactionData \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "transaction_id": "TXN-2026-001",
  "amount": 1500,
  "transaction_date": "2026-05-11",
  "product_code": "RETAIL001",
  "sub_product_code": "ELECTRONICS",
  "member_relation_reference": "jane.doe@example.com",
  "transaction_type": "DR"
}
'

import requests

url = "https://loyalife-api.xoxoday.in/lbms-ingress/transaction-lm/API/Transaction/InsertTransactionData"

payload = {
    "transaction_id": "TXN-2026-001",
    "amount": 1500,
    "transaction_date": "2026-05-11",
    "product_code": "RETAIL001",
    "sub_product_code": "ELECTRONICS",
    "member_relation_reference": "jane.doe@example.com",
    "transaction_type": "DR"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    transaction_id: 'TXN-2026-001',
    amount: 1500,
    transaction_date: '2026-05-11',
    product_code: 'RETAIL001',
    sub_product_code: 'ELECTRONICS',
    member_relation_reference: 'jane.doe@example.com',
    transaction_type: 'DR'
  })
};

fetch('https://loyalife-api.xoxoday.in/lbms-ingress/transaction-lm/API/Transaction/InsertTransactionData', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://loyalife-api.xoxoday.in/lbms-ingress/transaction-lm/API/Transaction/InsertTransactionData",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'transaction_id' => 'TXN-2026-001',
    'amount' => 1500,
    'transaction_date' => '2026-05-11',
    'product_code' => 'RETAIL001',
    'sub_product_code' => 'ELECTRONICS',
    'member_relation_reference' => 'jane.doe@example.com',
    'transaction_type' => 'DR'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://loyalife-api.xoxoday.in/lbms-ingress/transaction-lm/API/Transaction/InsertTransactionData"

	payload := strings.NewReader("{\n  \"transaction_id\": \"TXN-2026-001\",\n  \"amount\": 1500,\n  \"transaction_date\": \"2026-05-11\",\n  \"product_code\": \"RETAIL001\",\n  \"sub_product_code\": \"ELECTRONICS\",\n  \"member_relation_reference\": \"jane.doe@example.com\",\n  \"transaction_type\": \"DR\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://loyalife-api.xoxoday.in/lbms-ingress/transaction-lm/API/Transaction/InsertTransactionData")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"transaction_id\": \"TXN-2026-001\",\n  \"amount\": 1500,\n  \"transaction_date\": \"2026-05-11\",\n  \"product_code\": \"RETAIL001\",\n  \"sub_product_code\": \"ELECTRONICS\",\n  \"member_relation_reference\": \"jane.doe@example.com\",\n  \"transaction_type\": \"DR\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://loyalife-api.xoxoday.in/lbms-ingress/transaction-lm/API/Transaction/InsertTransactionData")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"transaction_id\": \"TXN-2026-001\",\n  \"amount\": 1500,\n  \"transaction_date\": \"2026-05-11\",\n  \"product_code\": \"RETAIL001\",\n  \"sub_product_code\": \"ELECTRONICS\",\n  \"member_relation_reference\": \"jane.doe@example.com\",\n  \"transaction_type\": \"DR\"\n}"

response = http.request(request)
puts response.read_body

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

{
  "results": {
    "IsSucessful": false,
    "ErrorCode": "E400",
    "ExceptionMessage": "Invalid product code"
  }
}

POST

lbms-ingress

transaction-lm

API

Transaction

InsertTransactionData

Insert Transaction

curl --request POST \
  --url https://loyalife-api.xoxoday.in/lbms-ingress/transaction-lm/API/Transaction/InsertTransactionData \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "transaction_id": "TXN-2026-001",
  "amount": 1500,
  "transaction_date": "2026-05-11",
  "product_code": "RETAIL001",
  "sub_product_code": "ELECTRONICS",
  "member_relation_reference": "jane.doe@example.com",
  "transaction_type": "DR"
}
'

import requests

url = "https://loyalife-api.xoxoday.in/lbms-ingress/transaction-lm/API/Transaction/InsertTransactionData"

payload = {
    "transaction_id": "TXN-2026-001",
    "amount": 1500,
    "transaction_date": "2026-05-11",
    "product_code": "RETAIL001",
    "sub_product_code": "ELECTRONICS",
    "member_relation_reference": "jane.doe@example.com",
    "transaction_type": "DR"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    transaction_id: 'TXN-2026-001',
    amount: 1500,
    transaction_date: '2026-05-11',
    product_code: 'RETAIL001',
    sub_product_code: 'ELECTRONICS',
    member_relation_reference: 'jane.doe@example.com',
    transaction_type: 'DR'
  })
};

fetch('https://loyalife-api.xoxoday.in/lbms-ingress/transaction-lm/API/Transaction/InsertTransactionData', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://loyalife-api.xoxoday.in/lbms-ingress/transaction-lm/API/Transaction/InsertTransactionData",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'transaction_id' => 'TXN-2026-001',
    'amount' => 1500,
    'transaction_date' => '2026-05-11',
    'product_code' => 'RETAIL001',
    'sub_product_code' => 'ELECTRONICS',
    'member_relation_reference' => 'jane.doe@example.com',
    'transaction_type' => 'DR'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://loyalife-api.xoxoday.in/lbms-ingress/transaction-lm/API/Transaction/InsertTransactionData"

	payload := strings.NewReader("{\n  \"transaction_id\": \"TXN-2026-001\",\n  \"amount\": 1500,\n  \"transaction_date\": \"2026-05-11\",\n  \"product_code\": \"RETAIL001\",\n  \"sub_product_code\": \"ELECTRONICS\",\n  \"member_relation_reference\": \"jane.doe@example.com\",\n  \"transaction_type\": \"DR\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://loyalife-api.xoxoday.in/lbms-ingress/transaction-lm/API/Transaction/InsertTransactionData")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"transaction_id\": \"TXN-2026-001\",\n  \"amount\": 1500,\n  \"transaction_date\": \"2026-05-11\",\n  \"product_code\": \"RETAIL001\",\n  \"sub_product_code\": \"ELECTRONICS\",\n  \"member_relation_reference\": \"jane.doe@example.com\",\n  \"transaction_type\": \"DR\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://loyalife-api.xoxoday.in/lbms-ingress/transaction-lm/API/Transaction/InsertTransactionData")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"transaction_id\": \"TXN-2026-001\",\n  \"amount\": 1500,\n  \"transaction_date\": \"2026-05-11\",\n  \"product_code\": \"RETAIL001\",\n  \"sub_product_code\": \"ELECTRONICS\",\n  \"member_relation_reference\": \"jane.doe@example.com\",\n  \"transaction_type\": \"DR\"\n}"

response = http.request(request)
puts response.read_body

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

{
  "results": {
    "IsSucessful": false,
    "ErrorCode": "E400",
    "ExceptionMessage": "Invalid product code"
  }
}

Submits a single loyalty transaction and returns the result synchronously after the Loyalife Rule Engine has evaluated it. The Rule Engine automatically calculates how many points to award based on your program’s configured rules — you do not specify a points amount in the request. Rules can evaluate multiple attributes including transaction amount, product_code, transaction_type, member tier, and any custom attributes defined in your program. If no rule matches the transaction, the transaction succeeds but zero points are awarded — IsSucessful will still be true. Use this for real-time integrations where you need the outcome before responding to the customer. For bulk or end-of-day uploads, use Insert Transaction V2 instead.

Timestamps are in the timezone of your deployment environment. For cloud deployments confirm the timezone with your Xoxoday implementation contact. For on-premise deployments, the server timezone applies.

Responses

200 — Success

Path	Type	Description
`results.IsSucessful`	boolean	`true`
`results.ErrorCode`	string	`000`
`results.ExceptionMessage`	string	`Success`
`results.ReturnObject`	boolean	`true` on successful submission

400 — Invalid Request

Path	Type	Description
`results.IsSucessful`	boolean	`false`
`results.ErrorCode`	string	Error code from the platform
`results.ExceptionMessage`	string	Human-readable reason, e.g. `Invalid product code` — always check this field

Error Codes

Code	ExceptionMessage	Cause
`000`	Success	Transaction accepted and queued for Rule Engine processing
`006`	Insert failed	Transaction could not be inserted
`103`	Member does not exist	`member_relation_reference` not found in the program
`201`	Failed to award points	Points calculation or award step failed
`209`	Transaction reference missing	`transaction_id` not provided
`210`	Request DateTime invalid / missing	`transaction_date` is missing or in the wrong format
`997`	Exception occurred	Unexpected server-side error
`999`	Bad request	Malformed payload or missing required fields

Authorizations

Authorization

string

header

required

JWT obtained from Generate Auth Token. Pass as Authorization: bearer {token}.

Query Parameters

pintProgramId

integer

required

Your loyalty program ID

Example:

19

Body

application/json

transaction_id

string

required

Your unique transaction reference

Example:

"TXN-2026-001"

amount

number

required

Example:

1500

transaction_date

string<date>

required

Example:

"2026-05-11"

product_code

string

required

Product or merchant code as configured in your program

Example:

"RETAIL001"

member_relation_reference

string

required

Example:

"jane.doe@example.com"

transaction_type

string

required

DR for debit (purchase/earn), CR for credit (reversal)

Example:

"DR"

sub_product_code

string

Example:

"ELECTRONICS"

Response

Transaction accepted

⌘I

Overview

Core Concepts

Authentication

Member Management

OTP

Transactions

Points Redemption

Insert Transaction

Responses

Error Codes

Authorizations

Query Parameters

Body

Response

​Responses

​Error Codes

Authorizations

Query Parameters

Body

Response

Responses

Error Codes