Updating your Asiapay account

Once the account testing and setup are complete, we need to finalise the integration on our end. To do this, we will require your AsiaPay credentials.

SchoolsBuddy doesn't have access to your AsiaPay account; therefore, please request the information below from service@paydollar.com. They will only share the keys with you.

1. Account Number/Merchant ID  
2. Secret hash/key 
3. API Username 
4. API Password token 

Important: Please submit your credentials securely using this online form. Do not send them in the body of an email.

Updating the Payment Response URLs

Once you have the login to your Asiapay account. Please update the payment response URLs  - see screenshots for guidance. 

1. Log in to your AsiaPay Merchant Account and select Back to Previous Version

2. Select Payment Option under Profile > Profile Setting:-

3. Update the URL with your SchoolsBuddy URL in the four grey/white boxes (your URL will have been sent to you once your set-up is complete and the Super Admin users have been activated). Each box must have your establishment’s SchoolsBuddy URL followed by all the text as shown in the examples below

You will also need to update some Payment Options fields:-

1. Return Value Ink (data feed) - should be "enabled"
2. Data Feed failure alert by email - should be "enabled" ***
3. Payment method selection in payment page should be "by logo"
4. Paybooth Settings - Payment Access Code IGNORE this setting
5. Paybooth Settings - Auto-Generate Merchant Reference Number IGNORE this setting 

(a) Return Value Link (DataFeed) should read:

• Non-China Schools:
  https://yourSchoolsBuddydomain.schoolsbuddy.net/PaymentAsiaPayExternal/DataFeed
• China Schools:
  https://yourSchoolsBuddydomain.schoolsbuddy.cn/PaymentAsiaPayExternal/DataFeed

(b) Successful Page Return Url should read:

• Non-China Schools:
  https://yourSchoolsBuddydomain.schoolsbuddy.net/PaymentAsiaPay/Success
  
• China Schools:
  https://yourSchoolsBuddydomain.schoolsbuddy.cn/PaymentAsiaPay/Success
  

(c) Fail Page Return Url should read:

• Non-China Schools:
  https://yourSchoolsBuddydomain.schoolsbuddy.net/PaymentAsiaPay/Error
• China Schools:
  https://yourSchoolsBuddydomain.schoolsbuddy.cn/PaymentAsiaPay/Error

(d) Cancel Page Return Url should read:

• Non-China Schools:
  https://yourSchoolsBuddydomain.schoolsbuddy.net/PaymentAsiaPay/Cancel
• China Schools:
  https://yourSchoolsBuddydomain.schoolsbuddy.cn/PaymentAsiaPay/Cancel
  

Test a Payment in SchoolsBuddy 

Once setup has been confirmed, we will create a charge on a test student's account and link you as a parent to the test student. please make a test payment and confirm it's received in your Asiapay merchant account. 

When logging into your SchoolsBuddy account, you will see a charge for a small amount. Please click on the amount (as highlighted in the screenshot below) and proceed to make the test payment.

Please advise us of the successful test payment. If there is an error message please report it to us so we can see if it is a configuration issue for us or AsiaPay.