Skip to content

Add documentation for MWK, UGX, and XOF mobile money accounts #245

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
claude wants to merge 2 commits into
base: main
Choose a base branch
from
Open

Add documentation for MWK, UGX, and XOF mobile money accounts #245

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
6869b34
Add documentation for MWK, UGX, and XOF mobile money accounts
github-actions[bot] Mar 4, 2026
ec70aa2
[hurlicane] Document mobile money providers for Malawi and Uganda tabs
Mar 5, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
115 changes: 115 additions & 0 deletions mintlify/snippets/external-accounts.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -395,6 +395,111 @@ curl -X POST 'https://api.lightspark.com/grid/2025-10-13/customers/external-acco
</Note>
</Tab>

<Tab title="Malawi">
**MWK Mobile Money**

```bash cURL
curl -X POST 'https://api.lightspark.com/grid/2025-10-13/customers/external-accounts' \
-H 'Authorization: Basic $GRID_CLIENT_ID:$GRID_CLIENT_SECRET' \
-H 'Content-Type: application/json' \
-d '{
"currency": "MWK",
"platformAccountId": "mw_mobile_001",
"accountInfo": {
"accountType": "MWK_ACCOUNT",
"phoneNumber": "+265991234567",
"provider": "AIRTEL",
"beneficiary": {
"beneficiaryType": "INDIVIDUAL",
"fullName": "Chimwemwe Banda",
"birthDate": "1993-03-18",
"nationality": "MW",
"address": {
"line1": "Kamuzu Procession Road",
"city": "Lilongwe",
"postalCode": "00100",
"country": "MW"
}
}
}
}'
```

<Note>
Phone number must be in format `+265XXXXXXXXX` (9 digits after country code). Providers: `AIRTEL` or `TNM`.
</Note>
</Tab>

<Tab title="Uganda">
**UGX Mobile Money**

```bash cURL
curl -X POST 'https://api.lightspark.com/grid/2025-10-13/customers/external-accounts' \
-H 'Authorization: Basic $GRID_CLIENT_ID:$GRID_CLIENT_SECRET' \
-H 'Content-Type: application/json' \
-d '{
"currency": "UGX",
"platformAccountId": "ug_mobile_001",
"accountInfo": {
"accountType": "UGX_ACCOUNT",
"phoneNumber": "+256701234567",
"provider": "MTN",
"beneficiary": {
"beneficiaryType": "INDIVIDUAL",
"fullName": "Nakato Sarah",
"birthDate": "1990-07-25",
"nationality": "UG",
"address": {
"line1": "Kampala Road 45",
"city": "Kampala",
"postalCode": "00100",
"country": "UG"
}
}
}
}'
```

<Note>
Phone number must be in format `+256XXXXXXXXX` (9 digits after country code). Providers: `MTN` or `AIRTEL`.
</Note>
</Tab>

<Tab title="West Africa">
**XOF Mobile Money (Senegal, Benin, Ivory Coast)**

```bash cURL
curl -X POST 'https://api.lightspark.com/grid/2025-10-13/customers/external-accounts' \
-H 'Authorization: Basic $GRID_CLIENT_ID:$GRID_CLIENT_SECRET' \
-H 'Content-Type: application/json' \
-d '{
"currency": "XOF",
"platformAccountId": "xof_mobile_001",
"accountInfo": {
"accountType": "XOF_ACCOUNT",
"phoneNumber": "+221781234567",
"provider": "ORANGE",
"beneficiary": {
"beneficiaryType": "INDIVIDUAL",
"fullName": "Mamadou Diallo",
"birthDate": "1988-11-12",
"nationality": "SN",
"address": {
"line1": "Avenue Cheikh Anta Diop",
"city": "Dakar",
"postalCode": "10000",
"country": "SN"
}
}
}
}'
```

<Note>
Supported countries: Senegal (+221), Benin (+229), and Ivory Coast (+225). Phone formats vary by country.
</Note>
Comment on lines +498 to +500
Copy link
Contributor

@greptile-apps greptile-apps bot Mar 5, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The XOF note states "Phone formats vary by country" but doesn't specify the per-country digit requirements. However, the validation regex (line 720) and other mobile money tabs show this information is important for developers:

  • Senegal (+221): exactly 9 digits
  • Ivory Coast (+225): exactly 10 digits
  • Benin (+229): 8–9 digits

For consistency with the Malawi, Uganda, and Rwanda tabs, the note should explicitly document the per-country digit formats:

Suggested change
<Note>
Supported countries: Senegal (+221), Benin (+229), and Ivory Coast (+225). Phone formats vary by country.
</Note>
<Note>
Supported countries and phone formats:
- Senegal (+221): `+221XXXXXXXXX` (9 digits after country code)
- Ivory Coast (+225): `+225XXXXXXXXXX` (10 digits after country code)
- Benin (+229): `+229XXXXXXXX` or `+229XXXXXXXXX` (8–9 digits after country code)
</Note>
Prompt To Fix With AI 
This is a comment left during a code review.
Path: mintlify/snippets/external-accounts.mdx
Line: 498-500

Comment:
The XOF note states "Phone formats vary by country" but doesn't specify the per-country digit requirements. However, the validation regex (line 720) and other mobile money tabs show this information is important for developers:

- Senegal (+221): exactly 9 digits
- Ivory Coast (+225): exactly 10 digits  
- Benin (+229): 8–9 digits

For consistency with the Malawi, Uganda, and Rwanda tabs, the note should explicitly document the per-country digit formats:

```suggestion
<Note>
  Supported countries and phone formats:
  - Senegal (+221): `+221XXXXXXXXX` (9 digits after country code)
  - Ivory Coast (+225): `+225XXXXXXXXXX` (10 digits after country code)
  - Benin (+229): `+229XXXXXXXX` or `+229XXXXXXXXX` (8–9 digits after country code)
</Note>
```

How can I resolve this? If you propose a fix, please make it concise.

</Tab>

<Tab title="Canada">
**CAD Bank Transfer**

Expand Down Expand Up @@ -605,6 +710,16 @@ if (!/^\+260\d{9}$/.test(zmwPhoneNumber)) {
if (!/^\+250\d{9}$/.test(rwfPhoneNumber)) {
throw new Error("Invalid Rwandan phone number");
}
if (!/^\+265\d{9}$/.test(mwkPhoneNumber)) {
throw new Error("Invalid Malawian phone number");
}
if (!/^\+256\d{9}$/.test(ugxPhoneNumber)) {
throw new Error("Invalid Ugandan phone number");
}
// West African (XOF): Senegal (+221), Ivory Coast (+225), Benin (+229)
if (!/^\+(221\d{9}|225\d{10}|229\d{8,9})$/.test(xofPhoneNumber)) {
throw new Error("Invalid West African phone number");
}
```

</Accordion>
Expand Down