Table of Contents

“getstatus” API

You are here:
< All API Documentations

1. Principles

The merchant can check any transaction details via the “getstatus” API.

2. Description

o Api-name: “mobilemoney/getstatus/v1”
o Order-id: the order-id from the merchant.
o Based URL: https://api.bizao.com/
o Method: GET

  • “getstatus” API query syntax

To call the “getstatus” service, below is the syntax:
https://api.bizao.com/mobilemoney/getstatus/v1/{Order-id}

“getstatus” sample query :

curl --location --request GET
'https://api.bizao.com/mobilemoney/getstatus/v1/Merchant_Order_id_4' \
--header 'Authorization: Bearer 483a05b2-25e8-314f-8db3-dc8081547458' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'country-code: sn' \
--header 'mno-name: orange' \
--header 'channel: ' \
--header 'Cookie: SERVERID=s1
  • “getstatus” API response

Bizao <getStatus> API will response in Json format.
This Json format/response has the same format as for notification flow.

{
"meta": {
"type": "payment",
"source": "sn_orange_mm",
"channel": "web"
},
"status": "Successful",
"amount": "10",
"order-id": "Merchant_Order_id_4",
"currency": "XOF",
"reference": "Your-reference",
"date": "2020-09-29 09:34:32.0",
"state": "param1%3Dvalue1%26param2%3Dvalue2",
"country-code": "sn",
"intTransaction-id": "1601372072771",
"extTransaction-id ": "MP200929.0935.A64320"
}

3. Available Country and Operator

Below the list of country and MNO where the Mobile Money service is available for Bizao
Within this table you will find the required code for country and operator to use in the
mobilemoney query call :

4. Bizao payment API common error code

ErrorCodeException Message TextDescription / CommentsHTTP
Response
Code
50Forbidden access to the APIAccess denied by ACL.
‘Unauthorized Access Layer’ or
‘Unauthorized applicationId’ or
‘Unauthorized country’
403
Forbidden
1201Forbidden access to the APIForbidden transaction403
Forbidden
1202Forbidden access to the APIInvalid merchant key403
Forbidden
1203Forbidden access to the APIUnauthorized currency for this
country
403
Forbidden
1204Forbidden access to the APIOrder Already exists. The
order_id must be unique in the
system. Only one Token per
order_id
403
Forbidden