Check Status API - Mobikwik

This API is used to check the status of a transaction to determine whether it was successful, failed, or is still pending.

Environments

Environment	URL
Test	`https://test.mobikwik.com/checkstatus`
Production	`https://walletapi.mobikwik.com/checkstatus`

Method: POST

Request parameters

Parameter	Description	Example
mid `mandatory`	`String` Unique parent merchant ID	`MBK9006`
orderid `mandatory`	`String` Unique order identifier to check status	`ORDER_123456`
checksum `mandatory`	`String` Calculated checksum for validation	`calculated_hash`

Response parameters

Field	Description	Example
orderid	`String` Order identifier from request	`ORDER_123456`
txnid	`String` Mobikwik transaction ID	`MBK_TXN_789012345`
status	`String` Transaction status code	`0`
statusdescription	`String` Description of the status	`Transaction completed successfully`
amount	`String` Transaction amount	`250.00`
txndate	`String` Transaction date and time	`2025-01-17 10:30:00`
merchantname	`String` Merchant name	`TestMerchant`
checksum	`String` Response checksum for validation	`8feac7700a4efd1ef0 8ea0ec5bf5921c3f1fc 3398944421978794b9 ada1c2c47`

Response Attributes

The response checksum that will be returned to the users will have the following format:

📘
Note:
Always validate the response checksum to ensure data integrity and security.

Status & Status Code	Status Code	Status description
FAILURE	1	Failed
FAILURE	17	Merchant cancelled transaction
FAILURE	16	User cancelled transaction
FAILURE	20	Transaction expired
FAILURE	2	Pending
SUCCESS	0	Success / Refund / Partial Refund

Sample response

{
  "orderid": "ORDER_123456",
  "txnid": "MBK_TXN_789012345",
  "status": "0",
  "statusdescription": "Transaction completed successfully",
  "amount": "250.00",
  "txndate": "2025-01-17 10:30:00",
  "merchantname": "TestMerchant",
  "checksum": "8feac7700a4efd1ef08ea0ec5bf5921c3f1fc3398944421978794b9ada1c2c47"
}

Status codes

Status Code	Status	Description
0	SUCCESS	Transaction completed successfully
1	FAILURE	Transaction failed
2	PENDING	Transaction is still being processed
3	NOT_FOUND	Transaction not found in system