ussd-africastalking-example

A sample project created with laravel-ussd and africa's talking

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.

Prerequisites

• Composer
• >= PHP 7.2

Installing

Please run the following commands to setup your development env up.

# clone this repository
git clone https://github.com/yawmanford/ussd-africastalking-example.git

# change directory
cd ussd-africastalking-example/

# install the project's dependencies using Composer
composer install

# make a copy of the .env.example to configure the application for your local environment
# linux/unix
cp .env.example .env

# windows
copy .env.example .env

# generate your application encryption key using 
php artisan key:generate

Running the application

You can use the development server the ships with Laravel by running, from the project root:

php artisan serve

You can visit http://localhost:8000 to see the application in action.

Testing the application

Browser

http://localhost:8000/?phoneNumber=233544909356&serviceCode=mtn&sessionId=12345&text=1

cURL

curl -H "Content-Type: application/json" \
     -X GET \
     -d '{"phoneNumber":"233544909356", "serviceCode":"mtn", "sessionId":"12345", "text":"1"}' \
     http://localhost:8000

Africa's Talking Simulator

https://simulator.africastalking.com:1517

Enjoy!!!

Reseting the application

Run the following artisan command if you are using the default cache store

php artisan cache:clear

Documentation

You'll find the documentation on https://sparors.github.io/ussd-docs.