Umhlahlandlela we-Customer USSD

I-customer USSD inika bo-customer be-Emali 2.0 indlela lekhanyako, le-sebenta nange-low-data kutsi bafinyelele emisebentini ye-wallet nganoma nguyiphi ifoni. I-customer USSD isebenta ku-*123#, icala ngekukhetsa lulwimi, igcina lokuncanyelwako kulowo customer, futsi icela i-PIN ngaphambi kwemisebenti lebucayi.

Tip: Sebentisa i-USSD nangabe customer anefoni lelula, anesimo se-data lesibutsakatsaka, noma adzinga flow lesheshako le-assistwe esitolo noma ku-call center.

Ngamafuphi

Intfo	Inani
I-dial code	`*123#`
I-audience	Bo-customer
Timalulwimi	English ne-siSwati
Kwatisa session	MSISDN levela ku-telco session
Kucinisekisa imisebenti lebucayi	Customer transaction PIN
Session timeout	Imizuzu le-5 yekungasebenti
Test gateway	`https://api.test.emali2.damplabs.com/api/v1/ussd/sessions`
Local gateway	`http://localhost:8805/ussd_gateway/api/v1/ussd/sessions`

Imenyu ye-customer

Inketho	Umsebenti	Lokwentwa yi-customer
1	Bona Imali	Buka i-wallet balance ngemuva kwe-PIN verification
2	Thumela Imali	Faka recipient, amount, PIN, bese uyaqinisekisa
3	Khokha Timbilisi	Khetsa i-paybill yakamuva/ledvumile lapho ikhona, noma uyifake ngesandla
4	Thenga I-airtime	Tsenga i-airtime yakho ngemuva kwe-PIN confirmation
5	Statement Lencane	Buka transactions letingu-5 letakamuva
6	I-akhawunti Yami	Shintja i-PIN, shintja lulwimi, buka account info, limits, notifications
7	Khipha Imali	Faka i-agent till, faka amount, faka PIN, qinisekisa, futsi utfole withdrawal code
8	Ticelo & Sekelo	Buka approvals letisalindzile kanye nemisebenti yesekelo

Indlela isession lechubeka ngayo

Customer ushaya *123#.
Sikhrini sekucala sicela lulwimi: 1. English noma 2. siSwati.
Lolulwimi luyagcinwa futsi lusetjentiswa kuyo yonkhe isession.
Customer ufaka i-PIN ngaphambi kwemibono lebucayi njenge-balance, mini statement, kanye nema-approval.
Imisebenti yentengiselwano njenge-send money, pay bills, airtime, ne-cash out icela transaction PIN ngaphambi kwe-confirmation.

Tibonelo temenyu lephila live

English

Language / Lulwimi

1. English
2. siSwati

Current / Manje: English

Select option / Khetsa:

EMALI MOBILE MONEY
1. Check Balance
2. Send Money
3. Pay Bills
4. Buy Airtime
5. Mini Statement
6. My Account
7. Cash Out
8. Requests & Support

siSwati

Language / Lulwimi

1. English
2. siSwati

Current / Manje: siSwati

Select option / Khetsa:

EMALI MOBILE MONEY
1. Bona Imali
2. Thumela Imali
3. Khokha Timbilisi
4. Thenga I-airtime
5. Statement Lencane
6. I-akhawunti Yami
7. Khipha Imali
8. Ticelo & Sekelo

I-request format yesimulator

I-telco simulator kanye ne-Postman collection kutfumela JSON ku-/api/v1/ussd/sessions.

{
  "sessionId": "cust-balance-001",
  "msisdn": "+26870000001",
  "text": "",
  "serviceCode": "*123#",
  "networkCode": "ALL",
  "newSession": true
}

I-response body ibhalwe njenge-plain text. Sebentisa sessionId leyodvwa uma isession isasebenta.

Uma i-gateway environment yakho idzinga request signing, faka X-Emali2-Ussd-Key header ku-request yesimulator. Kuma-public test kanye nema-local flow ingahle ingadzingeki.

Tibonelo te-flow

1. Cala isession bese ukhetsa siSwati

BASE_URL="https://api.test.emali2.damplabs.com/api/v1/ussd/sessions"
SESSION_ID="cust-ss-001"

curl -sS "$BASE_URL" \
  -H 'Content-Type: application/json' \
  -d '{
    "sessionId":"'"$SESSION_ID"'",
    "msisdn":"+26870000001",
    "text":"",
    "serviceCode":"*123#",
    "networkCode":"ALL",
    "newSession":true
  }'

curl -sS "$BASE_URL" \
  -H 'Content-Type: application/json' \
  -d '{
    "sessionId":"'"$SESSION_ID"'",
    "msisdn":"+26870000001",
    "text":"2",
    "serviceCode":"*123#",
    "networkCode":"ALL",
    "newSession":false
  }'

2. Bona imali

I-balance flow ilandzela lulwimi lolukhetsiwe futsi ivikelwe yi-PIN.

BASE_URL="https://api.test.emali2.damplabs.com/api/v1/ussd/sessions"
SESSION_ID="cust-balance-001"

curl -sS "$BASE_URL" -H 'Content-Type: application/json' -d '{
  "sessionId":"'"$SESSION_ID"'","msisdn":"+26870000001","text":"",
  "serviceCode":"*123#","networkCode":"ALL","newSession":true
}'
curl -sS "$BASE_URL" -H 'Content-Type: application/json' -d '{
  "sessionId":"'"$SESSION_ID"'","msisdn":"+26870000001","text":"1",
  "serviceCode":"*123#","networkCode":"ALL","newSession":false
}'
curl -sS "$BASE_URL" -H 'Content-Type: application/json' -d '{
  "sessionId":"'"$SESSION_ID"'","msisdn":"+26870000001","text":"1",
  "serviceCode":"*123#","networkCode":"ALL","newSession":false
}'
curl -sS "$BASE_URL" -H 'Content-Type: application/json' -d '{
  "sessionId":"'"$SESSION_ID"'","msisdn":"+26870000001","text":"123456",
  "serviceCode":"*123#","networkCode":"ALL","newSession":false
}'

3. Thumela imali

Shaya *123# -> khetsa lulwimi -> 2. Thumela Imali
-> faka recipient MSISDN -> faka amount -> faka PIN -> qinisekisa

Sebentisa le flow kutfumelela lomunye customer imali. I-recipient MSISDN kufanele ivumeleke ngaphansi kwemitsetfo ye-network yema-customer.

4. Khokha timbilisi

Imenyu ye-pay bills ihlelwe kutsi ibe mfisha:

Nangabe customer anema-biller lakamuva nobe lavame kuwasebentisa, lawo aboniswa kucala.
Nangabe kungakabi khona umlando, imenyu iwele ku-manual entry.
Manual entry ihlala iyindlela lephephile uma i-catalog yema-biller yandze kakhulu.

Manual flow:

Shaya *123# -> khetsa lulwimi -> 3. Khokha Timbilisi
-> khetsa "Enter paybill manually"
-> faka paybill number
-> faka account number
-> faka amount
-> faka PIN
-> qinisekisa

Tibonelo letisebentako:

100100 nge-EEC kanye ne-reference 04012345678
200200 nge-SWSC kanye ne-reference WTR-2024-00156

5. Thenga i-airtime

Shaya *123# -> khetsa lulwimi -> 4. Thenga I-airtime
-> khetsa network -> khetsa self noma other
-> khetsa amount -> faka PIN -> qinisekisa

6. Statement lencane

I-mini statement ibuyisa transactions letingu-5 letakamuva, sibonelo:

Mini Statement
Balance: E12326.10

1. Debit -E5 11/03 20:48
2. Debit -E20 11/03 20:48
3. Debit -E20 11/03 20:48
4. Debit -E13 11/03 20:46
5. Debit -E5 11/03 20:46

Le flow nayo ivikelwe yi-PIN ngobe iveza umnyakato we-account.

7. Khipha imali

I-customer cash out isebentisa manual till entry, ngako imenyu ayidzingi kubuyisa wonkhe ema-agent labhalisiwe.

Shaya *123# -> khetsa lulwimi -> 7. Khipha Imali
-> faka agent till
-> faka amount
-> faka PIN
-> qinisekisa
-> tfola withdrawal code

8. Ticelo nesekelo

Sebentisa Ticelo & Sekelo uma customer adzinga kugunyata collection letisalindzile noma letinye ticelo letiphushwa yi-backend. Luhlu lwema-approval luvikelwe yi-PIN futsi customer angavuma noma enqabe ngco ku-USSD.

Imodeli yekuvikeleka

Kubalulekile: I-telco session iyamkhomba customer nge-MSISDN, kodvwa imininingwane lebucayi kanye nemnyakato wemali kusadzingeka i-PIN levumelekile.

Kukhetsa lulwimi kungenteka ngaphambi kwekufaka i-PIN.
I-balance, mini statement, kanye nema-request approvals kudzinga PIN gate.
I-send money, pay bills, airtime, kanye ne-cash out kucela transaction PIN ngaphambi kwe-confirmation yekugcina.
Lulwimi lungashintjwa kamuva ku-I-akhawunti Yami -> Change Language.

Tinkinga letivamile nekuyilungisa

Luphawu	Kuvamise kusho ini	Yini lokufanele yenziwe yi-customer
`Invalid option`	Lokukhetsiwe akukho kusikrini lesikhona	Faka kabusha inombolo levetwe kusikrini
`Incorrect PIN`	I-customer PIN yiphutsa	Phindza ucophelela; nangabe kuphindzaphindzeka, reset nge-support noma nge-My Account
`Agent not found with identifier`	Till number lephutsile ngesikhathi se-cash out	Cinisekisa kabusha till number levetwe yi-agent
`Amount must be between E50 and E3000`	I-cash-out amount ingaphandle kwelimit	Faka inani lelingaphakathi kwalowo mkhawulo
Session restarted	Session iphelelwe sikhatsi ngenca yekuma	Shaya futsi bese ucalisa kabusha i-flow

Tinsita tekutestha

Postman collection: Emali2_USSD_Gateway_Collection.json
Local environment: Emali2_USSD_Local.postman_environment.json
Remote environment: Emali2_USSD_Remote.postman_environment.json

Ngemisebenti yema-agent, chubeka uye ku-Agent USSD Guide.