Skip to main content
POST
Node.js
Required scope: merchants:write Select your institution in the business headers and send businessName with an Idempotency-Key. Reuse the same key and name when retrying; a changed request returns 409. The response includes the application and business IDs. Add contact, company and ownership details through the application’s sections. You can complete the application yourself or create an onboarding link for the applicant. Creating the application does not send an email or signup invitation.

Authorizations

x-ledig-key
string
header
required

Your business API key ID. Keep its secret on your server and use that secret to sign each request.

x-ledig-timestamp
string
header
required

The current Unix timestamp in seconds, used in the signed request.

x-ledig-signature
string
header
required

The request's HMAC-SHA256 signature. Use the v1= prefix for supported own-business requests, or v2= when acting for a managed business with signed business-selection headers. Follow the authentication guide to construct and sign the exact request.

Headers

X-Ledig-Business-Id
string

The business you are acting for. For a managed business, your institution must be authorised to act for it and API-key requests must use HMAC v2. Set this header explicitly; a business ID in the body does not select the business.

Minimum string length: 1
X-Ledig-Acting-Business-Id
string

Your institution's business ID when acting for a managed business. It must match your API key's owner or an institution you belong to. HMAC v2 signs the trimmed value, or an empty string when omitted.

Minimum string length: 1
Idempotency-Key
string
required

A unique key for this application request. Reuse it for retries; changing the request with the same key returns 409.

Required string length: 1 - 128

Body

application/json
businessName
string
required
Required string length: 1 - 255

Response

Application and managed business created or resumed. Includes requestId, applicationId and businessId; no credentials.

status
string
required
Allowed value: "success"
data
object
required
message
string