Onboard Merchant

Onboard Merchant

Postman Collection

AEPS

URL

POST : /v1/service/aeps/merchantOnBoard

Headers

Content-Type  (String)   required
application/json

Authorization  (String)   required
Basic Auth

Accept  (String)   required
application/json

Body Params

aadhaarNo  (String)   Required
Aadhaar number of the Merchant (Max Length: 12)

mobile  (String)   Required
Mobile Number of the Merchant (Max Length: 10)

firstName  (String)   Required
First Name of the Merchant (Max Length: 30)

email  (String)   Required
Email of the Merchant (Max Length: 50)

address  (String)   Required
Address of the Merchant (Max Length: 150)

district  (Number)   Required
District Id (Max Length: 5)

state  (Number)   Required
State Id (Max Length: 5)

city  (Number)   Required
City Id (Max Length: 5)

pinCode  (String)   Required
Pin Code of the Merchant (Max Length: 6)

pan  (String)   Required
Pan number of the Merchant (Max Length: 10)

latitude  (String)   Required
Current location latitude (Max Length: 20)

longitude  (String)   Required
Current location latitude (Max Length: 20)

Request

Example Request

    curl --location '/v1/service/aeps/merchantOnBoard' \
        --header 'Content-Type: application/json' \
        --header 'Authorization: Basic Og==' \
        --data-raw '{
            "aadhaarNo" : "55000XXXXX42",
            "mobile" : "96XXXXX986",
            "firstName" : "Anil",
            "email" : "kumaXXXXXi@gmail.com",
            "address" : "Faizabad",
            "district" : "633",
            "state" : "34",
            "city" : "Faizabad",
            "pinCode" : "2XXX04",
            "pan" : "ENGPXXXXXA",
            "latitude" : "26.600000",
            "longitude" : "82.133904"
        }'

Response Samples

SUCCESS

    {
        "code": "0x0200",
        "message": "000: Merchant onboard successfully.",
        "status": "SUCCESS",
        "data": {
            "merchantCode": "MC00XXXXX23",
            "firstName": "abc",
            "middleName": "",
            "lastName": "xyz",
            "mobile": "9999XXXXX9",
            "email": "example@example.com",
            "pinCode": "224204",
            "dob": "1996-03-13",
            "aadhaarNo": "930XXXXX0095",
            "panNo": "ASXXXXX34H",
            "status": "A",
            "remarks": "",
            "service": "ICICI",
            "cd": "True",
            "be": "True",
            "cw": "True",
            "ms": "True",
            "eKycStatus": "False",
            "state": "Uttar Pradesh",
            "district": "Lucknow",
            "shopName": "XYZ CSC Point",
            "shopAddress": "Adarsh Nagar, Lucknow",
            "shopPin": "22XX04"
        }
    }

FAILED

    {
        "code": "0x0202",
        "status": "FAILURE",
        "message": "Merchant Onboard Failed"
    }

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