Add Business

Instantpay's Add Business API helps businesses manage their growing network of entities. This API lets you easily add new clients and partners to your database. It keeps your information accurate and up to date.

The Add Business API helps businesses with dynamic relationships. It offers the flexibility to adapt to new opportunities and expand your network. Integrating this API will streamline your business processes. It will also keep a record of your connections, which will help your growth and success.

Request Parameters

NameTypeRequirementDescription
gcIdStringMandatoryContact Id(You will get from Add Contact Response))
panStringOptionalPAN Number
cinStringOptionalcin Number
gstinStringOptionalGST Number
tanStringOptionalTAN Number
udyamStringOptionalUdhyam Number

Sample Request

curl --location 'https://api.instantpay.in/contacts/business' \
--header 'X-Ipay-Auth-Code: {{authCode}}' \
--header 'X-Ipay-Client-Id: {{clientId}}' \
--header 'X-Ipay-Client-Secret: {{clientSecret}}' \
--header 'X-Ipay-Endpoint-Ip: {{endPointIP}}' \
--header 'Content-Type: application/json' \
--data '{
    
    "gcId" : "645b283b9b2e242ec80dd5c2",
    "pan" : "AAOCS6028B",
    "gstin" : "",
    "cin" : "",
    "tan" : "",
    "udhyam" : ""

}'
POST /contacts/business HTTP/1.1
Host: api.instantpay.in
X-Ipay-Auth-Code: {{authCode}}
X-Ipay-Client-Id: {{clientId}}
X-Ipay-Client-Secret: {{clientSecret}}
X-Ipay-Endpoint-Ip: {{endPointIP}}
Content-Type: application/json
Content-Length: 144

{
    
    "gcId" : "645b283b9b2e242ec80dd5c2",
    "pan" : "AAOCS6028B",
    "gstin" : "",
    "cin" : "",
    "tan" : "",
    "udhyam" : ""

}

Response Parameter

Parameter NameTypeDescription
statuscodeStringInstantpay status code
actcodeStringAction code
statusStringStatus message
dataArrayResponse data(if Present)
timestampStringResponse time (YYYY-MM-DD HH:II:SS)
ipay_uuidStringRequest reference number
orderidStringTransaction Id ( If transaction otherwise it is null )
environmentStringLive/Sandbox
internalCodeStringit will be null
{
    "statuscode": "TXN",
    "actcode": null,
    "status": "Business DetailsAdded Successfully",
    "data": {
        "gcId": "645b283b9b2e242ec80dd5c2",
        "pan": "AAOCS6028B",
        "panVerified": false,
        "updated_at": "2023-05-10T07:17:40.015000Z",
        "created_at": "2023-05-10T07:17:40.015000Z",
        "_id": "645b4514f5f25662ef00f892"
    },
    "timestamp": "2023-05-10 12:47:40",
    "ipay_uuid": "h0069921c446-b52c-4d77-895d-7e244b22fed8",
    "orderid": null,
    "environment": "LIVE",
    "internalCode": null
}
Language
Click Try It! to start a request and see the response here!