List (deprecated and no longer available)

Merchant can fetch their transactions. This endpoint is no longer available, please refer to new one.

Endpoint URL

Environment

URL

Method

Sandbox

https://sandbox.securepay.my/api/v1/payments/list

GET

Production

https://securepay.my/api/v1/payments/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/payments/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

and the response will be paginated and also will include pagination headers

Get pagination info from header

curl -i -H "Application/json" -u 2aaa1633-e63f-4371-9b85-91d936aa56a1:ZyUfF8EmyabcMWPcaocX https://sandbox.securepay.my/api/v1/payments/list?per_page=5

X-Total: 6
X-Total-Pages: 2
X-Page: 1
X-Per-Page: 5
X-Next-Page: 2
X-Prev-Page: 
X-Offset:

Getting second page

https://sandbox.securepay.my/api/v1/payments/list?per_page=5&page=2

X-Total: 6
X-Total-Pages: 2
X-Page: 2
X-Per-Page: 5
X-Next-Page: 
X-Prev-Page: 1
X-Offset:

Example fetch 100 payments data

https://sandbox.securepay.my/api/v1/payments/list?per_page=100

X-Total: 380
X-Total-Pages: 4
X-Page: 1
X-Per-Page: 100
X-Next-Page: 2
X-Prev-Page: 
X-Offset:

https://sandbox.securepay.my/api/v1/payments/list?per_page=100&page=3

X-Total: 380
X-Total-Pages: 4
X-Page: 3
X-Per-Page: 100
X-Next-Page: 4 
X-Prev-Page: 2
X-Offset:

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/payments/list?payment_status

https://sandbox.securepay.my/api/v1/payments/list?payment_status=true

2. request failed payment status https://sandbox.securepay.my/api/v1/payments/list?payment_status=false

3. request success and failed statushttps://sandbox.securepay.my/api/v1/payments/list?payment_status=all

4. request success payment status with 10 data on page 2 https://sandbox.securepay.my/api/v1/payments/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

https://sandbox.securepay.my/api/v1/payments/list?payment_status=all&per_page=50&end_date=2020-09-28&start_date=2020-09-27

Search by date range

Below example set start_date = 2020-09-15 and end_date = 2020-09-27

https://sandbox.securepay.my/api/v1/payments/list?payment_status=false&per_page=5&end_date=2020-09-28&start_date=2020-09-15

Example using curl

curl -u 2aaa1633-e63f-4371-9b85-91d936aa56a1:ZyUfF8EmyabcMWPcaocX https://sandbox.securepay.my/api/v1/payments/list?per_page=2 | json_pp
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100  1367    0  1367    0     0  14698      0 --:--:-- --:--:-- --:--:-- 14698
[
   {
      "payment_status" : true,
      "exchange_number" : "TCKVR1601378132",
      "client_ip" : "175.139.210.207",
      "payment_id" : 2171,
      "retry_url" : null,
      "status_url" : "https://sandbox.securepay.my/api/v1/status/TCKVR1601378130?uid=266c1e922692a8dc1187",
      "source" : "FPX",
      "created_at_unixtime" : "1601378142",
      "transaction_amount" : "50.00",
      "created_at" : "2020-09-29T19:15:42.419+08:00",
      "transaction_amount_received" : "50.00",
      "buyer_name" : "ADAM HARIS AHMAD",
      "merchant_reference_number" : "TCKVR1601378130",
      "receipt_url" : "https://sandbox.securepay.my/api/v1/receipt/TCKVR1601378130.pdf?uid=266c1e922692a8dc1187",
      "order_number" : "20200929111530266",
      "currency" : "MYR",
      "buyer_phone" : "+60123121977",
      "buyer_email" : "amir@localhost.my"
   },
   {
      "retry_url" : null,
      "exchange_number" : "KWATI1601198351",
      "payment_status" : true,
      "payment_id" : 2161,
      "client_ip" : "14.192.214.33",
      "created_at_unixtime" : "1601198383",
      "source" : "FPX",
      "transaction_amount" : "50.00",
      "status_url" : "https://sandbox.securepay.my/api/v1/status/KWATI1601198371?uid=201b7fa16595498091cb",
      "merchant_reference_number" : "KWATI1601198351",
      "buyer_name" : "AMIR DAUD AHMAD",
      "receipt_url" : "https://sandbox.securepay.my/api/v1/receipt/KWATI1601198371.pdf?uid=201b7fa16595498091cb",
      "transaction_amount_received" : "50.00",
      "created_at" : "2020-09-27T17:19:43.593+08:00",
      "buyer_phone" : "+60123121977",
      "currency" : "MYR",
      "buyer_email" : "amir@localhost.my",
      "order_number" : "20200927091930866"
   }
]

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

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

PreviousSearchNextGuides

Last updated