POST
/
v2
/
earn
curl --request POST \
  --url https://vanilla-dev02-loyalty.fabric.zone/api/v2/earn \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "profileId": "67460e74-02e3-11e8-b443-00163e990bdb",
  "entityReference": "Company LIBERTY CENTER",
  "transactionTypeExternalReference": "Supplements",
  "activityTimestamp": "2020-02-08 09:30:26",
  "transactionExternalReference": "123321abc",
  "transactionGrossAmount": 200,
  "checkForDuplicateTransaction": 1,
  "fetchUpdatedMemberPointTotals": 0,
  "totalAmountPaid": 180,
  "discountValue": 20,
  "totalTax": 20,
  "netAmount": 160,
  "issueAuditUser": "Joe",
  "cancelAuditUser": "John",
  "redemptionCode": [
    "67460e74-02e3-11e8-b443-00163e990bdb"
  ],
  "reasonCode": "9393",
  "reasonDescription": "earning item",
  "discounts": [
    {
      "type": "promotion",
      "description": "Black Friday discount",
      "value": 20,
      "id": 23
    }
  ],
  "transactionItems": [
    {
      "grossAmount": 200,
      "totalAmountPaid": 200,
      "taxAmount": 20,
      "netAmount": 180,
      "itemName": "demo item",
      "itemPrice": 90,
      "itemQuantity": 2,
      "SKU": "1123455",
      "UOM": "unit",
      "lineNumber": 0,
      "discounts": [
        {
          "type": "promotion",
          "description": "Black Friday discount",
          "id": 2345,
          "value": 0
        }
      ],
      "couponCodes": [
        "H4B-1000"
      ]
    }
  ],
  "setToPending": false
}'
{
  "status": 201,
  "message": "earned",
  "errors": {},
  "data": {
    "transactionCode": "78660e74-02e3-11e8-b443-00163e911bd2",
    "profileId": "67460e74-02e3-11e8-b443-00163e990bdb",
    "transactionNumber": "LOYALTY-54321",
    "transactionDateTime": "2020-03-20T14:28:23.382748",
    "activityTimestamp": "2020-03-20T14:28:23.382748",
    "totalAmountPaid": 180,
    "totalTax": 20,
    "transactionNetAmount": 160,
    "points": 16,
    "basePoints": 16,
    "bonusPoints": 0,
    "promotionalPoints": 0,
    "currentPointsBalance": 26,
    "reasonCode": "9393",
    "reasonDescription": "earning item",
    "discounts": [
      {
        "type": "promotion",
        "description": "Black Friday discount",
        "id": 2345,
        "value": 20
      }
    ],
    "discountValue": 20,
    "transactionItems": [
      {
        "grossAmount": 200,
        "totalAmountPaid": 200,
        "taxAmount": 20,
        "netAmount": 180,
        "itemName": "demo item",
        "itemPrice": 90,
        "itemQuantity": 2,
        "SKU": "1123455",
        "UOM": "unit",
        "lineNumber": 0,
        "discounts": [
          {
            "type": "promotion",
            "description": "Black Friday discount",
            "id": 2345,
            "value": 0
          }
        ],
        "couponCodes": [
          "H4B-1000"
        ]
      }
    ],
    "rewards": [
      {
        "reward_id": 111,
        "core_rule_id": 2,
        "reward_portion": 10
      }
    ],
    "issueAuditUser": "Joe",
    "cancelAuditUser": "John",
    "deviceId": "D10626",
    "transactionType": "EARN",
    "transactionActivityType": "BASE_POINTS_EARNED",
    "transactionTypeExternalReference": "PURCHASE",
    "transactionExternalReference": "SHOP-7654321",
    "transactionEntityReference": "Liberty_center_store"
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Details required to earn points

​
entityReference
string
required

Name or ID for the store (or entity) where the transaction took place.

Required string length: 1 - 100
Example:

"Company LIBERTY CENTER"

​
transactionTypeExternalReference
string
required

External reference for the transaction type such as purchase, return, or exchange (Configurable as per requirement).

Required string length: 1 - 100
Example:

"Supplements"

​
activityTimestamp
string
required

Activity date (in UTC format). An activity could be enrolling a member, making a transaction, etc.

Example:

"2020-02-08 09:30:26"

​
transactionExternalReference
string
required

Order ID or receipt ID for a transaction (received from the store). It is needed to cancel or return an order.

Required string length: 1 - 100
Example:

"123321abc"

​
transactionGrossAmount
number
required

Gross transaction amount (in currency unit) of the total items earn. For example the gross amount of item1 is 50.00 and gross amount of item2 is 100.00. The transactionGrossAmount is 150.00.

Required range: x >= 0
Example:

200

​
checkForDuplicateTransaction
integer
required

0 indicates the system allows duplicates and 1 indicates there is a validation in place to identity duplicate.

Example:

1

​
fetchUpdatedMemberPointTotals
integer
required

1 indicates the total points are calculated and shown to the member. 0 indicates the total points are not calculated and the member is only notified the earn is successful. Note: The response is faster when the value is 0 because the total points are not calculated on the fly.

Example:

0

​
totalAmountPaid
number
required

Total amount paid for the items. For example, the amount paid for item1 is 100.00 and the amount of item2 is 200.00 so the total amount paid is 300.00.

Example:

180

​
discountValue
integer
required

Discount value on the transaction, if applicable

Example:

20

​
totalTax
number
required

Total tax based on the number of items in the transaction. For example, the tax amount of item1 is 2.00 and tax amount of item2 is 1.00. The totalTax is 3.00.

Example:

20

​
netAmount
number
required

Net transaction amount based on the total items in the transaction, after subtracting taxes and discounts.

Required range: x >= 0
Example:

160

​
profileId
string

Profile ID of the member. In an ecosystem, it acts as a primary ID to keep the various systems (apps, websites, etc.) in sync.

Example:

"67460e74-02e3-11e8-b443-00163e990bdb"

​
issueAuditUser
string | null

Representative who issued the earn transaction

Required string length: 1 - 200
Example:

"Joe"

​
cancelAuditUser
string | null

Representative who cancelled the earn transaction

Required string length: 1 - 200
Example:

"John"

​
redemptionCode
string[] | null

Redemption code to identify and link the rewards used in a specific transaction. This is generated in the response of the Issue Variable Rewards endpoint - POST /api/v1/redeem/reward/issue.

Example:
["67460e74-02e3-11e8-b443-00163e990bdb"]
​
reasonCode
string

Reason code to categorize transactions. A parent company can configure custom codes for their stores as required.

Required string length: 1 - 30
Example:

"9393"

​
reasonDescription
string

When reason codes are not configured, store can make use of the reason description to add notes on the transaction.

Required string length: 1 - 300
Example:

"earning item"

​
discounts
object[]

Represents the discounts on the item.

​
transactionItems
object[]

Details of the items in the transaction.

Transaction details

​
setToPending
boolean
default:false

true: Points in Pending status <br /> false: Points in Active status. <br />Note:The time period for Pending state is configurable.

Response

200
application/json
OK

Metadata for the Earn points response

​
status
integer

Status code of call

Example:

201

​
message
string
default:Exception message

Message corresponding to status code.

Minimum length: 1
Example:

"earned"

​
errors
object

In a successful response, this is always a blank object.

​
data
object

Earn details

Was this page helpful?