Quick Pay

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

note
  • Scan user eWallet QR code with RM terminal or RM Application.

  • Quick Pay Sequence Diagram

Example of Quick Pay#

Request Parameters#

ParameterTypeRequiredDescriptionExample
authCodeStringYesAuth code of QR code/barcode being scanned. Length: 18"134850717797247290"
orderObjectYesObject of order(Refer to explanation below)
extraInfoObjectNoObject of extra Info(Refer to explanation below)
ipAddressStringYesIP address of terminal/application for payment"8.8.8.8"
terminalIdStringNoID of terminal for payment"19382734937293"
storeIdStringYesID of the store"6170506694335521334"

Order object (order):
ParameterTypeRequiredDescriptionExample
idStringYesOrder ID (from Merchant), max: 24"134850717797247290"
titleStringYesOrder title, max: 32"Sales"
detailsStringYesOrder details, max: 600"1 x iPhone X; 2 x SAMSUNG S8"
additionalDataStringYesFor merchant's remark, max 128""
currencyTypeStringYesCurrency notation (currently only support MYR)"MYR"
amountUintYesAmount of order in cent (min RM 0.10 or amount: 10)100

ExtraInfo object (extraInfo)

Only for Gourmet Card Merchant

ParameterTypeRequiredDescriptionExample
typeStringYesMembership"MEMBERSHIP"
referenceStringYesMember Card ID"28158443195878043074"

Example Request

curl --location --request POST "https://sb-open.revenuemonster.my/v3/payment/quickpay" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjIwMTgtMDMtMTMiLCJ0eXAiOiJKV1QifQ.eyJhdWQiOlsiKiJdLCJleHAiOjE1MjE2MjkyNTYsImlhdCI6MTUyMTYyMjA1NywiaXNzIjoiaHR0cHM6Ly9zYi1vYXV0aC5yZXZlbnVlbW9uc3Rlci5teSIsImp0aSI6IkVod0tFRTlCZFhSb1FXTmpaWE56Vkc5clpXNFF5cmYza3EzTDY4QnoiLCJuYmYiOjE1MjE2MjIwNTcsInN1YiI6IkVoUUtDRTFsY21Ob1lXNTBFSlhWemQzd3JhcVRPUklRQ2dSVmMyVnlFSXlKcUl6dnlNUFZjUSJ9.dJknY9MZHLNrKx1p7gZxS0_oA3uXLWplDU1r1dpwxIbmdB6yw4tQBTXKlWArDfKLlBDn6v22_gT5Px7sdCMj7e5M9eRoJoMnoPnslgYpmJJ5kjqAbKU7dUxKb1OzFLrvmtSK9r-FRLVtMFHioWYpwgSvSPBgZ6lAYkUyDzH7aKadFYtQcBuJR0hlq2CXtP0mzbHOeu2q6giONf3E5-XqS8lLRtuHPAbJ7_YFwo0Oe2zc6h05IOocmx_NvBVPfDBnuygTU063h70Q987MYeGDV_Os4N6N_I4b-GoHprEPtmntB1RJPrFrY28hvvoUfDHXHZVXT1GlrsozrkWV4EjbTw" \
--header "X-Signature: sha256 Sty3LNcKA8+WlMHtAgIY+y1xbwnzKsN0UdyKaW+yYIgcTkBAtF7G5Lx251qQITURJ4wiXPDODxhs1nFVmBBing==" \
--header "X-Nonce-Str: VYNknZohxwicZMaWbNdBKUrnrxDtaRhN" \
--header "X-Timestamp: 1528450585" \
--data "{
\"authCode\":\"151261311797136005\",
\"order\":{
\"amount\":100,
\"currencyType\":\"MYR\",
\"id\":\"12344333233404\",
\"title\":\"title\",
\"detail\":\"desc\",
\"additonalData\":\"API Test\"
},
\"extraInfo\": {
\"type\": \"MEMBERSHIP\",
\"reference\": \"28158443195878043074\"
},
\"ipAddress\":\"175.143.101.229\",
\"storeId\":\"10946114768247530\"
}"

Response Parameters#

ParameterTypeDescriptionExample
itemObjectTransaction object(Refer to explanation below)
codeStringSuccessfully call this endpoint. If fail, will return error code object (Refer Appendix 1: Error Codes)"SUCCESS"

Transaction object (item):
ParameterTypeDescriptionExample
storeObjectStore object(Refer to explanation below)
referenceIdStringReference ID (from WeChat server)""
transactionIdStringTransaction ID (from RM server)"152161448229438994"
orderObjectOrder object(Refer to explanation below)
payeeObjectObject of userID made payment (payment sender){"userId": "o74f0wjjzv9eKRu1fccrZswVFnOQ"}
currencyTypeStringCurrency notation (currently only support MYR)"MYR"
platformStringCurrently only support "OPEN_API""OPEN_API"
methodStringRM currently supported methodALL
typeStringCurrently only support "QUICKPAY""QUICKPAY"
statusStringStatus returned from WeChat server"SUCCESS"
regionStringRegion of wallet, "MALAYSIA" or "CHINA""MALAYSIA"
errorString(Refer Appendix: Error Codes){}
createdAtDateTimeCreation date time of transaction"2018-03-21T06:41:22Z"
updatedAtDateTimeLast update date time of transaction"2018-03-21T06:41:22Z"

Store object (store):
ParameterTypeDescriptionExample
idStringStore ID"6170506694335521334"
nameStringStore Name"REVENUE MONSTER"
addressLine1StringStore Address 1"B-5-30, 5th Floor, Block Bougainvillea,"
addressLine2StringStore Address 2"PJU 6A, Lebuhraya SPRINT, 10 Boulevard,"
postCodeStringPostcode of store"47400"
cityStringCity of store"Petaling Jaya"
stateStringState of store"Selangor"
countryStringCountry of store"Malaysia"
countryCodeStringCountry code of store contact number"60"
phoneNumberStringPhone number of store"377334080"
geoLocationObject of [Float]Geo Location (latitude and longtitude) of store{"latitude": 3.1349857, "longtitude": 101.6136659 }
statusStringCurrent status of store"ACTIVE"
createdAtDateTimeCreation date time of store"2018-02-12T08:53:13Z"
updatedAtDateTimeLast update date time of store"2018-02-12T08:53:13Z"

Order object (order):
ParameterTypeDescriptionExample
idStringOrder ID (from Merchant), max: 24"134850717797247290"
titleStringOrder title, max: 32"Sales"
detailsStringOrder details, max: 600"1 x iPhone X; 2 x SAMSUNG S8"
amountUintAmount of order in cent (min RM 0.10 or amount: 10)100

Example Response

{
"item": {
"store": {
"id": "10946114768247530",
"name": "One Utama",
"addressLine1": "200, ABCD",
"addressLine2": "",
"postCode": "48482",
"city": "AMPANG",
"state": "W.P. KUALA LUMPUR",
"country": "MALAYSIA",
"countryCode": "60",
"phoneNumber": "12312341234",
"geoLocation": {
"latitude": 0,
"longitude": 0
},
"status": "ACTIVE",
"createdAt": "2018-06-28T03:24:52Z",
"updatedAt": "2018-06-28T03:24:52Z"
},
"referenceId": "1010014200000026201807306110047699",
"transactionId": "180730103559010434619271",
"order": {
"id": "12344333233404",
"title": "title",
"detail": "desc",
"amount": 100
},
"terminalId": "19382734937293",
"payee": {
"userId": "o74f0wsssZBWis4rJWyDCWmEF-ig"
},
"currencyType": "MYR",
"balanceAmount": 100,
"platform": "OPEN_API",
"method": "WECHATPAY",
"transactionAt": "2018-07-30T10:36:01.515328338Z",
"type": "QUICK_PAY",
"status": "SUCCESS",
"region": "MALAYSIA",
"createdAt": "2018-07-30T10:35:59.233482384Z",
"updatedAt": "2018-07-30T10:36:01.515328459Z"
},
"code": "SUCCESS"
}

Set Your URL in Webhook#

Go to Merchant Portal > Developer > Application > Products

image

For Payment features, you will need to input a webhook URL as below :

image