Get Load Card Status API

Request Method :: POST

Base URL: Will be shared later.

Endpoint: /ppcard/bulk/apiuser/loadcard/getLoadCardStatus

Description:This API allows to retrieve the status of a load transaction performed on a prepaid card.

Headers

Content-Type: application/JSON

header_secrets: These values must be generated each time while consuming the API (refer to the generation process mentioned in the note above).

client_id: To be shared during integration by ISU Team

Request Body Parameters

Parameters	Parameter description with validations	Data type	Mandatory/Optional
SRNumber	SR Number. E.g. - "SR20250723112916378"	String	Mandatory

Sample Request Body

{ "SRNumber": "SR20250723112916378" }

Response Body Parameters

Parameters	Description	Data type
statusCode	Status Code(0/1)	String
statusDesc	Status Description of Status	String
status	SUCCESS/FAILED	String
data	Fetched data	Array
loadcard_id	Load Card ID	Integer
device_id	Unique Identifier for the device.	String
mobile_no	Mobile Number.	String
customer_name	Name of the Customer	String
lat_long	Latitude and Longitude (location)	String
amount	Amount	String
channel	Channel	String
purpose	Purpose	String
sr_number	Sr. Number	String
pubsub_status	Pubsub Status	String
pubsub_statusdesc	Status Description of Pubsub	integer
pubsub_substatus	Substatus of Pubsub	String
load_status	Load Status	String
load_status_desc	Load Status Description	String
load_sub_status	Load Sub Status	integer
requested_user_name	Requested Username	String
created_date	Date of creation	String
updated_date	Date on which updated	String

Sample Response Body

SUCCESS:

{ "statusCode": 0, "status": "SUCCESS", "statusDesc": "Fetched Successfully.", "data": [ { "loadcard_id": 41, "device_id": "", "mobile_no": "9938227888", "customer_name": "CUST9938227888", "lat_long": "13.0931705,80.6478284", "amount": 1, "channel": "WEB", "purpose": "LOAD_CUSTOMER_BULK", "sr_number": "SR20250723112916378", "pubsub_status": "SUCCESS", "pubsub_statusdesc": "Published Successfully", "pubsub_substatus": 0, "load_status": "SUCCESS", "load_status_desc": "Card loaded successfull", "load_sub_status": 0, "requested_user_name": "RAVIFINTECH", "created_date": "2025-07-23T05:59:29.000Z", "updated_date": "2025-07-23T05:59:29.000Z" }, { "loadcard_id": 42, "device_id": "", "mobile_no": "9938227888", "customer_name": "CUST9938227888", "lat_long": "13.0931705,80.6478284", "amount": 1, "channel": "WEB", "purpose": "LOAD_CUSTOMER_BULK", "sr_number": "SR20250723112916378", "pubsub_status": "SUCCESS", "pubsub_statusdesc": "Published Successfully", "pubsub_substatus": 0, "load_status": "SUCCESS", "load_status_desc": "Card loaded successfull", "load_sub_status": 0, "requested_user_name": "RAVIFINTECH", "created_date": "2025-07-23T05:59:29.000Z", "updated_date": "2025-07-23T05:59:29.000Z" } ] }

FAILED:

If card is not mapped to the customer.

{ "statusCode": 1, "status": "FAILED", "statusDesc": "Invalid Body!!" }

Note:

A bulk load is considered successful only if:- The top-level response status is "SUCCESS", - And Each item inside the data array also has "load_status": "SUCCESS".

If any entry in the data array has a different load_status (e.g., "FAILED"), that specific load is considered failed, even if the overall API response status is "SUCCESS".