SchoolsBuddy Help Centre Help Centre home page
Product

Online Payments - AsiaPay set Up

 

Payment Provider - AsiaPay


Your step-by-step guide to getting online payments set up for your SchoolsBuddy portal.

1. Email Introduction

SchoolsBuddy does not currently offer direct bank integration for payments - we use a 3rd party provider - AsiaPay (Their credit debit card system is PayDollar). You will receive an email from us, to introduce you to your regional AsiaPay contact.

These are the 3 virtual payment types for Asiapay and need to be set up separately.

  • UnionPay
  • WeChat
  • Alipay

2. AsiaPay Initial Contact, Proposal & Process

Your AsiaPay regional contact will then arrange a suitable time with you to discuss your requirements. Once you have agreed on terms, they will send you the applicable proposal for your organisation, for you to sign and return.

AsiaPay will work with you to ensure the relevant requirements and authorisation for set up with us and your bank are provided. All documents will be sent directly to you. 

The contract is between your school and AsiaPay, SchoolsBuddy is not involved in this process.

Please allow time for the Bank approval process to be completed. Typical documents required by the banks for the approval process (this may change by region):-

  • Bank Agreement for Standard
  • Copy of CEO's ID card and household of authorised person
  • Copy of certificate of authorisation
  • Copy of Bank Account

 

3. Testing

AsiaPay will send you instructions for a test payment with the Testing environment. It should include a Sample Payment Page, a Test Merchant Admin link and usually some Testing Card Accounts to use. The email should slook like this:-

 

FOR PAYMENT INTEGRATION DEVELOPER

Payment Connection Page (implement it with your own payment page)

  1. Merchant Id = 123456
  2. Currency = Your local currency
  3. AsiaPay/Siampay Sample Payment Page =

https://test.siampay.com/b2cDemo/eng/payment/testPay.html

 

Access to Merchant Administration functions: e.g. Transaction Report

  1. Merchant Admin link= https://test.siampay.com/b2cDemo/eng/merchant/index.html
  2. Merchant Id = 123456
  3. Login Name = Admin1234
  4. Password    = Admin1234  

Testing Card Accounts - (please use the following accounts on testing platform) - they will send you shortened card numbers to use for testing with CVVs - usually Mastercard, VISA. etc

 

4. AsiaPay Credentials

Once the account testing and setup is complete, we have to do the set up at this end and will need your AsiaPay credentials to complete the integration. The credentials should be sent to us securely using this online form.  Please do not submit them in the body of an email. You will also need to add an alternative email address for the test payment (see Step 5 below). 

  1. Account Number/Merchant ID  - usually a 9 digit number
  2. Secret hash/key - a combination of random letters and numbers
  3. API Username - usually a combination of the word api with the AsiaPay shortened version of your school name ID e.g apiisv for International School of Victoria.
  4. API Password token - usually the AsiaPay shortened version of your school name ID plus 4 digits e.g isv1234 for International School of Victoria.

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

 

5. Payment Response URLs

You will need to update the payment response URLs  - see screenshots for guidance. 

Log into your AsiaPay Merchant Account and select Payment Option under Profile > Profile Setting:-

asiapay_merchant_profile.png

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

 

  1. Return Value Link (DataFeed) should read: https://yourschoolurl.schoolsbuddy.net/PaymentAsiaPayExternal/DataFeed
  2. Successful Page Return Url should read: https://yourschoolurl.schoolsbuddy.net/PaymentAsiaPay/Success
  3. Fail Page Return Url should read: https://yourschoolurl.schoolsbuddy.net/PaymentAsiaPay/Error
  4. Cancel Page Return Url should read: https://yourschoolurl.schoolsbuddy.net/PaymentAsiaPay/Cancel

asipay_response_urls_image.png

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

***Data feed failure alerts may be sent to you if a payment has been taken by AsiaPay, but has not been recorded in SchoolsBuddy due to a data feed failure.  If this occurs you will need to login to your AsiaPay portal and Resend the Data Feed to SchoolsBuddy, and alert the SchoolsBuddy Support team by sending an email to help@schoolsbuddy.com

2021-12-30_14-16-56.png

 

6. SchoolsBuddy Test Payment

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.

 

 

Related articles