---
title: Create Company
description: Register a company for creating invoices and accepting payments via the Airpay invoice pay API.
---

This API will register the company for creating invoice for accepting payments. We must pass company name, company domain, company code, company address, company email, invoice expire hours, airpay merchant id, username, password, secret key, return format, emailcc and company token in request. If the request has valid details, we will get company token, company id and message "company successfully created".

#### POST

```
https://kraken.airpay.co.in/airpay/ms/invoicepay/api/create-company
```

## Request Body

| Parameter | Type Value | Description | Value Like |
| --- | --- | --- | --- |
| companyname  required | Varchar | Need to pass the name of the company (length 1-50) | `newcompanynew` |
| companydomain  required | Varchar | Need to pass the company domain (length 1-50) | `ak` |
| companycode  required | Varchar | Need to pass the unique company code (length 1-7) | `4351` |
| companyaddress  required | Varchar | Need to pass the company address (length 1-250) | `kochi` |
| companyemail  required | Varchar | Need to pass the email of the company (length 1-50) | `newcompany@xyz.com` |
| invoiceexpirehours  optional | Numeric | Can pass the expiry hours for the invoices of the respective company (length 1-5) | `168` |
| merchantid  required | Numeric | Need to pass the airpay merchant id (length 1-11) | `1088` |
| username  required | Varchar | Need to pass the airpay username (length 1-50) | `1234567` |
| secretkey  required | Varchar | Need to pass the airpay secret key (length 1-100) | `91f5evhk72f56432ec678sdfes685h42sd2t21k430912508233b7r37562g2hps` |
| password  required | Varchar | Need to pass the airpay password (length 1-50) | `PaSSA7ab` |
| returnformat  optional | Varchar | Can pass the format for response (length 1-20)<br>json or xml or urlencoded | `json` |
| emailcc  optional | Varchar | Can pass the multiple emails to keep in cc of notifications sent to customer (length 1-255) | `xyz@gmail.com` |
| charges  optional | Varchar | Can pass the charges on the modes on the different modes of transaction (length 1-255)<br>"pgdc":"1.10" (debitcard surcharge amount)<br>"pgcc":"1.15"(creditcard surcharge amount)<br>"nb":"1.50"(netbank surcharge amount) | `pgdc:1.10` |
| returncompanytoken  optional | Numeric | Can pass to get company secret token in response (length 1)<br>Eg. 1 for yes | `1` |

## Success 200

| Parameter | Type Value | Description | Value Like |
| --- | --- | --- | --- |
| success  required | Numeric | Success code<br>Success - 200 (The transaction is success)<br>Transaction in Process - 211 (The transaction is processing)<br>Failed - 400 (The transaction is failed)<br>Dropped - 401 (The transaction will not register properly)<br>Cancel - 402 (payment that has not yet been processed)<br>Incomplete - 403 (Not recieved any call back from bank)<br>Bounced - 405 (The transaction has bounced)<br>No Records - 503 (There are no records found) | `200` |
| message  required | Varchar | Success message with data. |

## Request Example

```
{
     "companyname": "newcompanynew",
     "companydomain": "ak",
     "companycode": "4351",
     "companyaddress": "kochi",
     "companyemail": "newcompany@xyz.com",
     "invoiceexpirehours": "168",
     "merchantid": "1088",
     "username": "1234567",
     "secretkey":" 91f5evhk72f56432ec678sdfes685h42sd2t21k430912508233b7r37562g2hps",
     "password":" PaSSA7ab",
     "returnformat": "json",
     "emailcc": "xyz@gmail.com",
     "charges": {
                     "pgdc": "1.10",
                     "pgcc": "1.15",
                     "nb": "1.50"
                 }
}
```

### Success Response

```
HTTP/1.1 200 OK
{
    "success": "200",
    "message": {
                 "data": {
                             "companytoken": "91f5evhk72f56432ec678sdfes685h42sd2t21k430912508233b7r37562g2hps",
                             "COMPANY_ID": "124",
                             "comCreation": "company successfully created"
                         }
                 }
}
```

### Error Response

```
HTTP/1.1 502 Not Found
 {
     "status": 502,
     "message": []
 }
```