POST Create Member Point Transaction

Endpoint

URL: https://api.akaun.com/core2/tnt/dm/crm/membership-points-txn/txn-line/backoffice-ep
Method: POST
Headers:

Authorization: Bearer <token> (or an AccessId + AccessKey pair)
tenantCode: <Tenant Code>
Content-Type: application/json

Headers and credentials are described once, on the authentication page; this page does not repeat them.

Description

This endpoint creates a new point transaction for a member. It requires a JSON payload containing the point transaction. The API responds with the created point transaction and any related information.

Served by MembershipPointsTxnController (@PostMapping /txn-line), body MembershipPointsTxnLineContainer, validated by MembershipPointsTxnLineDataConsistencyObject.

cURL Example

curl -X POST 'https://api.akaun.com/core2/tnt/dm/crm/membership-points-txn/txn-line/backoffice-ep' \
  --header 'Authorization: <JWT Token>' \
  --header 'tenantCode: gadgetsphere' \
  --header 'Content-Type: application/json' \
  --data '{
    "bl_crm_membership_points_txn_line" : {
        "points_value": "100",
        "card_no": "GS-0001234",
        "membership_hdr_guid": "00000000-0000-4000-8000-000000000021",
        "txn_type": "REWARD",
        "point_currency": "GSPTS"
    }
}'

Request Body

Content-Type: application/json

bl_crm_membership_points_txn_line (object, required): Contains the full point transaction details.

All Fields:

guid (UUID)
txn_type
branch_guid (UUID)
company_guid (UUID)
entity_hdr_guid (UUID)
membership_hdr_guid (UUID)
txn_hdr_guid (UUID)
card_no
doc_hdr_guid
doc_line_guid
item_hdr_guid
item_code
date_txn (ZonedDateTime)
date_valid_from (ZonedDateTime)
date_valid_to (ZonedDateTime)
points_type
points_value (BigDecimal)
points_balance (BigDecimal)
remarks
description
client_key
client_source
status (StatusColumn)
revision
vrsn
point_currency_guid (UUID)
property_json (Map<String, Object>)
client_value
point_currency
created_date (ZonedDateTime)
updated_date (ZonedDateTime)
created_by_subject_guid (UUID)
updated_by_subject_guid (UUID)
source
txn_count (Integer)
ocr_doc_hdr_guid (UUID)
ocr_doc_line_guid (UUID)
ctrl_acc_guid (UUID)
client_doc_1
client_doc_2
client_doc_3
client_doc_4
client_doc_5
client_txn_line_primary_key
client_txn_type
display_type
client_doc_amount_1 (BigDecimal)
client_doc_amount_2 (BigDecimal)
client_doc_amount_3 (BigDecimal)
client_doc_type_1
client_doc_type_2
client_doc_type_3
client_doc_type_4
client_doc_type_5

Response

Content-Type: application/json

Sample Response

{
    "code": "OK_RESPONSE",
    "data": {
        "bl_crm_membership_points_txn_line": {
            "guid": "00000000-0000-4000-8000-000000000054",
            "txn_type": "REWARD",
            "branch_guid": null,
            "company_guid": null,
            "entity_hdr_guid": null,
            "membership_hdr_guid": "00000000-0000-4000-8000-000000000021",
            "txn_hdr_guid": null,
            "card_no": "GS-0001234",
            "doc_hdr_guid": null,
            "doc_line_guid": null,
            "item_hdr_guid": null,
            "item_code": null,
            "date_txn": "2025-11-26T03:49:19.78686673Z",
            "date_valid_from": "1900-01-01T00:00:00Z",
            "date_valid_to": "9000-12-31T23:59:59Z",
            "points_type": null,
            "points_value": 100,
            "points_balance": 0,
            "remarks": null,
            "description": null,
            "client_key": null,
            "client_source": null,
            "status": "ACTIVE",
            "revision": "00000000-0000-4000-8000-000000000055",
            "vrsn": null,
            "point_currency_guid": null,
            "property_json": null,
            "client_value": null,
            "point_currency": "GSPTS",
            "created_date": "2025-11-26T03:49:19.786869119Z",
            "updated_date": "2025-11-26T03:49:19.786869739Z",
            "created_by_subject_guid": "00000000-0000-4000-8000-000000000009",
            "updated_by_subject_guid": "00000000-0000-4000-8000-000000000009",
            "source": null,
            "txn_count": null,
            "ocr_doc_hdr_guid": null,
            "ocr_doc_line_guid": null,
            "ctrl_acc_guid": null,
            "client_doc_1": null,
            "client_doc_2": null,
            "client_doc_3": null,
            "client_doc_4": null,
            "client_doc_5": null,
            "client_txn_line_primary_key": null,
            "client_txn_type": null,
            "display_type": "DISPLAY",
            "client_doc_amount_1": null,
            "client_doc_amount_2": null,
            "client_doc_amount_3": null,
            "client_doc_type_1": null,
            "client_doc_type_2": null,
            "client_doc_type_3": null,
            "client_doc_type_4": null,
            "client_doc_type_5": null
        }
    },
    "message": ""
}

Notes

Ensure JWT token is valid and tenant code is correct.
guid values must be unique UUIDs, but can be set to null if you want the system to auto generate a UUID for you.
membership_hdr_guid links to the bl_crm_membership_hdr, is needed for points calculation for member
The backend fills defaults before validating: guid, status, revision, date_valid_from / date_valid_to (open range when absent) and points_value are required after fill; points_balance is computed when null. The line is written and a balance-update job is queued, so current-balance catches up asynchronously.
Same mapping at /txn-line (no suffix); etl-ep and login-entity-ep twins exist. To create a header with several lines in one call use POST …/membership-points-txn (or /txn-with-queue/backoffice-ep).
Sample values are synthetic GadgetSphere data.