Status Code and Descriptions

 

Process flow for dispute resolution is outlined below

1. Initiate a transaction by calling the appropriate end point. An OrderID is generated which is returned as part of the JSON response.

2. Retrieve the OrderID and pass it as a parameter to our Query API to get the status of the order.

3. If the order fails, then pass the OrderID retrieved in stage two(2) above to our CANCEL API  to cancel the transaction.

  Description of the STATUS CODE from JSON response

STATUS CODE

STATUS

REMARK

Description

100

ORDER_RECEIVED

Awaiting Processing

Order has been received and is awaiting processing

199 ORDER_RECEIVED Unspecified Error  

300

ORDER_PROCESSED

Awaiting Network Response

Transaction was sent and is awaiting response from mobile network operator

399 ORDER_PROCESSED Unspecified Error  

200

ORDER_COMPLETED

Success

Transaction was sent and response received from mobile network operator that the transaction was successful

201

ORDER_COMPLETED

Network Unresponsive

Transaction was sent but no response was received from mobile network operator after 60seconds. All transaction that returns network unresponsive will be retried every 5min for a maximum of 1hour before it is cancelled.

N.B. network issues with the provider and can sometimes be resolved when tried later

299 ORDER_COMPLETED Unspecified Error  

400

ORDER_ERROR

INVALID_CREDENTIALS

The UserID and API key combination is not correct.

401

ORDER_ERROR

MISSING_CREDENTIALS

The URL format is not valid.

402

ORDER_ERROR

MISSING_USERID

Username field is empty

403

ORDER_ERROR

MISSING_APIKEY

API Key field is empty

404

ORDER_ERROR

MISSING_MOBILENETWORK

Mobile network is empty

405

ORDER_ERROR

MISSING_AMOUNT

Amount is empty

406

ORDER_ERROR

INVALID_ AMOUNT

Amount is not valid

407

ORDER_ERROR

MINIMUM_100

Minimum amount is 100

408

ORDER_ERROR

MINIMUM_50000

Minimum amount is 50,000

409

ORDER_ERROR

INVALID_RECIPIENT

An invalid mobile phone number was entered

410

ORDER_ERROR

INVALID_API_ERROR1

API error

411

ORDER_ERROR

INVALID_API_ERROR2

API error

412

ORDER_ERROR INSUFFICIENT_APIAMOUNT

Transaction was sent and response received from mobile network operator that the transaction was unsuccessful but was placed on hold by our system. All transaction that is placed on hold will be retried every 5min for a maximum of 1hour, before it is cancelled.

N.B. Transactions are usually placed on hold due to network issues with the provider and can sometimes be resolved when tried later

413 ORDER_ERROR INVALID_API
414 ORDER_ERROR INVALID_PAYMENT_OPTION
415 ORDER_ERROR INSUFFICIENT_APISTOREDEALERAMOUNT
416 ORDER_ERROR INSUFFICIENT_APISTOREAMOUNT
417 ORDER_ERROR INSUFFICIENT_BALANCE
418 ORDER_ERROR INVALID_MOBILENETWORK
499 ORDER_ERROR Unspecified Error

600

ORDER_ONHOLD

Network Error

601

ORDER_ONHOLD

Your request cannot be processed at this time

602

ORDER_ONHOLD

Your account has been credited back for failed Txn

603

ORDER_ONHOLD

the process failed

604

ORDER_ONHOLD

Transaction Failure

605

ORDER_ONHOLD

Failed recharge

606

ORDER_ONHOLD

By APIUser

699 ORDER_ONHOLD Unspecified Error

Transaction was sent and response received from mobile network operator that the transaction was unsuccessful and as such was cancelled by our system

500 ORDER_CANCELLED By APIUser
501 ORDER_CANCELLED By Server
506 ORDER_CANCELLED Server Busy

507

ORDER_CANCELLED

Network Error

508

ORDER_CANCELLED

Your request cannot be processed at this time

509

ORDER_CANCELLED

Your account has been credited back for failed Txn

510

ORDER_CANCELLED

the process failed

511

ORDER_CANCELLED

Transaction Failure

512

ORDER_CANCELLED

request is not valid

513

ORDER_CANCELLED

Failed recharge

514

ORDER_CANCELLED

Transaction rejected

515

ORDER_CANCELLED

The receivers account is in the wrong state

516

ORDER_CANCELLED

is not a valid MTN Subscriber

517

ORDER_CANCELLED

is not eligible for this offer

518

ORDER_CANCELLED

the subscriber you are trying to Buy data for is not eligible

519

ORDER_CANCELLED

You already have a Data Plan yet to be activated

520 ORDER_CANCELLED you are not gifting to a valid Globacom user
521 ORDER_CANCELLED Order already completed, cancelled or refunded
599 ORDER_CANCELLED Unspecified Error