Wallet Status Update API

This API uses to activate and deactivate the wallet. It is applicable for prepaid product issued on Pine Labs platform.

Why would I need to use this resource?

Third party can enable an activate and deactivate accountservicesto cardholder using this API resource. Cardholder can activate the account or deactivate existing account using this service.

HTTP Status and Response Status Matrix

  • HTTP Code: This is the response status code issued by a server in response to a client's request made to the server.
  • Error Code: This is the error code returned by Credit+ Issuing application in the ‘code’ field of the response message indicating if the request was processed successfully or failed.
  • Reason: This is the description of the error code returned by Credit+ Issuing application.
HTTP CodeError CodeReason
400997Wallet Number field is mandatory
400997Wallet Number field should be numeric.
400997Wallet Number field value must have min length 9
400997Wallet Number field value must have max length 24
400997Action Flag field is mandatory.
400997Action Flag field is invalid.
400997Remarksfield value must have max length 100
400BKWL001invalid transaction code
400BKWL002Invalid Wallet Number
400BKWL04Invalid Wallet Number
400BKWL05Invalid Client Code.
400HDE050Institution code is mandatory.
400HDE051Device number is mandatory
400HDE052Service code is mandatory.
400HDE019Invalid device number.
400HDE312Change atleast one value for walletstatus.
400HDE312Wallet is already Activated.
400HDE312Wallet is already De-Activated.
500999Internal error.
201BKWL000Request processed successfully.
400HDE100Device is not in normal state.
400HDE097Maximum number of Active currency allowed on Program exceeded.
400HDE098Available balance islessthan Zero. Wallet cannotset asinactive.
400HDE099There are some pending authorizations. Wallet cannot set as inactive.
500HDEERR002Internal error.
500HDE001Internal error.
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
length ≤ 2

Network Code associated to Acquirer ID

string
required
length between 9 and 24
^[0-9]+$

Wallet number, not NULL, numeric

string
enum
required
length ≤ 3

Action flag to activate or deactivate the wallet, not NULL, either ACT or STP

Allowed:
string
length ≤ 100

Additional remarks for the action, maximum length is 100 if present

Headers
string
^[a-zA-Z0-9-]{1,50}$

API Consumer must share Correlation-ID in HTTP header for API requests. The Correlation-ID must be unique for each request. It is recommended to generate a universally unique identifier (UUID) of length 32 or 36 that is compliant with RFC 4122. The maximum supported length is 50 alphanumeric characters. For example, ac97d177-9345-4934-8343-0f91a7a02836. If the Correlation-ID is not received in the incoming request, the system generates the UUID dynamically and assigns it to the request.

string

API Consumer can share Source in HTTP header for API requests. For the list of Source values, see the Pre-conditions for HTTP Header of REST API topic in the Pre-requisite for Rest API section.

Response

Language
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json