The Change Wallet Status API is used to change the wallet status on different aspects. A wallet can have the following states:

Status	Description
Active	Wallet is in the active state, it can used for all sorts of transactions.
Custom	Wallet will be Custom Blocked (partial transactions will be allowed) _ Cashback and refund can be received. _ Load can be blocked while unload may work or vice versa.
Temporary	Wallet will be Temporary Blocked (No transactions will be permitted)
Permanent	Wallet will be permanently blocked
Closed	Wallet will be closed
Debit	All debits from the wallet will be temporarily blocked
Credit	All credits to the wallet will be temporarily blocked
CreditDebit	All Credits and Debits will not be allowed, except system reversal credits and debits.
Dormant	Wallet will be in a dormant state. (same as temporary blocked)

Environment


Sandbox	payusandbox-kong.pc.enstage-sas.com/api/v2/encrypt
Production	Contact your WIBMO KAM or support.

Sample request

curl --request PATCH \
     --url https://payusandbox-kong.pc.enstage-sas.com/uat/sbx/api/onboarding/v1/walletStatus \
     --header 'X-Consumer-Custom-ID: F42BC4E7B801C834B630DE498473533F' \
     --header 'bankId: 6060' \
     --header 'clientId: 1060' \
     --header 'content-type: application/json' \
     --header 'entityId: 100' \
     --header 'secureCode: pu8gSMLNE7pNv36IlUmstU' \
     --header 'x-api-key: 4A02C4267C9A97A1488AB3259FD1A725' \
     --data '
{
  "token": "VD7M7y2rR8+acZCJg2QHFDZ64EWbRiAXvobbauBVlydw0ueHsFHqnBM5BeODp68mdapXgXkHh/8twzh37WPckF58m7r+jsn2iVDqas9b/MatZVuv5n9o8ILz3cSjgrYPm5I0VvDrH7HspN5QZGMmMu81SE7w4JH2naeNdZXSIREPTazScQCjmq3uWbGr5vMe9+yjcf+loJhVvTR/mGh1KHcM9BsytuNTWFy6b7J4a83f9BCkPNzcu3axfKaDI4MkIrDyPbWJNftyvqrYP0bRTw=="
}
'

Response parameters

This API will provide a token in the response that must be decrypted using the Decrypt API. The decrypted response is similar to the following:

Attribute	Type	Parameter Requirement	Description
messageCode	Numeric(4)	Mandatory	API Unique IDentifier.
clientTxnId	String(100)	Mandatory	Value echoed from the request
accountNumber	String(20)	Mandatory	Value echoed from the request
accosaTransactionId	Numeric(10)	Mandatory	Unique ID for a particular transaction generated in Prepaid
description	String(100)	Optional	Reserved field to send information to client.
accosaRefNo	Numeric(20)	Mandatory	Auto-generated sequence number.

Sample response (Decrypted)

{ 
    "accountNumber": “30003958135_1”, 
    "description": "[RESERVE_1]", 
    "responseCode": "00", 
    "messageCode": “3531”, 
      "clientTxnId": "BLOCK_JM_aax11LrjoCV-f34", 
      "clientId": "2000", 
      "responseDateTime": "20230615234800", 
      "responseMessage": "SUCCESS", 
      "bankId": 7000, 
      "accosaRefNo": "52" 
}

Response parameters

Error Code	Description
00	SUCCESS
1030	INVALID MESSAGE
1031	INVALID BANK ID
1032	INVALID_CLIENT_CHANNEL
1034	INVALID_MOBILE_NUMBER
1045	UNABLE TO PROCESS REQUEST
1049	INVALID SECURE CODE
1054	DUPLICATE REQUEST
1056	INVALID MESSAGE CODE
1081	OPERATION NOT ALLOWED
1088	INVALID REQUEST DATE format
1093	INVALID CLIENT TXN ID
1112	INVALID BLOCK TYPE
1231	DATA_NOT_FOUND
1237	DUPLICATE_PHONE_NUMBER_WITH_MULTIPLE_ACCOUNT
1294	SOURCE_ACCT_CANNOT_BE_BLANK
1320	REQUEST_DATETIME_IS_MANDATORY
1366	PROGRAM IS INACTIVE
1367	PROGRAM NOT FOUND
1377	INVALID_LENGTH_OF_CLIENT_TXN_ID
1500	SYSTEM ERROR
1502	SYSTEM ERROR
5003	CLIENT_NOT_CONFIGURED_UNDER_BANK_ID
6000	ACCOUNT DORMANT
6001	ACCOUNT NOT FOUND
6002	ACCOUNT PERMANENTLY BLOCKED OR CLOSED
6003	STATUS_TYPE_IS_MANDATORY
6004	INVALID STATUS TYPE
6005	ACCOUNT ALREADY IN ACTIVE STATE
6006	ACCOUNT ALREADY IN CUSTOM BLOCKED STATE
6007	ACCOUNT ALREADY IN TEMPORARY BLOCKED STATE
6008	ACCOUNT ALREADY IN CREDIT BLOCKED STATE
6009	ACCOUNT ALREADY IN DEBIT BLOCKED STATE
6010	ACCOUNT ALREADY IN CREDIT_DEBIT BLOCKED STATE
6011	ACCOUNT ALREADY IN PERMANENTLY BLOCKED/CLOSED STATE
6012	ACCOUNT ALREADY IN DORMANT STATE
6013	ACCOUNT IN CUSTOM BLOCKED STATE
6014	ACCOUNT IN TEMPORARILY BLOCKED STATE
6015	ACCOUNT IN PERMAMENTLY BLOCKED STATE
6016	ACCOUNT IN CREDIT BLOCKED STATE
6017	ACCOUNT ALREADY IN CREDIT_DEBIT BLOCKED STATE
6018	ACCOUNT ALREADY IN DEBIT BLOCKED STATE
6911	Invalid reserved field 1
6912	Invalid reserved field 2
303178	Request DateTime Format should not be more than 14 characters
303193	Message Code cannot be blank,null or empty

Request parameters