Integration FAQ

1. How do I pass the parameters to iPay88?

Please use the HTTP POST method.

2. What information do I need to provide iPay88 before the integration of a merchant account?

Please provide both the Request and Response URLs of the merchant website.

3. What are the Request and Response URLs?

The Request URL is a page on the Merchant’s Website that passes the required parameters to iPay88’s request payment page.
The Response URL is a page on the Merchant’s Website that accepts the payment status from iPay88 after atransaction.

4. How do I perform payment testing during the integration stage?

You can use any valid credit card for integration purposes. The following details are required: Credit card number, expiry date, CVV number, and the cardholder’s name.

5. What transaction amount do I use for the payment testing?

Please use the following amount for the respective currency code:

USD 1.00
PHP 15.00

6. What are the common error messages that I may get if I never reach the iPay88 Payment Page?

Below are the common error messages you may get if you never reach the iPay88 Payment Page along with theirrespective descriptions:

Duplicate Reference Number – The Reference Number provided is related to a previous successfultransaction.
Invalid Merchant Code – The Merchant Code does not exist.
Invalid Parameters – Some parameters posted to iPay88 may be invalid or empty.
Status Not Approved – The Merchant Account is not active or is suspended.
Overlimit Per Transaction – You exceeded the set amount value per transaction for the Merchant Account.
Payment Not Allowed – The Payment Method you requested is not allowed for this Merchant Account.
Signature (Does) Not Match – Ensure that the Signature on the Request Page is generated accordingly. Refer to page 14 of iPay88’s Technical Specification Document for more information about the Signature on the Request Page.
Permission Not Allowed – Ensure that the Request URL used is the same as the one registered with iPay88.

7. Why do I get the “The return page URL does not exist.” message displayed on my web browser
and cannot see the iPay88 payment page?

Please use the correct Merchant Code assigned to the merchant and provide the Request URL to [email protected] before the integration.

8. How do I ensure the integration is completed?

Make sure the parameters are properly passed on to iPay88 and can reach the iPay88 payment page.
Make sure to implement security control on the Merchant Response Page.

example:

Do a re-query on payment status for successful payment transaction to double confirm.
Compare the Signature from iPay88 with your own.

9. How can I change the merchant information such as URL,
contact number, company name, and bank account number?

Please send an email to [email protected] to request these changes.

10. What should I not do after pressing the "Proceed Payment" button?

Do not disconnect the Internet.
Do not close the web browser while the transaction is being processed.
Do not click the "Back" button on your web browser to avoid duplicate payments.

11. I am getting the error description "Fail (Card issuing bank does not honor the transaction)"
returned by iPay88; what does it mean?

Please contact your credit card issuer or bank to check whether the card can be used for purchases online.

12. Is there any function from iPay88 where I can query payment status
if my system did not get a paymentstatus return from iPay88?

You can use the iPay88 Server Re-query function to query our database for transaction status. Please refer to pages 10-12 of iPay88’s Technical Specification for more information about the Signature on the Request Page.