Skip to main content
POST
Validate a phone number against a customer name before payout
Before disbursing a payout, confirm the recipient’s name matches what the receiving mobile money provider has on file for that phone number — reduces the risk of sending funds to the wrong person. The phone number and network checked are always the ones already on file for the customer_key you pass — you can’t look up an arbitrary phone number, only an existing mobile money customer.
This feature is gated per integrator. If your account doesn’t have it enabled, contact sales@kotanipay.com to request access.
Match scoring (matchScore) is only available for some payout corridors — it may be absent even on a MATCHED result.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
walletId
string
required

The fiat wallet the payout would be debited from — used to resolve which provider would actually handle it.

Example:

"5f9b2c7b9c9d6b0017b4e6b1"

customer_key
string
required

Customer key of an existing mobile-money customer. The phone number, network, and name validated are always the ones already on file for this customer — not arbitrary values — so the result reflects who would actually receive this payout.

Example:

"customer-key-123"

Response

success
boolean
Example:

true

message
string
Example:

"Name lookup completed."

data
object