Issue Points

Overview

This endpoint is used to issue loyalty points to a customer's prepaid card. This operation is for adding points, not for reloading monetary value.

Environments

Environment	Protocol	HTTP Method	URL
Sandbox	HTTPS	POST	https://uat.paywizard.biz/ovstrade/openLoyaltyPay/loyaltyIssuance
Production	HTTPS	POST	https://portal.paywizard.biz/ovstrade/openLoyaltyPay/loyaltyIssuance

Headers

Key	Type	Required	Description
Content-Type	String	Yes	Must be application/json.
jwt-token	String	Yes	The transaction token obtained using your developer credentials.
sign	String	Yes	The request signature. See Signature Generation Guide.

Request Body Parameters

Parameter	Type	Required	Description
clientId	String	Yes	Your unique developer ID.
tranOrderNo	String	Yes	The unique order ID for this points issuance transaction, generated by your system.
loyaltyChannel	String	Yes	The prepaid channel provider. See Prepaid Channels for valid values.
accountId	String	Yes	The unique identifier for the prepaid card.
entryType	String	Yes	The method used to input the accountId. See Entry Type Codes below.
amount	String	Yes	The number of loyalty points to add to the card.

Entry Type Codes

Code	Description
B	Barcode
K	Keyed (manually entered)
M	Magnetic Stripe
P	Proximity (NFC/Contactless)

Request Example

{
    "clientId": "825429536610058240",
    "tranOrderNo": "20250401123534801",
    "loyaltyChannel": "FACTOR4",
    "accountId": "914639258868515",
    "entryType": "K",
    "amount": "1"
}

---

Response Body

The response object contains the status of the points issuance transaction.

Parameter	Type	Description
code	Integer	The HTTP status code. 200 indicates a successful request.
msg	String	A human-readable message. success on successful requests.
timestamp	String	The UTC timestamp of the response. Format: YYYY-MM-DD HH:mm:ss.
data	Object	A container for the successful response data. Null on error.
data.mid	String	The merchant ID.
data.paywizardId	String	The unique platform ID for the transaction.
data.checkoutId	String	The unique transaction ID generated by the payment platform.
data.transIndexCode	String	A unique transaction reference code.
data.amount	String	The number of points that were issued.
data.result	Integer	An integer code representing the status of the transaction. See Transaction Status Codes below.

Transaction Status Codes

The result field indicates the immediate outcome of the points issuance request.

Result Code	Description
0	Success
1	Failure
2	Pending / In Progress

Success Response Example

{
    "code": 200,
    "msg": "success",
    "timestamp": "2025-07-24 16:13:25",
    "data": {
        "mid": "202507081058",
        "paywizardId": "10020000080",
        "checkoutId": "933439876320329728",
        "transIndexCode": "100200000807013210966",
        "amount": "10000",
        "result": 0
    }
}