Quick Pay

Quick Pay allows businesses to accept payments from customers using a mobile app or QR code. With Revenue Monster's Quick Pay, customers can simply scan a QR code displayed by the merchant, and then make a payment using their preferred payment method such as credit card, debit card, or e-wallet. This process is quick, easy, and secure, allowing businesses to accept payments from their customers with minimal effort.

info

Quick Pay is an offline payment method and it's subscription will based on offline subscription rate.

Standard Quick Pay

Method : POST
URL : https://open.revenuemonster.my/v3/payment/quickpay
Sandbox URL : https://sb-open.revenuemonster.my/v3/payment/quickpay

Request Parameters

Parameter	Type	Validation	Required	Description
`authCode`	String		Yes	Auth code of QR code/barcode being scanned
`ipAddress`	String	IPV4 / IPV6	Yes	IP address of terminal/application for payment
`storeId`	String		Yes	Revenue Monster Store ID
`order.id`	String	Length(24)	Yes	Order ID
`order.title`	String	Length(32)	Yes	Order Title
`order.currencyType`	String	ENUM("MYR")	Yes	Order Currency Type ( currently supported MYR only)
`order.amount`	Uint64		Yes	Order Amount
`order.detail`	String	Length(600)	No	Order Detail
`order.additionalData`	String	Length(128)	No	Order Additional Data

Example Request
{
    "authCode": "134850717797247290",
    "storeId": "6170506694335521334",
    "ipAddress": "8.8.8.8",
    "order": {
        "id": "ODR-20230513-1001",
        "title": "Payment via OpenAPI",
        "currencyType": "MYR",
        "amount": 1000,
        "detail": "",
        "additionalData": "",
    },
}

Response Parameters

Parameter	Type	Validation	Description
`item`	JSON	Transaction Object	Transaction response
`code`	String	ENUM("SUCCESS")	Determine request have success
`error.code`	String		Error code
`error.message`	String		Error message
`error.debug`	String		Debug message ( sandbox only )

Quick Pay + Voucher

About voucher redemption flow

Voucher can be generated as a QRCode for scanning the voucher code, so we suggest to scan the voucher qrcode first then only go for the wallet's qrcode.

Method : POST
URL : https://open.revenuemonster.my/v3/payment/quickpay
Sandbox URL : https://sb-open.revenuemonster.my/v3/payment/quickpay

Request Parameters

Parameter	Type	Validation	Required	Description
`authCode`	String		Yes	Auth code of QR code/barcode being scanned
`ipAddress`	String	IPV4 / IPV6	Yes	IP address of terminal/application for payment
`storeId`	String		Yes	Revenue Monster Store ID
`order.id`	String	Length(24)	Yes	Order ID
`order.title`	String	Length(32)	Yes	Order Title
`order.currencyType`	String	ENUM("MYR")	Yes	Order Currency Type ( currently supported MYR only)
`order.amount`	Uint64		Yes	Order Amount
`order.detail`	String	Length(600)	No	Order Detail
`order.additionalData`	String	Length(128)	No	Order Additional Data
`voucher.code`	String		No	Revenue Monster Voucher Code

Example Request
{
    "authCode": "134850717797247290",
    "storeId": "6170506694335521334",
    "ipAddress": "8.8.8.8",
    "order": {
        "id": "ODR-20230513-1001",
        "title": "Payment via OpenAPI",
        "currencyType": "MYR",
        "amount": 1000,
        "detail": "",
        "additionalData": "",
    },
    "voucher": {
      "code": "haYkAch3VN"
    }
}

Response Parameters

Parameter	Type	Validation	Description
`item`	JSON	Transaction Object	Transaction response
`code`	String	ENUM("SUCCESS")	Determine request have success
`error.code`	String		Error code
`error.message`	String		Error message
`error.debug`	String		Debug message ( sandbox only )

Quick Pay + Spending Loyalty

About QRCODE Type

You will receive extra parameteres in the transaction response and you will need to print the generate the qrcode and print it out in receipt so the customer able to use their loyalty program to retrieve the spending loyalty's points.

Reference: Transaction Object > Spending Loyalty

Method : POST
URL : https://open.revenuemonster.my/v3/payment/quickpay
Sandbox URL : https://sb-open.revenuemonster.my/v3/payment/quickpay

Request Parameters

Parameter	Type	Validation	Required	Description
`authCode`	String		Yes	Auth code of QR code/barcode being scanned
`ipAddress`	String	IPV4 / IPV6	Yes	IP address of terminal/application for payment
`storeId`	String		Yes	Revenue Monster Store ID
`order.id`	String	Length(24)	Yes	Order ID
`order.title`	String	Length(32)	Yes	Order Title
`order.currencyType`	String	ENUM("MYR")	Yes	Order Currency Type ( currently supported MYR only )
`order.amount`	Uint64		Yes	Order Amount
`order.detail`	String	Length(600)	No	Order Detail
`order.additionalData`	String	Length(128)	No	Order Additional Data
`loyalty.type`	String	ENUM("QRCODE", "PHONENUMBER", "ID")	No	Loyalty type
`loyalty.memberId`	String	Required when type="ID"	Conditional	Loyalty Member's ID
`loyalty.countryCode`	String	Required when type="PHONENUMBER"	Conditional	Loyalty Member's Country Code
`loyalty.phoneNumber`	String	Required when type="PHONENUMBER"	Conditional	Loyalty Member's Phone Number

Example Request
{
    "authCode": "134850717797247290",
    "storeId": "6170506694335521334",
    "ipAddress": "8.8.8.8",
    "order": {
        "id": "ODR-20230513-1001",
        "title": "Payment via OpenAPI",
        "currencyType": "MYR",
        "amount": 1000,
        "detail": "",
        "additionalData": "",
    },
    "loyalty": {
      "type": "PHONENUMBER",
      "countryCode": "60",
      "phoneNumber": "103403660"
    }
}

Response Parameters

Parameter	Type	Validation	Description
`item`	JSON	Transaction Object	Transaction response
`code`	String	ENUM("SUCCESS")	Determine request have success
`error.code`	String		Error code
`error.message`	String		Error message
`error.debug`	String		Debug message ( sandbox only )

Quick Pay + Membership Card

info

Currently available membership card only Alipay's Gourmet Card ( 马来西亚美食优惠卡 )

Verify Membership Card

Request Parameters Method : POST
URL : https://open.revenuemonster.my/v3/membership/verify
Sandbox URL : https://sb-open.revenuemonster.my/v3/membership/verify

Request Parameters

Parameter	Type	Validation	Required	Description
memberCardId	String		Yes	Alipay's Member Card ID
storeId	String		Yes	Store ID

Example Request
{
  "memberCardId": "28158443195878043074",
  "storeId": "4949529109748431621"
}

Response Parameters

Parameter	Type	Validation	Description
`code`	String	ENUM("SUCCESS")	Determine request have success
`error.code`	String		Error code
`error.message`	String		Error message
`error.debug`	String		Debug message ( sandbox only )

Quick Pay

Method : POST
URL : https://open.revenuemonster.my/v3/payment/quickpay
Sandbox URL : https://sb-open.revenuemonster.my/v3/payment/quickpay

Request Parameters

Parameter	Type	Validation	Required	Description
`authCode`	String		Yes	Auth code of QR code/barcode being scanned
`ipAddress`	String	IPV4 / IPV6	Yes	IP address of terminal/application for payment
`storeId`	String		Yes	Revenue Monster Store ID
`order.id`	String	Length(24)	Yes	Order ID
`order.title`	String	Length(32)	Yes	Order Title
`order.currencyType`	String	ENUM("MYR")	Yes	Order Currency Type ( currently supported MYR only)
`order.amount`	Uint64		Yes	Order Amount
`order.detail`	String	Length(600)	No	Order Detail
`order.additionalData`	String	Length(128)	No	Order Additional Data
`extraInfo.type`	String		No	Extra Type "MEMBERSHIP"
`extraInfo.reference`	String		No	Membership Card ID

Example Request
{
    "authCode": "134850717797247290",
    "storeId": "6170506694335521334",
    "ipAddress": "8.8.8.8",
    "order": {
        "id": "ODR-20230513-1001",
        "title": "Payment via OpenAPI",
        "currencyType": "MYR",
        "amount": 1000,
        "detail": "",
        "additionalData": "",
    },
    "extraInfo": {
      "type": "MEMBERSHIP",
      "reference": "28158443195878043074"
    }
}

Response Parameters

Parameter	Type	Validation	Description
`item`	JSON	Transaction Object	Transaction response
`code`	String	ENUM("SUCCESS")	Determine request have success
`error.code`	String		Error code
`error.message`	String		Error message
`error.debug`	String		Debug message ( sandbox only )

Quick Pay

Standard Quick Pay​

Quick Pay + Voucher​

Quick Pay + Spending Loyalty​

Quick Pay + Membership Card​

Verify Membership Card​

Quick Pay​

Standard Quick Pay

Quick Pay + Voucher

Quick Pay + Spending Loyalty

Quick Pay + Membership Card

Verify Membership Card

Quick Pay