Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Earnipay Business API

Business profile management and FIRS configuration

Earnipay Business API is one of 13 APIs that Earnipay publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Business. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 16 operations across 13 paths, and defines 9 schemas. It is described by OpenAPI 3.0.0, at version 1.0.

Requests are made against the base URL https://e-invoicing.earnipay.com/v1.

16 operations 13 paths 9 schemas 1 DELETE3 GET7 PATCH5 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
1.0
Base URL
https://e-invoicing.earnipay.com/v1
Authentication
HTTP Bearer, API Key
Resource Areas
1

Authentication & Security 2

Earnipay Business API declares 2 security schemes for authenticating requests. It accepts HTTP bearer tokens (JWT) (JWT-auth). An API key is passed in the header as X-API-Key (API-Key).

  • JWT-auth — Enter JWT token
  • API-Key — API Key for third-party integrations

Paths & Operations 16

Across 13 paths, the API surfaces 16 operations — 1 DELETE, 3 GET, 7 PATCH, 5 POST. Each is listed below with its method, path, parameters, and response codes.

Business 16

Business profile management and FIRS configuration

POST
/v1/businesses/upload
Upload a file
BusinessController_uploadFile_v1 body → 200400401
POST
/v1/businesses
Create new business
BusinessController_createBusiness_v1 body → 201400401409
GET
/v1/businesses
Get user's businesses
BusinessController_getUserBusinesses_v1 → 200401
GET
/v1/businesses/{id}
Get business details
BusinessController_getBusinessById_v1 1 param → 200401403404
PATCH
/v1/businesses/{id}
Update business
BusinessController_updateBusiness_v1 1 param body → 200400401403404
DELETE
/v1/businesses/{id}
Delete business
BusinessController_deleteBusiness_v1 1 param → 200401403404
PATCH
/v1/businesses/{id}/settings
Update business settings
BusinessController_updateBusinessSettings_v1 1 param body → 200403404
PATCH
/v1/businesses/{id}/firs-config
Update FIRS configuration
BusinessController_updateFirsConfig_v1 1 param body → 200400401403404
PATCH
/v1/businesses/{id}/crypto-keys
Upload crypto keys file
BusinessController_uploadCryptoKeys_v1 1 param body → 200400401403404
PATCH
/v1/businesses/{id}/app-config
Update APP configuration
BusinessController_updateAppConfig_v1 1 param body → 200400401403404
POST
/v1/businesses/{id}/test-app-connection
Test APP connection
BusinessController_testAppConnection_v1 1 param body → 200401403404
POST
/v1/businesses/{id}/set-default
Set business as default
BusinessController_setDefaultBusiness_v1 1 param → 200401403404
PATCH
/v1/businesses/{id}/app-provider
Update APP provider
BusinessController_updateAppProvider_v1 1 param body → 200400401403404
PATCH
/v1/businesses/{id}/interswitch-credentials
Update Interswitch credentials
BusinessController_updateInterswitchCredentials_v1 1 param body → 200400401403404
POST
/v1/businesses/{id}/test-interswitch-connection
Test Interswitch connection
BusinessController_testInterswitchConnection_v1 1 param body → 200401403
GET
/v1/businesses/providers/supported
Get supported APP providers
BusinessController_getSupportedProviders_v1 → 200401

Schemas 9

The contract defines 9 schemas that model the data the API accepts and returns. The most detailed are CreateBusinessDto (11 properties), UpdateBusinessDto (9 properties), TestInterswitchConnectionDto (2 properties), UpdateFirsConfigDto (2 properties). Each schema is shown below with its type and property counts.

CreateBusinessDto
object
11 properties 6 required
UpdateInterswitchCredentialsDto
object
2 properties 2 required
TestAppConnectionDto
object
2 properties 2 required
UpdateAppProviderDto
object
UpdateBusinessDto
object
9 properties
UpdateFirsConfigDto
object
2 properties 2 required
TestInterswitchConnectionDto
object
2 properties 2 required
UpdateAppConfigDto
object
2 properties 2 required
UpdateBusinessSettingsDto
object
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

earnipay-business-api-openapi.yml Raw ↑

Other APIs Earnipay publishes across the network.

Earnipay App API
Earnipay APP Provider API
Earnipay Authentication API
Earnipay Bank API
Earnipay Customers API
Earnipay Invoices API
Earnipay IRN Generator API
Earnipay Payment Details API
Earnipay Products API
Earnipay QR Code Generator API
Earnipay Team API
Earnipay Users API