Overview | API Call | API Response

Validate Transaction

 

With this service you can get the latest status of your transactions, like with the “Notification Service”. But while the “Notification Service” sends the latest updates automatically to you (every 5 minutes), you can refresh the updates manually every time you want with this service.


API Call

 

Send this api call with a POST method to sandbox.hellopay.com.sg/merchant/transaction-events (remember to change the ending ‘com.sg’ to the ending of your country).

The content type should be application/json.

data={
"transactionId":"AAEAAADoKU7bislxLFcY3OVjNKG0kinnSZP1rUFIqESdPwblWE-xbU8",
"transactionType":"Purchase",
"shopConfig"="AAEAAADoKU7YCxb_Z9IU2RcBgnEg26xJsHuZCDK7cMK7vnm_vnTzGjLJ/AAEAAAgfi0MlUJfWeGEwG4ujB2VrcfJlF_L0PPqrhIjAnG4R6qiaKAar/a5c4123e5a1f196d896d908cf64764e1"
}
data={
"transactionId":"",
"transactionType":"Purchase",
"shopConfig"=""
}

Description

Transaction ID

The Transaction ID is the Purchase ID you got with the success API Respond of the ‘Create a transaction’ API Call!

Transaction Type

Just use "Purchase"! Payment is when a user tops up his account.

Your ShopConfig

Also called API Key, you can find it in your merchant account of the sandbox in “Account Settings”.


API Response

This is the response, that you will get! That means you don’t need to provide this data, you’ll receive it.

Success Response

{
 "success":true,
 "transactionEvents":[
   {
   "creationDateTime":"2015-10-02T14:14:10Z",
   "transactionType":"Purchase",
   "newStatus":"Created",
   "oldStatus":null,
   "transactionId":"AAEAAADoKU7bislxLFcY3OVjNKG0kinnSZP1rUFIqESdPwblWE-xbU8",
   "merchantReferenceId": "872116"
   }
 ]
}
Failure Response

{
"success":false,
}

Description

Success

A boolean so you can check, if it’s a success or failure response.

Transaction Events

The transaction event is an array of objects, which can include multiple transactions! For each transaction status, it will create an own object and not replace the old one! That means if the old status was “created” and the new one is “committed”, it will be in the next element of the array!

the regular order of possible transaction status is:

1. Created
2. Committed
3. Completed

The status cannot jump from “Created” to “Completed”, but it also can always be “Cancelled” or “Expired”, which then is the final status!

Success

A boolean so you can check, if it’s a success or failure response.