Change Wallet Status API

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

StatusDescription
ActiveWallet is in the active state, it can used for all sorts of transactions.
CustomWallet 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.
TemporaryWallet will be Temporary Blocked (No transactions will be permitted)
PermanentWallet will be permanently blocked
ClosedWallet will be closed
DebitAll debits from the wallet will be temporarily blocked
CreditAll credits to the wallet will be temporarily blocked
CreditDebitAll Credits and Debits will not be allowed, except system reversal credits and debits.
DormantWallet will be in a dormant state. (same as temporary blocked)

Environment

Sandboxpayusandbox-kong.pc.enstage-sas.com/api/v2/encrypt
ProductionContact 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:

AttributeTypeParameter RequirementDescription
messageCodeNumeric(4)MandatoryAPI Unique IDentifier.
clientTxnIdString(100)MandatoryValue echoed from the request
accountNumberString(20)MandatoryValue echoed from the request
accosaTransactionIdNumeric(10)MandatoryUnique ID for a particular transaction generated in Prepaid
descriptionString(100)OptionalReserved field to send information to client.
accosaRefNoNumeric(20)MandatoryAuto-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 CodeDescription
00SUCCESS
1030INVALID MESSAGE
1031INVALID BANK ID
1032INVALID_CLIENT_CHANNEL
1034INVALID_MOBILE_NUMBER
1045UNABLE TO PROCESS REQUEST
1049INVALID SECURE CODE
1054DUPLICATE REQUEST
1056INVALID MESSAGE CODE
1081OPERATION NOT ALLOWED
1088INVALID REQUEST DATE format
1093INVALID CLIENT TXN ID
1112INVALID BLOCK TYPE
1231DATA_NOT_FOUND
1237DUPLICATE_PHONE_NUMBER_WITH_MULTIPLE_ACCOUNT
1294SOURCE_ACCT_CANNOT_BE_BLANK
1320REQUEST_DATETIME_IS_MANDATORY
1366PROGRAM IS INACTIVE
1367PROGRAM NOT FOUND
1377INVALID_LENGTH_OF_CLIENT_TXN_ID
1500SYSTEM ERROR
1502SYSTEM ERROR
5003CLIENT_NOT_CONFIGURED_UNDER_BANK_ID
6000ACCOUNT DORMANT
6001ACCOUNT NOT FOUND
6002ACCOUNT PERMANENTLY BLOCKED OR CLOSED
6003STATUS_TYPE_IS_MANDATORY
6004INVALID STATUS TYPE
6005ACCOUNT ALREADY IN ACTIVE STATE
6006ACCOUNT ALREADY IN CUSTOM BLOCKED STATE
6007ACCOUNT ALREADY IN TEMPORARY BLOCKED STATE
6008ACCOUNT ALREADY IN CREDIT BLOCKED STATE
6009ACCOUNT ALREADY IN DEBIT BLOCKED STATE
6010ACCOUNT ALREADY IN CREDIT_DEBIT BLOCKED STATE
6011ACCOUNT ALREADY IN PERMANENTLY BLOCKED/CLOSED STATE
6012ACCOUNT ALREADY IN DORMANT STATE
6013ACCOUNT IN CUSTOM BLOCKED STATE
6014ACCOUNT IN TEMPORARILY BLOCKED STATE
6015ACCOUNT IN PERMAMENTLY BLOCKED STATE
6016ACCOUNT IN CREDIT BLOCKED STATE
6017ACCOUNT ALREADY IN CREDIT_DEBIT BLOCKED STATE
6018ACCOUNT ALREADY IN DEBIT BLOCKED STATE
6911Invalid reserved field 1
6912Invalid reserved field 2
303178Request DateTime Format should not be more than 14 characters
303193Message Code cannot be blank,null or empty

Request parameters

Language
URL
Click Try It! to start a request and see the response here!