Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
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
66 changes: 5 additions & 61 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,68 +1,12 @@
# USSD Code Challenge: SwahiliPot Developer Community
## Due: 30th July,2018 or Earlier
#### This code challenge is due on the 30th of July,2018 or earlier.
## By Johnes Mecha

## Simple Unchanging Rules
The code challenge is and will always be judged using the following criteria
- A Correct fork, branch and pull request
- Using the GitHub Pull Request Time Stamp and correct code quality & structure, the first developer whose code runs successfully on the sandbox/simulator wins
- Other developers who submit successfully MAY also get rewarded with secondary items
- Code quality and structure will be evaluated
- The order for pull requests will be followed, first come first win basis!
- Do not share any code that you cannot opensource on the Git Repository as its open source and Africa's Talking will not be liable for any breach of intellectual property (if any) once shared on the platform.
## How to access the Code
Go to the AfricaStalking Simulator and under ussd section and type

## Terms and Conditions
You can participate on as many challenges as you wish:
- Everyone can participate for secondary prizes, just ensure that you create your branch with your international format phone number. Airtime rewards will only go to countries we have AirTime APIs in.
- Africa's Talking reserves the right to announce the winners
- Africa's Talking reserves the right to reward the winners based on Africa's Talking Criterion
- Do not share any code that you cannot opensource on the Git Repository as its open source and Africa's Talking will not be liable for any breach of intellectual property (if any) once shared on the platform.
- Code Challenges are time bound - the time restriction is specified on the challenge
- Additional rules MAY be provided on the code challenge and will vary for each challenge
- You are free to use all manner of tools
- Successive interviews for projects MAY be run to satisfy participating Africa's Talking Partners
## Dial <html>\*384\*545454#</html>


## Code Challenge Bounty:
- First Prizes: KES 10,000 cash prize
- Secondary Prizes: Airtime for successful pull requests before or on 30th July, 2018

## Task
In this code challenge you will be required to make a USSD application that implements:
1. Mobile checkout with MPESA
2. Ability to send Airtime
3. SMS alert confirming airtime sent

### Task Workflow:
1. User initiates USSD code
2. User selects from the menu which should contain
1. Mobile checkout
2. Send airtime option
3. If the user selects the mobile checkout, they should be able to pay via MPESA
4. If the user selects the send airtime option, they should be able to add how much they want to send and recieve an SMS that confirms airtime has been sent.

### Additional:
1. See the online version of the code challenge [here](http://atdevoutreach.viewdocs.io/CodeChallengeSwahiliPot/CodeChallengeSwahiliPot/) to get acquainted.

2. Check out the format for submitting your code [here](http://atdevoutreach.viewdocs.io/CodeChallengeSwahiliPot/CodeChallengeSteps/)

## Resources
You can use the following resources to get you started on your way:
* [Starting on the Sandbox and Simulator](http://help.africastalking.com/website/how-to-get-started-on-the-africas-talking-sand-box)
* [Africas Talking's Python SDK documentation on GitHub](https://github.com/AfricasTalkingLtd/africastalking-python)
* [USSD Documentation](http://docs.africastalking.com/ussd)
* [Airtime Sending Documentation](http://docs.africastalking.com/airtime/sending)
* [Lizz's Article on building a USSD application](https://docs.google.com/document/d/1ouYo5tRRHPJ39PUx0vFqn97HXd4-6V3X0plcfRaqAOI/edit?usp=sharing)
* [SMS Sending Documentation](http://docs.africastalking.com/sms/sending)
* [SMS Receiving Documentation](http://docs.africastalking.com/sms/callback)
* [Other Help articles](http://help.africastalking.com/sms)
- More on [Logging in, Signing up/Registration, Verifying/Activating your account, Managing Teams and applications](http://help.africastalking.com/website)
- Videos on getting started [on the Africa's Talking Sandbox](https://www.dropbox.com/sh/qq086503d5zaq7l/AADEo-oazNF_PgYIPRjPpeCua?dl=0)


## About Africa's Talking Code Challenges
Please read the overview for all code challenges [here.](http://atdevoutreach.viewdocs.io/CodeChallengeSwahiliPot/)

## Get Support on the Africa's Talking Slack
In case you have any questions, join our Slack [here](https://slackin-africastalking.now.sh/)


Loading