List

Merchant can fetch their transactions.

Endpoint URL

Credentials

Parameters

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

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

curl -u 2aaa1633-e63f-4371-9b85-91d936aa56a1:ZyUfF8EmyabcMWPcaocX https://sandbox.securepay.my/api/v1/transactions/list?per_page=1 | json_pp 
‌{
   "next_page" : 2,
   "current_page" : 1,
   "per_page" : 1,
   "total_page" : 375,
   "prev_page" : null,
   "total_entries" : 375,
   "transactions" : [
      {
         "merchant_reference_number" : "IJNQS1629161503",
         "fpx_debit_auth_code" : "00",
         "interface_uid" : "4a73a364-6548-4e17-9130-c6e9bffa3081",
         "payment_stage" : "payment_successful",
         "buyer_name" : "abu",
         "fpx_model" : "B2C",
         "currency" : "MYR",
         "merchant_name" : "SP SDN BHD",
         "client_ip" : "103.145.216.156",
         "payment_id" : 8172,
         "order_number" : "7A2C840800",
         "created_at" : "2021-08-17T08:51:51.156+08:00",
         "source" : "FPX",
         "retry_url" : null,
         "fpx_transaction_time" : "20210817085144",
         "payment_method" : "fpx_online_banking",
         "payment_mode" : "merchant",
         "fpx_bank" : "SBI BANK A",
         "merchant_co_number" : "1273013-P",
         "receipt_url" : "https://sandbox.securepay.my/api/v1/receipt/IJNQS1629161503.pdf?uid=67a90303bfa6d891070c",
         "transaction_amount" : "20.00",
         "fpx_name" : "N@m3()/PYN .-&B'UYER",
         "fpx_transaction_id" : "2108170851440009",
         "fpx_status" : true,
         "status_url" : "https://sandbox.securepay.my/api/v1/status/IJNQS1629161503?uid=67a90303bfa6d891070c",
         "uid" : "67a90303bfa6d891070c",
         "created_at_unixtime" : "1629161512",
         "payment_status" : true,
         "transaction_fee" : "1.20",
         "fpx_status_message" : "Transaction Approved",
         "transaction_amount_received" : "20.00",
         "interface_name" : "Default",
         "buyer_phone" : "",
         "buyer_email" : "nawawijamili@gmail.com"
      }
   ]
}

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:

Get daily transaction list

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

https://sandbox.securepay.my/api/v1/transactions/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/transactions/list?payment_status=false&per_page=5&end_date=2020-09-28&start_date=2020-09-15​

Example using curl

Example 2 with header

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

Response values

Last updated