Difference between revisions of "AsiaPay"

From WHMCS Documentation

 
(6 intermediate revisions by 3 users not shown)
Line 4: Line 4:
  
 
Headquartered in Hong Kong, AsiaPay supports 12 countries including Asia including: Hong Kong, China, India, Indonesia, Malaysia, Singapore, Philippines, Taiwan, Thailand and Vietnam and is rapidly expanding to new Asia Pacific markets.
 
Headquartered in Hong Kong, AsiaPay supports 12 countries including Asia including: Hong Kong, China, India, Indonesia, Malaysia, Singapore, Philippines, Taiwan, Thailand and Vietnam and is rapidly expanding to new Asia Pacific markets.
 
 
{{gateways
 
{{gateways
 
| onetime = yes
 
| onetime = yes
Line 14: Line 13:
 
To set up the AsiaPay payment gateway in WHMCS:
 
To set up the AsiaPay payment gateway in WHMCS:
 
   
 
   
# Go to '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Payment Gateways]]''' or, prior to WHMCS 8.0, '''Setup > Products/Services > Payment Gateways'''.
+
# Go to the appropriate location for your version of WHMCS:
# Choose the '''All Payment Gateways''' tab.
+
#* For WHMCS 8.0 and later, go to '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > Apps & Integrations''' or '''Addons > [[Apps and Integrations|Apps & Integrations]]'''.
 +
#* For WHMCS 7.10 and earlier, go to '''Setup > Products/Services > [[Payment Gateways]]''' and choose '''All Payment Gateways'''.
 
# Click '''AsiaPay'''.
 
# Click '''AsiaPay'''.
 
# Check '''Show on Order Form''' to display this payment method in the Client Area during checkout.  
 
# Check '''Show on Order Form''' to display this payment method in the Client Area during checkout.  
Line 35: Line 35:
 
The instructions above are correct as of the time of writing (June 2015).
 
The instructions above are correct as of the time of writing (June 2015).
  
=== Test Mode ===   
+
=== Return Value Link (Datafeed) ===
 +
 
 +
[[File:asiapay-datafeed.png|thumb|AsiaPay Datafeed]]
 +
 
 +
To automatically mark invoices as paid when you receive a payment via AsiaPay, enable ''Return Value Link'' in your PayDollar account:
 +
 
 +
# Log in to your PayDollar account.
 +
# Go to '''Profile > Payment Account Settings'''.
 +
# Click '''Enable'''.
 +
# Enter your WHMCS System URL, followed by <tt>modules/gateways/callback/asiapay.php</tt> (for example, <tt>https://www.example.com/whmcspath/modules/gateways/callback/asiapay.php</tt>, where <tt>www.example.com/whmcspath</tt> is the path to your WHMCS installation).
 +
# Click '''Update'''.
 +
 
 +
=== Test Mode ===   
  
 
<div class="docs-alert-warning">
 
<div class="docs-alert-warning">
Line 43: Line 55:
  
 
You can use test mode to simulate payment processing without actually causing a transaction to occur. This can be useful to test your configuration.
 
You can use test mode to simulate payment processing without actually causing a transaction to occur. This can be useful to test your configuration.
+
 
 
== Troubleshooting ==
 
== Troubleshooting ==
  
''N/A''
+
=== Parameter currCode Incorrect ===
 +
 +
Receiving this error when attempting to make a payment indicates that AsiaPay doesn't support the client's currency. This module supports the following currencies:
 +
 +
* USD
 +
* HKD
 +
* SGD
 +
* CNY
 +
* JPY
 +
* TWD
 +
* AUD
 +
* EUR
 +
* GBP
 +
* CAD
 +
* MOP
 +
* PHP
 +
* THB
 +
* MYR
 +
* IDR
 +
* KRW
  
 
{{modules}}
 
{{modules}}

Latest revision as of 13:13, 9 August 2023

About this Module

AsiaPay is an online payment service and solutions provider in Asia that provides electronic payment gateway solutions. AsiaPay offers multi-currency, multi-lingual, multi-card, and multi-channel functionality together with advanced fraud detection and management solutions.

Headquartered in Hong Kong, AsiaPay supports 12 countries including Asia including: Hong Kong, China, India, Indonesia, Malaysia, Singapore, Philippines, Taiwan, Thailand and Vietnam and is rapidly expanding to new Asia Pacific markets.

Supported Features

Type One Time Recurring Refunds Reversals
3rd Party Yes Yes No

No


Adding the AsiaPay Payment Gateway

To set up the AsiaPay payment gateway in WHMCS:

  1. Go to the appropriate location for your version of WHMCS:
    • For WHMCS 8.0 and later, go to Configuration () > Apps & Integrations or Addons > Apps & Integrations.
    • For WHMCS 7.10 and earlier, go to Setup > Products/Services > Payment Gateways and choose All Payment Gateways.
  2. Click AsiaPay.
  3. Check Show on Order Form to display this payment method in the Client Area during checkout.
  4. Optionally, update the Display Name value.
  5. Enter your merchant ID.
  6. Enter your secure hash key (see below).
  7. Click Save Changes.

Secure Hash Key

We recommend using the Secure Hash Key to protect against unauthorized callbacks.

As of WHMCS 6.0, configuring a Secure Hash Key is required. No callbacks will be accepted or processed without it.

To setup a Secure Hash Key within your AsiaPay account, you must contact the PayDollar Service Department (service@paydollar.com) to request the Secure Hash function be enabled for your merchant account. Once enabled, you can retrieve the hash from within the Merchant Administration Interface by navigating to Profile > Payment Information.

Once you have obtained your Secure Hash, enter it into the "Secure Hash Key" field within the WHMCS Payment Gateway Configuration area for the AsiaPay module.

The instructions above are correct as of the time of writing (June 2015).

Return Value Link (Datafeed)

AsiaPay Datafeed

To automatically mark invoices as paid when you receive a payment via AsiaPay, enable Return Value Link in your PayDollar account:

  1. Log in to your PayDollar account.
  2. Go to Profile > Payment Account Settings.
  3. Click Enable.
  4. Enter your WHMCS System URL, followed by modules/gateways/callback/asiapay.php (for example, https://www.example.com/whmcspath/modules/gateways/callback/asiapay.php, where www.example.com/whmcspath is the path to your WHMCS installation).
  5. Click Update.

Test Mode

Note
Notes about any module-specific requirements.

You can use test mode to simulate payment processing without actually causing a transaction to occur. This can be useful to test your configuration.

Troubleshooting

Parameter currCode Incorrect

Receiving this error when attempting to make a payment indicates that AsiaPay doesn't support the client's currency. This module supports the following currencies:

  • USD
  • HKD
  • SGD
  • CNY
  • JPY
  • TWD
  • AUD
  • EUR
  • GBP
  • CAD
  • MOP
  • PHP
  • THB
  • MYR
  • IDR
  • KRW

Server Modules
cPanel/WHM - DirectAdmin - Plesk - Helm 3 - Helm 4 - Ensim - InterWorx - WebsitePanel - Cloudmin
Lxadmin - Virtualmin Pro - XPanel - HyperVM - SolusVM - Cloudmin - WHMSonic - VPS.Net
CentovaCast - SCPanel - MediaCP - GameCP - TCAdmin - Reseller Central - Auto Release - Heart Internet

Registrar Modules
Enom - ResellerClub - Nominet - OpenSRS - ResellOne - OnlineNIC - PlanetDomain - Affordable Domains
TPP Wholesale - TPPInternet - Stargate - Namecheap - NetEarthOne - Bizcn - InternetBS - GMO Internet
12Register - Registercom - DotDNS - WebNIC - Dot.TK - HexoNet - Realtime Register - Registereu
RRPProxy - ResellerCamp - TransIP - Heart Internet - IPMirror - NetRegistry - OVH - VentraIP Wholesale
Email - 101Domain

Fraud Modules
MaxMind - VariLogiX FraudCall - Telesign

Gateway Modules
2CheckOut - AsiaPay - Auth.net Echeck - Authorize.net - Authorize.net CIM - Bank Transfer - BidPay
BluePay - BluePay Echeck - BluePay Remote - Boleto - CashU - CC Avenue - ChronoPay - Direct Debit
EMatters - E-Path - eProcessingNetwork - eWAY Tokens - F2B - Finansbank - GarantiBank - Gate2Shop
Inpay - InternetSecure - IP.Pay - Kuveytturk - Modulo Moip - Mail In Payment - Merchant Partners
Merchant Warrior - IDEALMollie - Moneris - Moneris Vault - Skrill 1-Tap - NaviGate - NETbilling
Netregistry Pay - NoChex - Offline Credit Card - Optimal Payments - PagSeguro - Payflow Pro - Pay Junction
Paymate AU and NZ - Payment Express - PayPal - PayPal Card Payments - PayPal Express Checkout
PayPal Payments - PayPal Payments Pro - PayPoint.net (SecPay) - Payson - Planet Authorize - ProtX VSP Form
PSIGate - Quantum Gateway - Quantum Vault - SagePay - SagePay Tokens v2 - SecurePay
SecurePay AU - Secure Trading - TrustCommerce - USA ePay - WorldPay - WorldPay Invisible