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

circleId  (String)   Required
Circle Id (You will get circleId from the Get Circle API) (Max Length: 5)

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

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

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

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

Request

Example Request

    curl --location '/v1/service/recharge/initiate' \
        --header 'Content-Type: application/json' \
        --header 'Authorization: Basic Og==' \
        --data '{
            "circleId" : "20",
            "operatorId" : "5",
            "phone" : "9651XXXX86",
            "amount" : "10",
            "clientRefId" : "RECH_798099XXXX093009"
        }'

Response Samples

SUCCESS

    {
        "code": "0x0200",
        "message": "Recharge successfully.",
        "status": "SUCCESS",
        "data": {
            "amount": "10",
            "txnId": "W2312301XXXX1BRBN",
            "venderId": "UEH2312301XXXX80037",
            "customerNumber": null,
            "remarks": "Transaction Successful",
            "merchantCode": null
        }
    }

FAILED

    {
        "code": "0x0202",
        "status": "FAILURE",
        "message": "Transaction Failed, Transaction failed., Internal Error",
        "data": {
            "clientRefId": null,
            "amount": "10",
            "txnId": "W23123017XXXXUTZZ",
            "venderId": "BR00XXXX0PKO",
            "customerNumber": null,
            "remarks": "Transaction Failed, Transaction failed., Internal Error",
            "merchantCode": null
        }
    }

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