QM Developer Docs
Award Reference

Create Award

Award a binded customer a Gold Convert (GC) and Gold Asset Enhance (GAE) reward. This process will deduct your float account balance to issue Gold Convert (GC) and Gold Asset Enhance (GAE) reward to the customer.

Required the target customer to be binded first. Refer to Bind Customer.

Award a binded customer.

POST /v1/award/create HTTP/1.1
Content-Type: application/json
Key: {API Key}
Sign: {Signature}

{
    "customer": {
        "id": "string"
    },
    "transaction": {
        "reference": "string"
    },
    "amount": 0.00
}

Request

Body

application/json
PropertyTypeDescription
customerobjectThe customer's object to be awarded.
customer.idstringThe unique identifier of binded customer. Refer to Bind Customer.
transactionobjectThe related transaction's object
transaction.referencestringThe reference of the transaction.
amountnumberThe amount to be awarded.

Response

Body

application/json
{
    "code": 0,
    "message": "string"
}
PropertyTypeDescription
codenumberThe response code.

0 - Success.

901 - Insufficient Float Balance.

902 – Insufficient inventory to process this request, please retry on next business day.

1001 - Not allowed to perform this request due to customer has been unbinded.

For other generic code, refer to ENUM Definition.
messagestringThe response message.

© 2023-2024 Quantum Metal Sdn Bhd