Activate

Overview

This endpoint is used to activate a prepaid (loyalty/gift) card and associate it with customer information.

Environments

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

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.
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.
activating	String	Yes	Set to "Y" to activate the card or "N" to not activate.
customerInfo	Object	Yes	A JSON object containing the customer's details. See CustomerInfo Object structure below.

CustomerInfo Object

Parameter	Type	Required	Description
customerType	String	Yes	1: Primary account holder, 2: Alternate, 3: Giver of card.
firstName	String	Yes	Customer's first name.
middleName	String	Yes	Customer's middle name.
lastName	String	Yes	Customer's last name.
address1	String	Yes	Primary address line.
address2	String	Yes	Secondary address line.
city	String	Yes	City name.
state	String	Yes	State or province.
postal	String	Yes	Postal code (must be a valid format for the country).
country	String	Yes	2-character ISO 3166-1 country code.
mailPref	String	Yes	Mail preference. O: Opt-out, I: Opt-in.
phone	String	Yes	Phone number in the format +CCC AAA LLL LLL xEEEE.
isMobile	String	Yes	Y: Yes, N: No.
phonePref	String	Yes	Phone contact preference. O: Opt-out, I: Opt-in.
email	String	Yes	Customer's email address.
emailPref	String	Yes	Email contact preference. O: Opt-out, I: Opt-in.
birthday	String	Yes	Customer's birthday in YYYYMMDD format.
anniversary	String	Yes	Customer's anniversary in YYYYMMDD format.
gender	String	Yes	M: Male, F: Female.

Entry Type Codes

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

Request Example

{
    "clientId": "825429536610058240",
    "loyaltyChannel": "FACTOR4",
    "accountId": "914639258868515",
    "entryType": "K",
    "activating": "Y",
    "customerInfo": {
        "customerType": "1",
        "firstName": "Jon1",
        "middleName": "Mid2",
        "lastName": "Doe3",
        "address1": "295R+VM Settat, Morocco",
        "address2": "Settat,Morocco",
        "city": "Morocco",
        "state": "Settat",
        "postal": "26000",
        "country": "MA",
        "mailPref": "O",
        "phone": "[phone]",
        "isMobile": "N",
        "phonePref": "O",
        "email": "[e-mail]",
        "emailPref": "O",
        "birthday": "20000101",
        "anniversary": "",
        "gender": "M"
    }
}

---

Response Body

The response returns the card's balance information and confirms the customer data that has been stored.

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.accountId	String	The unique identifier for the prepaid card.
data.balances	Array	An array of Balances Object detailing the card's value.
data.customerInfo	Object	The CustomerInfo Object that was saved.

Balances Object

This object represents a single type of value held on the card, such as currency or points.

Parameter	Type	Description
valueCode	String	The currency code (e.g., "USD") or "Points".
amount	Decimal	The total amount of the specified valueCode.
difference	Decimal	The difference in amount from the previous transaction.

Success Response Example

{
    "code": 200,
    "msg": "success",
    "timestamp": "2025-07-24 15:34:05",
    "data": {
        "accountId": "914639258868515",
        "balances": [
            {
                "valueCode": "USD",
                "amount": 1534.10,
                "difference": 0
            },
            {
                "valueCode": "Points",
                "amount": 53.00,
                "difference": 0
            }
        ],
        "customerInfo": {
            "customerType": "1",
            "firstName": "Jon1",
            "middleName": "Mid2",
            "lastName": "Doe3",
            "address1": "295R+VM Settat, Morocco",
            "address2": "Settat,Morocco",
            "city": "Morocco",
            "state": "Settat",
            "postal": "",
            "country": "US",
            "mailPref": "O",
            "phone": "[phone]",
            "isMobile": "N",
            "phonePref": "O",
            "email": "[e-mail]",
            "emailPref": "O",
            "birthday": "20000101",
            "anniversary": "",
            "gender": ""
        }
    }
}