SecurePay
Search…
List
Merchant can fetch their transactions.

Endpoint URL

Environment
URL
Method
Sandbox
https://sandbox.securepay.my/api/v1/transactions/list
GET
Production
https://securepay.my/api/v1/transactions/list
GET

Credentials

uid (Merchant API UID)
2aaa1633-e63f-4371-9b85-91d936aa56a1
token (Merchant API Auth Token)
ZyUfF8EmyabcMWPcaocX

Parameters

Parameter
Description
per_page
How many data to display, default is 10 data and maximum 100 per page
page
Jump into a page. e.g: the data have 5 pages, to visit 3rd page just set page = 3
payment_status
Success payment is set to true and false for unsuccessful.
start_date
Search data by date range e.g start_date: 2020-09-10
end_date
Search data by date range e.g end_date: 2020-09-15
Default parameters list will be applied (refer Default section), If no parameters are supply during API request.
Both start_date and end_date need to be supplied for date range search. E.g For daily transaction on 20/09/2020 need to set start_date=2020-09-20 and end_date=2020-09-20
https://sandbox.securepay.my/api/v1/transactions/list?start_date=2020-09-20&end_date=2020-09-20

Default

Per page: 10 Maximum per page: 100 (Please use pagination if data more than 100) Payment status: Success (True) Data search limit: 3 months (90 days)

Paginate

Fetch 5 payments per page‌
https://sandbox.securepay.my/api/v1/payments/list?per_page=5
1
curl -u 2aaa1633-e63f-4371-9b85-91d936aa56a1:ZyUfF8EmyabcMWPcaocX https://sandbox.securepay.my/api/v1/transactions/list?per_page=1 | json_pp
Copied!
1
‌{
2
"next_page" : 2,
3
"current_page" : 1,
4
"per_page" : 1,
5
"total_page" : 375,
6
"prev_page" : null,
7
"total_entries" : 375,
8
"transactions" : [
9
{
10
"merchant_reference_number" : "IJNQS1629161503",
11
"fpx_debit_auth_code" : "00",
12
"interface_uid" : "4a73a364-6548-4e17-9130-c6e9bffa3081",
13
"payment_stage" : "payment_successful",
14
"buyer_name" : "abu",
15
"fpx_model" : "B2C",
16
"currency" : "MYR",
17
"merchant_name" : "SP SDN BHD",
18
"client_ip" : "103.145.216.156",
19
"payment_id" : 8172,
20
"order_number" : "7A2C840800",
21
"created_at" : "2021-08-17T08:51:51.156+08:00",
22
"source" : "FPX",
23
"retry_url" : null,
24
"fpx_transaction_time" : "20210817085144",
25
"payment_method" : "fpx_online_banking",
26
"payment_mode" : "merchant",
27
"fpx_bank" : "SBI BANK A",
28
"merchant_co_number" : "1273013-P",
29
"receipt_url" : "https://sandbox.securepay.my/api/v1/receipt/IJNQS1629161503.pdf?uid=67a90303bfa6d891070c",
30
"transaction_amount" : "20.00",
31
"fpx_name" : "[email protected]()/PYN .-&B'UYER",
32
"fpx_transaction_id" : "2108170851440009",
33
"fpx_status" : true,
34
"status_url" : "https://sandbox.securepay.my/api/v1/status/IJNQS1629161503?uid=67a90303bfa6d891070c",
35
"uid" : "67a90303bfa6d891070c",
36
"created_at_unixtime" : "1629161512",
37
"payment_status" : true,
38
"transaction_fee" : "1.20",
39
"fpx_status_message" : "Transaction Approved",
40
"transaction_amount_received" : "20.00",
41
"interface_name" : "Default",
42
"buyer_phone" : "",
43
"buyer_email" : "[email protected]"
44
}
45
]
46
}
47
Copied!
Getting second page‌
https://sandbox.securepay.my/api/v1/transactions/list?per_page=5&page=2
Example fetch 100 payments
https://sandbox.securepay.my/api/v1/transactions/list?per_page=100
Example fetch 100 payments on page 3
https://sandbox.securepay.my/api/v1/transactions/list?per_page=100&page=3‌

Payment status

There are true and false for payment status.‌
True status - Payment successfully received‌
False Status - Payment not successfully go through‌
To request the list by payment status e.g:
1. request success payment status (default) https://sandbox.securepay.my/api/v1/transactions/list?payment_status
https://sandbox.securepay.my/api/v1/transactions/list?payment_status=true
2. request failed payment status https://sandbox.securepay.my/api/v1/transactions/list?payment_status=false
3. request success and failed statushttps://sandbox.securepay.my/api/v1/transactions/list?payment_status=all
4. request success payment status with 10 data on page 2 https://sandbox.securepay.my/api/v1/transactions/list?payment_status=true&per_page=10&page=2
By default, if no payment_status is set the API will return success (true) status.‌

Data created date and time

Each data will have two types of format:
1. created_at e.g: 2020-09-27T17:19:43.593+08:00 2. created_at_unixtime e.g: 1601198383​

Get daily transaction list

Below example set start_date = 2020-09-27 and end_date = 2020-09-27
1
https://sandbox.securepay.my/api/v1/transactions/list?payment_status=all&per_page=50&end_date=2020-09-28&start_date=2020-09-27​
Copied!

Search by date range

Below example set start_date = 2020-09-15 and end_date = 2020-09-27
1
https://sandbox.securepay.my/api/v1/transactions/list?payment_status=false&per_page=5&end_date=2020-09-28&start_date=2020-09-15​
Copied!

Example using curl

Example 2 with header
1
curl -u 2aaa1633-e63f-4371-9b85-91d936aa56a1:ZyUfF8EmyabcMWPcaocX https://sandbox.securepay.my/api/v1/transactions/list?per_page=2 | json_pp
Copied!

Response values

Parameter
Description
source
FPX, Credit Card or other
payment_status
true - success payment and false - failed payment
currency
RM - Ringgit Malaysia (other currencies are not supported)
transaction_amount
Amount in RM for this transaction.
transaction_amount_received
Amount received, if payment_status false set to 0.00
order_number
Order Number sent previously by merchant.
merchant_reference_number
This number is generated by securepay platform
exchange_number
This number is generated by securepay platform
buyer_name
Buyer name
buyer_phone
Buyer phone
buyer_email
Buyer email
payment_id
For reference
transaction_fee
Transaction fee
fpx_model
B2C or B2B1
payment_mode
merchant, buyer or merchant_credit
payment_method
fpx_online banking or credit card
client_ip
Client IP address
status_url
SecurePay Status URL
retry_url
Any failed payment, can make retry using this links
receipt_url
SecurePay PDF receipt URL
created_at
Created date and time ISO8601 format
created_at_unixtime
Created date and time in unix time epoch format
Last modified 1mo ago