Check a Mobile Money Number
Find out who a mobile money number is registered to before you send money to it or save it.
Send a mobile money number and its network, and Seev returns the name the network has registered against it. Use it to show your user who they are about to pay, or to catch a mistyped number before you save it as a payout destination.
You are about to send money to a number, or save one as a destination, and want to show the person who it belongs to first.
Bank accounts. The lookup covers mobile money only.
An API key from the Developer Dashboard.
Look up a number
curl -X POST \
https://api.seevplus.com/api/v1/developer/resolve-account \
-H "Authorization: Bearer $SEEV_CHECKOUT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"settlement_bank": "mtn",
"account_number": "0241234567"
}'{
"success": true,
"data": {
"settlement_bank": "mtn",
"account_number": "0241234567",
"account_name": "AMA MENSAH"
}
}The response gives the network code and the number back in a standard form, so you can store what Seev returns rather than what your user typed.
The number's network: mtn, telecel or at. Older names work too,
such as vodafone for Telecel and airteltigo for AT.
A Ghana mobile number. 0241234567, 241234567 and 233241234567
are all accepted, with or without spaces, and come back as
0241234567.
When a lookup fails
The number is not a valid Ghana mobile number, or the body is not valid JSON.
The API key is missing or not recognised.
The key is not allowed from this IP address, or the organization is suspended.
The network has no name registered for the number. Ask your user to check the number and the network.
settlement_bank is a bank code. Only mobile money numbers can be
looked up.
The network could not be reached. Try again shortly.
Errors come back in the same shape as the rest of the API. See Errors.
Sandbox keys look up real numbers and return real names, the same as live keys. Test with your own number or one you have permission to use.
Show the name to your user
A registered name is personal information. Show it to the person sending the money so they can confirm it, and do not use the lookup to collect names for numbers you have no reason to pay.
The name is what the network holds, which is often in capitals and sometimes a shortened or older form of the person's name. Ask your user to confirm it is the right person rather than matching it exactly against a name they typed.