Add Money to Wallet And Debit API

This API allows merchants to add insufficient funds to a user's wallet and debit the total transaction amount in a single seamless operation.

Environment

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

Method: POST

Request parameters

Parameter	Description	Example
mid `mandatory`	`String` Unique parent merchant ID	`MBK9006`
cell `mandatory`	`String` Mobile number of the user	`9311032820`
amount `mandatory`	`Decimal` Total transaction amount	`250.00`
orderid `mandatory`	`String` Unique order identifier	`ORDER_123456`
token `mandatory`	`String` Valid wallet token for the user	`MBK_TOKEN_123456789`
merchantname `mandatory`	`String` Alias for the merchant	`TestMerchant`
redirecturl `mandatory`	`String` URL for transaction completion notifications	`https://merchant.com/callback`
checksum `mandatory`	`String` Calculated checksum for validation	`calculated_hash`
aggregatedMerchantId `optional`	`String` Unique ID for aggregated merchants (For Aggregators Only)	`AGG123`

Response parameters

Field	Description	Example
messagecode	`String` Message code from request	`504`
status	`String` Transaction status	`SUCCESS`
statuscode	`String` Numeric status code	`0`
statusdescription	`String` Description of the status	`Add money flow initiated successfully`
orderid	`String` Order identifier from request	`ORDER_123456`
txnid	`String` Mobikwik transaction ID	`MBK_TXN_789012345`
amount	`String` Transaction amount	`250.00`
wallet_balance	`String` Current wallet balance	`100.00`
added_amount	`String` Amount to be added to wallet	`150.00`
redirect_url	`String` URL for payment processing	`https://mobikwik.com/payment/process?token=xyz123`
checksum	`String` Response checksum for validation	`8feac7700a4efd1ef08ea0ec5bf5921c3f1fc3398944421978794b9ada1c2c47`

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.

Sample response

{
  "messagecode": "504",
  "status": "SUCCESS",
  "statuscode": "0",
  "statusdescription": "Add money flow initiated successfully",
  "orderid": "ORDER_123456",
  "txnid": "MBK_TXN_789012345",
  "amount": "250.00",
  "wallet_balance": "100.00",
  "added_amount": "150.00",
  "redirect_url": "https://mobikwik.com/payment/process?token=xyz123",
  "checksum": "8feac7700a4efd1ef08ea0ec5bf5921c3f1fc3398944421978794b9ada1c2c47"
}