This document covers various common issues encountered when using HaiPay. If you face any issues while using HaiPay, please refer to this document first.

General

After logging into HaiPay, there are no other functions besides the homepage.

You need to authorize the previous sub-account roles again with the main account.

Error when triggering payment, error message: No permission to pay for products, please contact the administrator.

Possible reasons:

1. The client's product configuration is incorrect.
2. The payment method requested by the client is incorrect.

Error when triggering payment, response body:

Channel configuration error.

Customer payment error, authentication failure message.

Possible reason: The bank's risk control mechanism was triggered, so it was rejected. Try using a different card to retry.

What is the phone number format?

• Taiwan: Starts with 09, total of 10 digits. Example: 09XX XXX XXX
• Korea: Starts with 01X, total of 10 digits. Example: 010 XXXX XXXX.
• Belgium: Starts with 04, total of 10 digits. Example: 04XX XX XX XX.
• Austria: Starts with 06, total of 9 digits. Example: 0664 XXXXXXX.
• Germany: Starts with 01, total of 11 digits. Example: 0151 XXXXXXXX.
• Poland: Starts with 5, 6, 7, 8, 9, total of 9 digits. Example: 5XX XXX XXX.
• Indonesia: Starts with 08, total of 10 digits. Example: 081X XXXX XXXX.
• Philippines: Starts with 09, total of 11 digits. Example: 09XX XXX XXXX.
• Singapore: Starts with 8 or 9, total of 8 digits. Example: 8XXX XXXX or 9XXX XXXX.
• Vietnam: Starts with 09, total of 10 digits. Example: 09XX XXX XXX.
• Thailand: Starts with 08, total of 10 digits. Example: 08XX XXX XXX.
• Malaysia: Starts with 01, total of 10 digits. Example: 01X XXX XXXX.
• Brazil: Starts with 9, total of 11 digits. Example: 9XXXX XXXX.
• Russia: Starts with 9, total of 10 digits. Example: 9XX XXX XX XX.
• Japan: Starts with 0, total of 11 digits. Example: 0XX XXXX XXXX.
• Egypt: Starts with 01, total of 11 digits. Example: 01X XXXX XXXX.

Some payment methods fail to trigger the app, how to handle this?

    // WebView interception processing is required
    @Override
    public boolean shouldOverrideUrlLoading(WebView view, WebResourceRequest request) {
        if (request.getUrl().toString().startsWith("http")) {
            view.loadUrl(request.getUrl().toString());
            return super.shouldOverrideUrlLoading(view, request);
        } else {
            view.onPause();
            view.stopLoading();
            try {
                Intent intent = Intent.parseUri(uri, Intent.URI_INTENT_SCHEME);
                intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
                view.getContext().startActivity(intent);
            } catch (URISyntaxException e) {
                // Alert: scheme not supported
                return false;
            }
        }
    }

Taiwan

Are there any issues with convenience store or ATM payments? Low success rate.

Hello, after checking, we found no issues with convenience store and ATM payments. We looked at the orders, and one user had multiple orders, so some users may not make payments on time. Convenience store and ATM payments are offline services, and both have a payment window period. The success rate depends on how many payments the user makes.

Brazil

What should be filled in the "Cash Source" column in CDD?

Game operation.

PIX collection order failed, error message: FAILED-invalid cpf or cnpj.

This could be due to missing CPF.

PayPal / ACH / ECASHAPP

When testing the disbursement API, is the name and account number required to be real accounts?

The name can be random, but the recipient’s account number must be real.

PayPal disbursement error, reason: bank return.

The user’s account has been flagged by PayPal, and payments cannot be received.

Issue with PayPal disbursement mistake recovery.

We are directly connected to PayPal’s official API, and the payment was sent to the wrong account. It cannot be recovered via disbursement, so you will need to contact the recipient to recover the funds.

How long does it take for PayPal withdrawals to be credited?

Real-time crediting, but orders stuck in "payment in progress" need the recipient to confirm via email (for dormant or long-unused accounts).

Is the email field required when the bankCode is PayPal?

Yes, it is required because the account is the email address.