Skip to main content
POST
/
lbms-ingress
/
pg-lm
/
API
/
PG
/
ReversalPoints
Reversal Points
curl --request POST \
  --url https://loyalife-api.xoxoday.in/lbms-ingress/pg-lm/API/PG/ReversalPoints \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "RelationReference": "jane.doe@example.com",
  "MerchantName": "Amazon",
  "ExternalReference": "3FA85F64-5717-4562-B3FC-2C963F66AFA6",
  "ProgramId": 19
}
'
{
  "results": {
    "IsSucessful": true,
    "ErrorCode": "000",
    "ExceptionMessage": "Success",
    "ReturnObject": true
  }
}
Cancels a previously completed redemption and restores the member’s points balance. Use this when fulfilment fails after points have already been deducted — for example, a hotel booking that couldn’t be confirmed, or a gift card that was not issued. Key behaviours to know:
  • No time limit — reversals can be called at any time after the original redemption, there is no expiry window.
  • One reversal per transaction — calling ReversalPoints a second time with the same ExternalReference will fail. Store the outcome of the first call.
  • ExternalReference is required — this UUID is the only link back to the original RedeemPoints transaction. If you didn’t save it, the reversal cannot be processed.

​
Responses

PathTypeDescription
results.IsSucessfulbooleantrue
results.ErrorCodestring000
results.ExceptionMessagestringSuccess
results.ReturnObjectbooleantrue when reversal is complete and points are restored

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
RelationReference
string
required

Must match the RelationReference from the original RedeemPoints call.

Example:

"jane.doe@example.com"

​
MerchantName
string
required

Must match the MerchantName from the original RedeemPoints call.

Example:

"Amazon"

​
ExternalReference
string<uuid>
required

UUID returned by RedeemPoints. Identifies the redemption being reversed.

Example:

"3FA85F64-5717-4562-B3FC-2C963F66AFA6"

​
ProgramId
integer
required
Example:

19

Response

200 - application/json

Reversal successful — points restored