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" : "[email protected]",
"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