Skip to main content
POST
/
payment_account_lookup
Payment Account Lookup
curl --request POST \
  --url https://mobiska-api.stimuluzdev.com/payment_account_lookup \
  --header 'Content-Type: application/json' \
  --data '
{
  "service_id": 123,
  "pan": "<string>",
  "nw": "<string>"
}
'
{
  "response_code": "<string>",
  "response_message": "<string>",
  "response_data": {
    "account_name": "<string>",
    "account_status": "<string>",
    "account_type": "<string>"
  }
}
Lookup and verify payment account details before processing a transaction.

​
Request Body

​
service_id
integer
required
Your service identifier
​
pan
string
required
Phone number or account number to lookup
​
nw
string
required
Network provider code (e.g., “MTN”, “VODA”, “AIRTELTIGO”)

​
Example Request

curl -X POST https://mobiska-api.stimuluzdev.com/payment_account_lookup \
  -H "Authorization: Basic YOUR_ENCODED_API_KEYS" \
  -H "Content-Type: application/json" \
  -d '{
    "service_id": 1,
    "pan": "0541840988",
    "nw": "MTN"
  }'

​
Response

​
response_code
string
Status code of the request
​
response_message
string
Human-readable status message
​
response_data
object
{
  "response_code": "000",
  "response_message": "Account found",
  "response_data": {
    "account_name": "John Doe",
    "account_status": "active",
    "account_type": "mobile_money"
  }
}
Account lookup is recommended before initiating payments to ensure the recipient account is valid and active.