Status

Endpoint URL

Search using order number (generated by merchant)

Environment

URL

Method

Sandbox

https://sandbox.securepay.my/api/v1/payments/status/:order_number

GET

Production

https://securepay.my/api/v1/payments/status/:order_number

GET

Search using merchant number (generated by SecurePay)

Environment

URL

Sandbox

https://sandbox.securepay.my/api/v1/payments/status/merchant_reference_number/:merchantrefnumber

Production

https://securepay.my/api/v1/payments/status/merchant_reference_number/:merchantrefnumber

:order_number is a unique order number generated by merchant end for reference.

Credentials

uid (Merchant API UID)

2aaa1633-e63f-4371-9b85-91d936aa56a1

token (Merchant API Auth Token)

ZyUfF8EmyabcMWPcaocX

Example using curl

curl -u 2aaa1633-e63f-4371-9b85-91d936aa56a1:ZyUfF8EmyabcMWPcaocX https://sandbox.securepay.my/api/v1/payments/status/20200927045002577 | json_pp
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100   786    0   786    0     0  16040      0 --:--:-- --:--:-- --:--:-- 16040
{
   "buyer_name" : "ADAM HARIS AHMAD",
   "buyer_phone" : "+60123122999",
   "exchange_number" : "MXKJI1601182203",
   "receipt_url" : "https://sandbox.securepay.my/api/v1/receipt/MXKJI1601182203.pdf?uid=e549ab7f07af9e52673e",
   "status_url" : "https://sandbox.securepay.my/api/v1/status/MXKJI1601182203?uid=e549ab7f07af9e52673e",
   "merchant_reference_number" : "MXKJI1601182203",
   "client_ip" : "14.192.210.186",
   "payment_status" : true,
   "transaction_amount" : "50.00",
   "order_number" : "20200927045002577",
   "currency" : "MYR",
   "buyer_email" : "amir@localhost.my",
   "payment_id" : 2159,
   "retry_url" : null,
   "interface_name": "Default",
   "interface_uid": "8db044bd-b450-4126-a0cd-101c0ba7b3ee",
   "source" : "FPX",
   "transaction_amount_received" : "50.00",
   "created_at": "2020-09-29T19:15:42.419+08:00",
   "created_at_unixtime": "1601378142"
}

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

interface_name

API name

interface_uid

API UID

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

Last updated