Initiate Recharge

Initiate Recharge

Postman Collection

Recharge

URL

POST : /v1/service/recharge/initiate

Headers

Content-Type  (String)   required
application/json

Authorization  (String)   required
Basic Auth

Accept  (String)   required
application/json

Body Params

merchantCode  (String)   Optional
Unique Merchant Code (client end) (Max Length: 20)

phone  (String)   Required
Customer Phone Number Or Customer Id (for DTH) (Max Length: 10)

amount  (String)   Required
Recharge Amount (Max Length: 5)

operatorId  (String)   Required
operator Id (You will get operatorId from Get Operator API ) (Max Length: 3)

clientRefId  (Number)   Required
Unique Reference number (Max Length: 30)

Request

Example Request

    curl --location --request POST '/v1/service/recharge/initiate' \
    --header 'Content-Type: application/json' \
    --header 'Authorization: Basic e3tsb2NfdXNlcn19Ont7bG9jX3Bhc3N9fQ==' \
  --data-raw '{
    "merchantCode": "MC1234567",
    "phone": "9999999999",
    "amount": "10",
    "operatorId": "1",
    "clientRefId": "REC23006068B65630"
}'

Response Samples

SUCCESS

{
    "code": "0x0200",
    "message": "Recharge successfully.",
    "status": "SUCCESS",
    "data":{
        "clientRefId": "REC23006068B65630",
        "amount": "10",
        "txnId": "XTRECEF4E47D30A3F40B",
        "venderId": "1426569853",
        "customerNumber": "9999999999",
        "remarks": "Transaction Successful"
    }
}

FAILED

{
"code": "0x0202",
"status": "FAILURE",
"message": "The client ref id already exists."
}

Response Code

Response Code

Status Code	Status	Message
0x0200	SUCCESS	TRANSACTION SUCCESSFULL
0x0201	UNAUTHORIZED	UNAUTHORIZED USER
0x0202	FAILURE	FAILURE USER
0x0203	MISSING_PARAMETER	MISSING PARAMETER
0x0204	CONNECTION_TIMEOUT	CONNECTION TIMEOUT
0x0205	SOMETHING_WENT_WRONG	SOMETHING WENT WRONG
0x0206	PENDING	TRANSACTION PENDING
0x0208	2FA	TWO FACTOR AUNTHENTICATION