faizah

REVENUE GROUP OF COMPANIES Title: revPAY Merchant API

Wisma Revenue Date: 16 Jul 2021 Version: 1.41
No 12, Jalan Udang Harimau 2,
Kepong Business Park, Page 71
51200 Kuala Lumpur

3.20 Signature for Pre-Auth Completion Request

The hash signature is generating with the following fields:

Signature Value = "Merchant Key" + "Revpay Merchant ID" + "Reference Number" + "Completion Amount" +
"Original Reference Number"

Parameter Name Sample Value

Merchant Key 1OoL87PmJQ

Revpay Merchant ID MER00000000001

Reference Number RF201774111

Completion Amount 110.50

Original Reference RF201774100
Number

3.21 Signature for Pre-Auth Completion Response

The hash signature is generating with the following fields:

Signature Value = "Merchant Key" + "Revpay Merchant ID" + "Transaction ID" + "Response Code" + "Reference
Number" + "Completion Amount"

Parameter Name Sample Value

Merchant Key 1OoL87PmJQ

Revpay Merchant ID MER00000000001

Transaction ID RT000000007801

Response Code 00

Reference Number RF201774111

Completion Amount 110.50

REVENUE GROUP OF COMPANIES Title: revPAY Merchant API

Wisma Revenue Date: 16 Jul 2021 Version: 1.41
No 12, Jalan Udang Harimau 2,
Kepong Business Park, Page 72
51200 Kuala Lumpur

3.22 Signature for Installment List Request

The hash signature is generating with the following fields:

Signature Value = "Merchant Key" + "Revpay Merchant ID" + "Amount" + "Currency"

Parameter Name Sample Value

Merchant Key 1OoL87PmJQ

Revpay Merchant ID MER00000000001

Amount 52.40
Currency MYR

3.23 Signature for Installment List Response

The hash signature is generating with the following fields:

Signature Value = "Merchant Key" + "Revpay Merchant ID" + "Amount" + "Installment Bank List"

Parameter Name Sample Value

Merchant Key 1OoL87PmJQ

Revpay Merchant ID MER00000000001

Amount 52.40

Installment Bank List {JSON message}

REVENUE GROUP OF COMPANIES Title: revPAY Merchant API

Wisma Revenue Date: 16 Jul 2021 Version: 1.41
No 12, Jalan Udang Harimau 2,
Kepong Business Park, Page 73
51200 Kuala Lumpur

3.24 Signature for Installment Request

The hash signature is generating with the following fields:

Signature Value = "Merchant Key" + "Revpay Merchant ID" + "Reference Number" + "Amount" + "Currency"

Parameter Name Sample Value

Merchant Key 1OoL87PmJQ

Revpay Merchant ID MER00000000001

Reference Number RF201774111

Amount 52.40

Currency MYR

3.25 Signature for Installment Response

The hash signature is generating with the following fields:

Signature Value = "Merchant Key" + "Revpay Merchant ID" + "Transaction ID" + "Response Code" + "Reference
Number" + "Amount" + "Currency"

Parameter Name Sample Value

Merchant Key 1OoL87PmJQ

Revpay Merchant ID MER00000000001

Transaction ID RT000000007222

Response Code 00

Reference Number RF201774111

Amount 52.40

Currency MYR

REVENUE GROUP OF COMPANIES Title: revPAY Merchant API
Wisma Revenue
No 12, Jalan Udang Harimau 2, Date: 16 Jul 2021 Version: 1.41
Kepong Business Park,
51200 Kuala Lumpur Page 74

3.26 Sample Signature Generation

The Source string data:
1OoL87PmJQMER00000000001RF20177411152.40MYR

*The formula use to hash the source string data
$signature = $key.$Revpay_Merchant_ID.$Reference_Number.$Amount.$Currency;
$valueSign = hash('sha512', $signature);

Resulting hash signature value equals to:

0716dc1863519f53d47a11ec603d402782222083b2178f596d210fcb93287e81412dd529fa2
adddd8e0cdfa2ddf0bb5e8421f55a105196d4ee58961b253b98a1
*The hash signature value must be lowercase.

The Source string data:
1OoL87PmJQMER00000000001RT00000000722200RF20177411152.40MYR

*The formula to hash the source string data
$signature =
$key.$Revpay_Merchant_ID.$Transaction_id.$response_code.$Reference_Number.$Amoun
t.$Currency;
$valueSign = hash('sha512', $signature);

Resulting hash signature value equals to:

fc8d556ae2e4fa12836e1192a4f0a793a9672af1d2348da502ef299a6b5169f4402fb6bb282
a9e097fe1253b4bfd4f2fa365b7d593b564c585fc79b6c302ecad
*The hash signature value must be lowercase.

REVENUE GROUP OF COMPANIES Title: revPAY Merchant API

Wisma Revenue Date: 16 Jul 2021 Version: 1.41
No 12, Jalan Udang Harimau 2,
Kepong Business Park, Page 75
51200 Kuala Lumpur

4. Frequency Asked Questions (FAQ)

4.1 FAQ

1. Why does revPAY strongly recommend merchants to return the String "OK" to revPAY?
Merchants return the String “OK” to revPAY to confirm that the transaction results are successfully received.
revPAY will trigger the payment response (Backend) again to Merchants if it did not receive any feedback from
Merchants.

2. Why do merchants sometimes receive multiple payment responses (frontend or backend) from revPAY and
what should merchants do?
There are many reasons causing merchants to receive multiple responses from revPAY. For example, the most
common reason is user clicks the refresh or back button when the payment is processing. revPAY recommends
merchants to accept the first transaction result as the final result and to filter out the next transaction result if
merchant’s system is already updated.

3. Can revPAY accept debit card?
If the card has the Visa and MasterCard logo, revPAY can process it.

4. Can I request revPAY to cancel a transaction and refund the customer?
Merchant can request to cancel a particular transaction and refund the money to customers by submitting the
revPAY Refund Resolution Form. revPAY team will validate request from Merchant and proceed refund once
approved.

5. Can I request to increase the daily transaction limit?
Yes, you can request by sending an official request email to revPAY ([email protected]) by stating valid reasons.
The final adjustment is subject to revPAY Management Approval.

6. Does revPAY support Multiple Currencies Type?
Yes, revPAY supports multiple currencies based on the payment service provided to merchants.

7. How do merchants receive payment from revPAY?
The pay-out will be reimbursed via online fund transfer into merchant’s dedicated bank account.

8. Do merchants need to pay extra if choose more than one payment options?
Yes, if merchants request more than one payment option. revPAY offers all in one online payment solution.

9. How to verify the payment processed by revPAY?
revPAY system is integrated with the online reporting system. You can login to the merchant portal by entering
merchant’s E-mail and password (provided by revPAY) at the settlement details page. In the settlement report,
you are able to view:

➢ Date/Time Transaction
➢ Transaction No
➢ Reference No

REVENUE GROUP OF COMPANIES Title: revPAY Merchant API
Wisma Revenue
No 12, Jalan Udang Harimau 2, Date: 16 Jul 2021 Version: 1.41
Kepong Business Park,
51200 Kuala Lumpur Page 76

➢ Transaction Amount.

10. Why is the payment declined?
There could be many different reasons. However, revPAY is will inform the exact reason in the error description
as to why is the transaction declined. Reasons why your payment was declined include:

➢ Some of the card/personal details entered do not match the information held by your Card Issuer

➢ You do not have enough cleared funds on your card to cover the amount of the purchase.

➢ Your card has been reported as lost/stolen card and been cancelled by your Card Issuer.

➢ Your card has or is due to expire and has been replaced by your Card Issuer.

➢ Your card has recently been replaced by your Card Issuer but not yet activated.

➢ Your card cannot be used to pay for goods/services in a Cardholder-Not-Present environment
(online/over the internet).

➢ There may be a problem with your Card Issuer’s authorization system.

➢ You haven’t activated 3-D Secure (Verified by Visa and MasterCard SecureCode) of your card.

11. Why are my transactions rejected with the reason duplicate transaction error?
This could be due to different reasons. However, revPAY requests merchants to use a unique reference number
for transactions as every reference number is a unique identifier assigned to each transaction made. Banks are
not informed of the exact reason why the transaction has been duplicated. Reasons why your payment was
duplicated include:

➢ Duplicate transactions can happen if a customer refreshes checkout page or clicks back button.

➢ Duplicate transaction checking from revPAY & Bank prevents transaction requests from accidentally
processing more than once.

12. What is Re-query and how to use it?
The Re-query function is for merchants to request to revPAY and revPAY will respond the transaction status to
merchants. Merchants are allowed to send the Re-query message to revPAY anytime if want to check transaction
status. Normally merchants will trigger the Re-query message when merchants do not receive the transaction
response from revPAY due to customer’s browser closed or internet connection issue.

REVENUE GROUP OF COMPANIES Title: revPAY Merchant API

Wisma Revenue Date: 16 Jul 2021 Version: 1.41
No 12, Jalan Udang Harimau 2,
Kepong Business Park, Page 77
51200 Kuala Lumpur

13. What to do when an Error Page such as below shows?

Parameter or value not set according to technical specification requirements.
In section 2.1 (Merchant HTTP POST payment request parameters to revPAY Payment Gateway),
Check:

➢ All Field Names are correct and included.

➢ Data Types (Size) within range.

➢ Description is followed accordingly. Example: Amount is entered with decimal point.

14. How to connect to FPX/UnionPay/Alipay Online/Credit Card etc.?
Enter Payment ID according to Appendix A (Payment ID Details).
Example: To connect to FPX, enter Payment_ID value as ‘3’.

15. What is key index and how it is related to signature?
Key index is referring to which secret key is used in the calculation of the signature. If Key_Index value ‘1’ is
entered in the payment request parameters, then the first secret key is used in the calculation of the signature.
If Key_Index value ‘2’ is entered in the payment request parameter, then the second secret key is used in the
calculation of the signature. If Key_Index value ‘3’ is entered in the payment request parameters, then the third
secret key is used in the calculation of the signature.

REVENUE GROUP OF COMPANIES Title: revPAY Merchant API

Wisma Revenue Date: 16 Jul 2021 Version: 1.41
No 12, Jalan Udang Harimau 2,
Kepong Business Park, Page 78
51200 Kuala Lumpur

16. What are the operational hours of the banks in the payment gateway?

Bank Operational Hours
FPX
24 hours
Affin Bank 00:30:00 – 23:59:59
Agro Bank
Alliance Bank 24 hours
Ambank 24 hours
Bank Islam 24 hours
Bank Muamalat 24 hours
Bank Rakyat 24 hours
Bank Simpanan Nasional 00:15:00 – 23:59:59
BNP Paribas 08:45:00 – 16:59:59
CIMB Bank 24 hours
Citibank 24 hours
Deutsche Bank 24 hours
Hong Leong Bank 24 hours
24 hours
HSBC 24 hours
Kuwait Finance Bank 00:15:00 – 23:59:59
Maybank (M2U & M2E) 24 hours
24 hours
OCBC 00:10:00 – 23:59:59
Public Bank 24 hours
RHB Bank 24 hours
Standard Chartered Bank
00:15:00 - 23:59:59
UOB 00:10:00 - 23:54:59
Internet Banking 00:30:00 - 23:59:59
00:16:00 - 23:59:59
MayBank 00:00:00 - 23:59:59
CIMB 02:00:00 - 23:59:59
RHB
24 hours
Public Bank 24 hours
Hong Leong Bank 24 hours
24 hours
AmBank 24 hours
Others 24 hours
24 hours
Visa MasterCard (Credit/Debit Card Payment) 24 hours
AMEX CreditCard 24 hours
Alipay Spot QR 24 hours
24 hours
UPOP (Union Pay Online Payment) 24 hours
UPI QR Code 24 hours
MerchanTrade 24 hours
Axiata Boost 24 hours
Maybank QR
WeChat Pay
Alipay Online
Grab Pay
Touch ’n Go
Diners Club
B Infinite Pay
WannaPay

REVENUE GROUP OF COMPANIES Title: revPAY Merchant API

Wisma Revenue Date: 16 Jul 2021 Version: 1.41
No 12, Jalan Udang Harimau 2,
Kepong Business Park, Page 79
51200 Kuala Lumpur

17. What happens when timeout occurs?
Timeout is the exceeded time limit of the payment gateway, where the customer fails to complete a transaction
within the given time of 5 minutes. The transaction status will become ‘unsuccessful’.

18. What happens when timeout occurs, but customer’s account balance is deducted?
When the customer’s account balance is deducted but has exceeded the revPAY’s payment gateway time limit,
the transaction status will be ‘unsuccessful’, and revPAY will refund the amount into the customer’s account.

19. Customer’s account per transaction limit? Transaction Limit
Scheme/Bank MYR 1.00 – MYR 30,000.00
FPX – B2C MYR 2.00 – MYR 1,000,000.00
FPX – B2B MYR 0.01 – MYR {card holder limit}
MYR 0.01 – MYR {card holder limit}
Visa MasterCard (Credit/Debit Card Payment) MYR 0.01 – MYR {card holder limit}
AMEX CreditCard MYR 0.01 – MYR 5,000.00
Alipay Spot QR MYR 0.01 – MYR 10,000.00
MYR 0.01 – MYR 4,999.00
UPOP (Union Pay Online Payment) MYR 0.01 – MYR 1,000.00
MerchanTrade MYR 0.01 – MYR 1,000.00
Axiata Boost MYR 0.01 – MYR {card holder limit}
Maybank QR MYR 0.01 – MYR 1,500.00
WeChat Pay MYR 0.01 – MYR 5,000.00
Alipay Online MYR 0.01 – MYR 1,000.00
Grab Pay
Touch ’n Go MYR 0.01 – MYR 200.00
B Infinite Pay
WannaPay

REVENUE GROUP OF COMPANIES Title: revPAY Merchant API
Wisma Revenue
No 12, Jalan Udang Harimau 2, Date: 16 Jul 2021 Version: 1.41
Kepong Business Park,
51200 Kuala Lumpur Page 80

5. Contact Information

5.1 System Integration

If you have any inquiry about revPAY System integration, please contact:

Contact Person 1: IT Product Team
Email Address 1: [email protected]

5.2 Customer Care

If you have any inquiry about Transaction Status, please contact:

Contact Person 1: Customer Care Team
Email Address 1: [email protected]

5.3 Operation

If you have any inquiry about Refund request, please contact:

Contact Person 1: IT Operation Team
Email Address 1: [email protected]

5.4 Settlement

If you have any inquiry about daily Settlement Report/Payout, please contact:

Contact Person 1: Finance Team
Email Address 1: [email protected]

REVENUE GROUP OF COMPANIES Title: revPAY Merchant API

Wisma Revenue Date: 16 Jul 2021 Version: 1.41
No 12, Jalan Udang Harimau 2,
Kepong Business Park, Page 81
51200 Kuala Lumpur

5.5 Business

If you have any inquiry about revPAY Products, Fee Charges, Sales & Marketing consult, please contact:

Contact Person 1: Kevin
Email Address 1: [email protected]

Contact Person 2: Daniel
Email Address 2: [email protected]

Contact Person 3: Wai Mun
Email Address 3: [email protected]

Contact Person 4: Abby Ho
Email Address 4: [email protected]

Contact Person 5: Susan
Email Address 5: [email protected]

REVENUE GROUP OF COMPANIES Title: revPAY Merchant API
Wisma Revenue
No 12, Jalan Udang Harimau 2, Date: 16 Jul 2021 Version: 1.41
Kepong Business Park,
51200 Kuala Lumpur Page 82

6. Payment Flow

6.1 FPX Payment Flow

Kindly refer to the below steps if you are purchasing the FPX package:

(a) Payment Page

(b) Bank page

REVENUE GROUP OF COMPANIES Title: revPAY Merchant API

Wisma Revenue Date: 16 Jul 2021 Version: 1.41
No 12, Jalan Udang Harimau 2,
Kepong Business Park, Page 83
51200 Kuala Lumpur

(c) SBI Bank A confirmation page

(d) FPX receipt page

REVENUE GROUP OF COMPANIES Title: revPAY Merchant API

Wisma Revenue Date: 16 Jul 2021 Version: 1.41
No 12, Jalan Udang Harimau 2,
Kepong Business Park, Page 84
51200 Kuala Lumpur

6.2 Visa Master Payment Flow

Kindly refer to the below steps if you are purchasing Visa MasterCard package:

(a) Payment Page

(b) OTP page

REVENUE GROUP OF COMPANIES Title: revPAY Merchant API

Wisma Revenue Date: 16 Jul 2021 Version: 1.41
No 12, Jalan Udang Harimau 2,
Kepong Business Park, Page 85
51200 Kuala Lumpur

(c) Merchant’s confirmation page

6.3 UnionPay Payment Flow

Kindly refer to the below steps if you are purchasing UnionPay package:

(a) Payment Page

REVENUE GROUP OF COMPANIES Title: revPAY Merchant API

Wisma Revenue Date: 16 Jul 2021 Version: 1.41
No 12, Jalan Udang Harimau 2,
Kepong Business Park, Page 86
51200 Kuala Lumpur

(b) UnionPay card page (Note: Click ‘Send Free SMS’ button then insert SMS Code).

(c) Merchant’s confirmation page

REVENUE GROUP OF COMPANIES Title: revPAY Merchant API

Wisma Revenue Date: 16 Jul 2021 Version: 1.41
No 12, Jalan Udang Harimau 2,
Kepong Business Park, Page 87
51200 Kuala Lumpur

6.4 Merchantrade Money Payment Flow

Kindly refer to the below steps if you are purchasing Merchantrade Money package:

(a) Payment page

(b) Merchant’s confirmation page

REVENUE GROUP OF COMPANIES Title: revPAY Merchant API

Wisma Revenue Date: 16 Jul 2021 Version: 1.41
No 12, Jalan Udang Harimau 2,
Kepong Business Park, Page 88
51200 Kuala Lumpur

6.5 Alipay Online Payment Flow

Kindly refer to the below steps if you are purchasing Alipay Online package:

(a) Payment page (NOTE: Currency must be in USD)

(b) Login page

REVENUE GROUP OF COMPANIES Title: revPAY Merchant API

Wisma Revenue Date: 16 Jul 2021 Version: 1.41
No 12, Jalan Udang Harimau 2,
Kepong Business Park, Page 89
51200 Kuala Lumpur

(c) Payment Password Page

(d) Confirmation page

REVENUE GROUP OF COMPANIES Title: revPAY Merchant API

Wisma Revenue Date: 16 Jul 2021 Version: 1.41
No 12, Jalan Udang Harimau 2,
Kepong Business Park, Page 90
51200 Kuala Lumpur

6.6 Boost Payment Flow

Below is payment screen if you are purchasing Boost Online package:

(a) Payment page (Desktop view)

(b) Payment page (Mobile view)

REVENUE GROUP OF COMPANIES Title: revPAY Merchant API

Wisma Revenue Date: 16 Jul 2021 Version: 1.41
No 12, Jalan Udang Harimau 2,
Kepong Business Park, Page 91
51200 Kuala Lumpur

6.7 TnGo Payment Flow

Below is payment screen if you are purchasing TnGo Online package:

(a) Payment page (Desktop view)

(b) Payment page (Mobile view)

REVENUE GROUP OF COMPANIES Title: revPAY Merchant API

Wisma Revenue Date: 16 Jul 2021 Version: 1.41
No 12, Jalan Udang Harimau 2,
Kepong Business Park, Page 92
51200 Kuala Lumpur

6.8 MBB QR Payment Flow

Below is payment screen if you are purchasing MBB QR package:

(a) Payment page (Desktop/Mobile view)

REVENUE GROUP OF COMPANIES Title: revPAY Merchant API
Wisma Revenue
No 12, Jalan Udang Harimau 2, Date: 16 Jul 2021 Version: 1.41
Kepong Business Park,
51200 Kuala Lumpur Page 93

7. System Integration

7.1 Pre-requisite

7.2 Test Cases

7.3 Test Result

7.4 Sign Off Letter

REVENUE GROUP OF COMPANIES Title: revPAY Merchant API
Wisma Revenue
No 12, Jalan Udang Harimau 2, Date: 16 Jul 2021 Version: 1.41
Kepong Business Park,
51200 Kuala Lumpur Page 94

Appendix

Appendix A: Payment ID Details

No Payment ID Description

11 Reserved
22 Visa MasterCard (Credit/Debit Card Payment)
33 FPX (Bank Fund Transfer) – B2C Personal Account
44 AMEX Credit Card
55 Alipay Spot QR
66 UPOP (UnionPay Online Payment)
77 UPI QR Code
88 Internet Banking
99 FPX (Bank Fund Transfer) – B2B Corporate Account
10 10 Merchantrade
11 11 Axiata Boost
12 12 Maybank QR
13 13 DiGi VCash
14 14 WeChat Pay
15 15 Alipay Online (Web)
16 16 AirAsia BIG
17 17 Grab Pay
18 18 Internet Banking (MayBank)
19 19 Internet Banking (CIMB)
20 20 Internet Banking (RHB)
21 21 Internet Banking (Public Bank)
22 22 Internet Banking (Hong Leong Bank)
23 23 Internet Banking (AmBank)
24 24 Internet Banking (Bank Rakyat)
25 25 Internet Banking (Bank Muamalat)
26 26 Internet Banking (BSN)
27 27 Hong Leong Bank – Scan and Pay
28 28 Touch ’n Go
29 29 Diners Club
30 30 Alipay Online (Mini Program)
31 31 MyDebit Secure (Debit Card Payment)
32 32 eNETS
33 33 ShopeePay
34 34 B Infinite Pay
35 35 WannaPay

REVENUE GROUP OF COMPANIES Title: revPAY Merchant API

Wisma Revenue Date: 16 Jul 2021 Version: 1.41
No 12, Jalan Udang Harimau 2,
Kepong Business Park, Page 95
51200 Kuala Lumpur

Appendix B: Bank Code Details

Payment: FPX – B2C Personal Account

No Payment ID Bank Code Description

13 ABB0233 Affin Bank Berhad

23 ABMB0212 Alliance Bank Malaysia Berhad

33 AGRO01 Bank Pertanian Malaysia Berhad

43 AMBB0209 AmBank Malaysia Berhad

53 BIMB0340 Bank Islam Malaysia Berhad

63 BMMB0341 Bank Muamalat Malaysia Berhad

73 BKRM0602 Bank Kerjasama Rakyat Malaysia Berhad

83 BSN0601 Bank Simpanan Nasional

93 BCBB0235 CIMB Bank Berhad

10 3 HLB0224 Hong Leong Bank Berhad

11 3 HSBC0223 HSBC Bank Malaysia Berhad

12 3 KFH0346 Kuwait Finance House (Malaysia) Berhad

13 3 MBB0228 Malayan Banking Berhad (M2E)

15 3 MB2U0227 Malayan Banking Berhad (M2U)

14 3 OCBC0229 OCBC Bank Malaysia Berhad

16 3 PBB0233 Public Bank Berhad

17 3 RHB0218 RHB Bank Berhad

18 3 SCB0216 Standard Chartered Bank

19 3 UOB0226 United Overseas Bank

Payment: FPX – B2B Corporate Account

No Payment ID Bank Code Description

19 ABB0232 Affin Bank Berhad

29 ABB0235 Affin Bank Berhad (AffinMax)

39 ABMB0213 Alliance Bank Malaysia Berhad

49 AGRO02 Bank Pertanian Malaysia Berhad

59 AMBB0208 AmBank Malaysia Berhad

69 BIMB0340 Bank Islam Malaysia Berhad

79 BMMB0342 Bank Muamalat Malaysia Berhad

89 BNP003 BNP Paribas Malaysia Berhad

99 BCBB0235 CIMB Bank Berhad

10 9 CIT0218 CITIBANK BHD

11 9 DBB0199 Deutsche Bank Berhad

12 9 HLB0224 Hong Leong Bank Berhad

13 9 HSBC0223 HSBC Bank Malaysia Berhad

14 9 BKRM0602 Bank Kerjasama Rakyat Malaysia Berhad

15 9 KFH0346 Kuwait Finance House (Malaysia) Berhad

16 9 MBB0228 Malayan Banking Berhad (M2E)

17 9 OCBC0229 OCBC Bank Malaysia Berhad

18 9 PBB0233 Public Bank Berhad

19 9 PBB0234 Public Bank Enterprise

20 9 RHB0218 RHB Bank Berhad

21 9 SCB0215 Standard Chartered Bank

22 9 UOB0228 United Overseas Bank B2B Regional

REVENUE GROUP OF COMPANIES Title: revPAY Merchant API

Wisma Revenue Date: 16 Jul 2021 Version: 1.41
No 12, Jalan Udang Harimau 2,
Kepong Business Park, Page 96
51200 Kuala Lumpur

Payment: Visa MasterCard & AMEX – Easy Payment Plan (EPP) / Installment

No Payment ID Bank Code Description

12 AMB AM Bank

22 CIMB CIMB Bank

32 HLB Hong Leong Bank

42 HSBC HSBC Bank

5 2/4 MBB MayBank

62 PBB Public Bank

72 RHB RHB Bank

82 OCBC OCBC Bank

92 SCB Standard Chartered Bank

10

REVENUE GROUP OF COMPANIES Title: revPAY Merchant API

Wisma Revenue Date: 16 Jul 2021 Version: 1.41
No 12, Jalan Udang Harimau 2,
Kepong Business Park, Page 97
51200 Kuala Lumpur

Appendix C: Payment Response Code Details

No Code Description Action

1 00 Payment is successful. Please check merchant ID used.
2 01 Payment is unsuccessful. Please request customer to check with bank.
3 03 Invalid merchant. Please request customer to check with bank.
4 05 Merchant or seller account closed. Please check status again in 5 minutes.
5 06 Issuer card is expired. Please check transaction details submitted.
6 09 Request in progress. Please check amount format submitted.
7 12 Invalid transaction. Please check buyer account/card number or
8 13 Invalid amount. check status of account/card with bank.
9 14 Invalid buyer account or card information. Please check with your customer if needed.
Please perform transaction again, otherwise
10 17 Buyer cancel transaction. please contact Revenue’s technical team.
11 22 Suspected malfunction. Please perform transaction again, otherwise
please contact Revenue’s support team.
12 25 Failure to search an original transaction. Please check that parameter format and
value are according to specifications.
13 30 Format error or MAC error. Please check that bank chosen is valid.
Please request customer to check with bank
14 31 Invalid bank. for credit account.
15 39 No credit account. Please request customer to check balance in
their bank if available for transaction.
16 51 Insufficient fund. Please request customer to check with bank
for saving account.
17 53 No saving account. Please check transaction with Revenue.
Please request customer to check with bank
18 57 Transaction not permitted. on account withdrawal limit.
19 61 Withdrawal limit exceeded. Please request customer to check with bank
on account withdrawal frequency limit.
20 65 Withdrawal frequency exceeded. Please check transaction details submitted.
Please check buyer name and id submitted is
21 76 Transaction not found. valid.
22 77 Invalid buyer name or buyer Id. Please perform transaction again after 30
minutes, otherwise please contact Revenue’s
23 79 Host decline when down. support team.
Please perform transaction again, otherwise
24 85 Internal error at bank’s system. please contact Revenue’s support team.
Please request customer to check with bank.
25 87 Debit failed (exception handling). Please request customer to check with bank.
26 88 Credit failed (exception handling). Please perform transaction again, otherwise
27 89 Transaction not received (exception please contact Revenue’s support team.
handling). Please perform transaction again, otherwise
28 92 Financial institution or intermediate please contact Revenue’s support team.
network facility cannot be found for
29 93 routing. Please perform transaction again, otherwise
Transaction cannot be completed. please contact Revenue’s support team.

REVENUE GROUP OF COMPANIES Title: revPAY Merchant API

Wisma Revenue Date: 16 Jul 2021 Version: 1.41
No 12, Jalan Udang Harimau 2,
Kepong Business Park, Page 98
51200 Kuala Lumpur

No Code Description Action

30 FE Internal error. Please check that parameter format and

value are according to specifications.

31 OE Transaction rejected as not in operating Please check bank operational hours and

hours. perform transaction during operating hours.

32 OF Transaction timeout by SCHEME. Please advise client to perform the overall

transaction within 5 minutes.

33 OA Bank session timeout. Please advise client to perform the overall

transaction within 5 minutes.

34 1A Buyer session timeout at bank login page. Please advise client to perform the overall

transaction within 5 minutes.

35 1B Buyer failed to provide the necessary info Please request customer to check with bank.

to login to bank login page.

36 1C Buyer choose cancel at login page. Please check with your customer if needed.

37 1D Buyer session timeout at account selection Please advise client to perform the overall

page. transaction within 5 minutes.

38 1E Buyer failed to provide the necessary info Please request customer to provide required

at account selection page. info at account selection page.

39 1F Buyer choose cancel at account selection Please check with your customer if needed.

page.

40 1G Buyer session timeout at TAC request page. Please advise client to perform the overall

transaction within 5 minutes.

41 1H Buyer failed to provide the necessary info Please request customer to provide necessary

at TAC request page. info at TAC request page.

42 1I Buyer choose cancel at TAC request page. Please check with your customer if needed.

43 1J Buyer session timeout at confirmation Please request customer to perform a

page. complete transaction within the time limit at

confirmation page.

44 1K Buyer failed to provide the necessary info Please request customer to provide necessary

at confirmation page. info at confirmation page.

45 1L Buyer choose cancel at confirmation page. Please check with your customer if needed.

46 2A Transaction amount is lower than Please check transaction amount and

minimum limit. minimum limit.

47 OT Transaction time out by revPAY. Please request customer perform a

transaction within time limit.

48 3A Invalid key index. Please check key index value and key index

provided by Revenue in email.

49 3B Invalid signature. Please check parameters used in generating
50 3C Original reference number not found. the signature.
Please check reference number used, as
51 3D Invalid product Id or payment Id. reference numbers must be unique and cannot
52 3E Currency not support. be used twice.
53 3F Function not support. Please check Payment_ID value and format
at payment request parameters.
Please check currency value and format at
payment request parameters.
The function sale, void, refund etc. is not
supported. Please contact Revenue Support
team.

REVENUE GROUP OF COMPANIES Title: revPAY Merchant API

Wisma Revenue Date: 16 Jul 2021 Version: 1.41
No 12, Jalan Udang Harimau 2,
Kepong Business Park, Page 99
51200 Kuala Lumpur

No Code Description Action

54 3G Exchange rate not support. Please contact Revenue Support team for

supported exchange rates.

55 3H Duplicate transaction record. Bank/Scheme rejected transaction due to

receiving repeated request. Merchant should

ignore the error and wait for the original

transaction status to be updated or re-query

for latest status.

56 3I Pickup card, Block card or Blacklist card Please request customer to check with bank

detected. regarding the card used.

57 3J Merchant setting error, please contact Please check with administrator to check the

administrator to check merchant settings. merchant settings.

58 3K Authentication fail, cancelled or timeout in Please request customer to perform a

TAC request page. complete transaction.

59 3L Merchant reference number is not unique. revPAY rejected transaction due to receiving

repeated merchant reference number /

request. Merchant should ignore the error and

wait for the original transaction status to be

updated or re-query for latest status.

60 3M Transaction already void. Please inform customer transaction already

void.

61 3N Transaction already refund. Please check with your refund system.

62 3O The total refund amount must not large Please check total refund amount

than transaction amount. (partial/full) is not more than original

transaction amount.

63 99 Pending Authorization. Applicable for FPX B2B model. Client require

to approve payment request.

64 4A Total SubMerchant amount must equals to Please check the total amount in param

transaction amount. “Ecomm_Marketplace” is same with param

“Amount”.

65 4B SubMerchant MID not found. Please check MID value with Revenue

Support team.

66 4C SubMerchant RefNo not unique. Please check to ensure RefNo value is

unique.

67 48 Maximum transaction limit exceeded RM Applicable for FPX B2B model. Please ensure

1,000,000.00 the transaction amount is not more than 1

million.

68 4D Invalid Token ID. Please check Token ID value with Revenue

Support team.

69 4E Transaction rejected due to high risk. Please advise client choose another payment

method to make transaction.

70 4F Error in TokenVault. Please check with Revenue Support team.

71 4G Invalid card number. Please advise client to enter valid card info

or try use other cards.

72 4H Invalid card expiry date. Please advise client to enter valid card info

or try use other cards.

73 4I Transaction reject by SCHEME. Please contact Revenue Support team.

74 4J Wallet ID is mandatory. Please check your transaction message.

75 4K Device ID is mandatory. Please check your transaction message.

76 4L Invalid card type. Please check your transaction message.

REVENUE GROUP OF COMPANIES Title: revPAY Merchant API

Wisma Revenue Date: 16 Jul 2021 Version: 1.41
No 12, Jalan Udang Harimau 2,
Kepong Business Park, Page 100
51200 Kuala Lumpur

No Code Description Action

77 4M Decline when RBA host down. Please contact Revenue Support team.

78 XA Invalid Source IP Address. Please contact Revenue Support team.

79 4N No partial refund allows for sub Please check the refund amount with original

transaction. sub transaction amount in
“Ecomm_Marketplace”. It must be same

value.

80 4S Void transaction must perform in same Any void transaction must perform in same

day. transaction date.

81 4O Refund rejected due to settlement released Refund request will be rejected for any sub

for sub transaction. transaction amount release process

completed.

82 4P No partial settlement release allows for sub Please check settlement release amount.

transaction.

83 4Q Invalid settlement release date. Ensure date value is not empty and follow

parameter format.

84 5A Invalid Promo Code Promo Code not exist in system. Please check

to confirm again.

85 5B Promo Code has expired Promo Code is not available.

86 5C Promo Code has reached the usage limit Promo Code is not available due to has reach

the usage limit.

87 5D Not eligible to use this Promo Code Promo Code not eligible to use in payment.

It can be due to particular payment

conditions. E.g: payment amount limit,

selected merchant only.

88 5E Promo Code not supported with this Promo Code not supported with particular

Payment Scheme/Bank payment method.