Verify a mobile number

Verifies a mobile number against the configured payment provider. This endpoint allows you to validate mobile money account details before initiating payout transactions, helping reduce failed payouts and providing account holder information when available.

Authentication

AuthorizationBearer

OAuth 2.0 access token

Request

This endpoint expects an object.

phoneNumberstringRequired

Mobile number to verify. Should include country code prefix (e.g., 254 for Kenya)

countryenumRequired

3-letter ISO country code (e.g., KEN for Kenya)

Allowed values:

merchantIdstringRequired

Merchant ID for the verification request

Response

Mobile number verification result

verifiedboolean

Whether the mobile number was successfully verified with the provider

accountNamestring or null

Account holder name if available

statusstring or null

Verification status (e.g., ACTIVE)

1	import requests
2
3	url = "https://api.crisscross.money/v1/verification/mobile"
4
5	payload = {
6	"phoneNumber": "254712345678",
7	"country": "KEN",
8	"merchantId": "your-merchant-id"
9	}
10	headers = {
11	"Authorization": "Bearer <token>",
12	"Content-Type": "application/json"
13	}
14
15	response = requests.post(url, json=payload, headers=headers)
16
17	print(response.json())

1	{
2	"verified": true,
3	"accountName": "Jane Smith",
4	"status": "ACTIVE"
5	}

Authentication

Request

Response

Errors