Create billing account

Staging Env

https://api.stg.bidancer.com

POST

/billing-service/v1/account/create

Last modified:2026-01-13 17:42:41

Create a new billing account with the provided details.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/x-www-form-urlencoded

Responses

🟢201Created

application/json

Success response for creating or updating a

Body

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠429429

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.stg.bidancer.com/billing-service/v1/account/create' \
--header 'Authorization: Bearer <token>' \
--data-urlencode 'businessId=' \
--data-urlencode 'name=' \
--data-urlencode 'contact=' \
--data-urlencode 'email=' \
--data-urlencode 'gstin=' \
--data-urlencode 'pan=' \
--data-urlencode 'gstRegistrationStatus=' \
--data-urlencode 'currency=' \
--data-urlencode 'addressLine1=' \
--data-urlencode 'addressLine2=' \
--data-urlencode 'addressLine3=' \
--data-urlencode 'addressCity=' \
--data-urlencode 'addressState=' \
--data-urlencode 'addressCountry=' \
--data-urlencode 'addressZipcode=' \
--data-urlencode 'contactId=' \
--data-urlencode 'creatorId='

Response Example

201 - Example 1

{
    "status": "success",
    "message": "string",
    "data": {
        "id": "string",
        "businessId": "string",
        "userId": "string",
        "name": "string",
        "contact": "string",
        "email": "user@example.com",
        "gstin": "string",
        "pan": "string",
        "gstRegistrationStatus": "overseas",
        "currency": "string",
        "addressLine1": "string",
        "addressLine2": "string",
        "addressLine3": "string",
        "addressCity": "string",
        "addressState": "string",
        "addressCountry": "string",
        "addressZipcode": "string",
        "contactId": "string",
        "status": "active",
        "createdAt": "2019-08-24T14:15:22.123Z",
        "creatorId": "string",
        "updatedAt": "2019-08-24T14:15:22.123Z",
        "updaterId": "string"
    }
}

Modified at 2026-01-13 17:42:41

Delete billing account

List billing account accesses