Skip to main content
PUT
/
gcc
/
v2
/
partner
/
merchant
/
onboard
/
{onboardingId}
/
business-details
Update Business Details
curl --request PUT \
  --url https://api.onboard.payglocal.in/gcc/v2/partner/merchant/onboard/{onboardingId}/business-details \
  --header 'Content-Type: application/json' \
  --header 'x-gl-auth: <api-key>' \
  --header 'x-gl-digest: <api-key>' \
  --data '
{
  "entityType": "PVT_LTD_COMPANY",
  "gstNumber": "27AAPFU0939F1ZV",
  "natureOfBusiness": "BUS.IT_SERVICES",
  "tradeName": "Acme Payments",
  "websiteUrl": "https://acmepayments.com",
  "purposeCode": "P0802",
  "expectedMonthlyVolume": {
    "amount": "50000",
    "currency": "USD"
  },
  "address": {
    "isOperatingSameAsRegistered": true,
    "businessRegisteredAddress": {
      "streetAddress1": "501 Commerce Street",
      "streetAddress2": "Floor 3",
      "zipcode": "400051",
      "stateCode": "MH",
      "city": "Mumbai",
      "state": "Maharashtra"
    }
  }
}
'
{
  "gid": "gl_9c2645ed09edb22e",
  "timestamp": "10/01/2026 15:00:00",
  "reasonCode": "",
  "data": {
    "merchantInfo": {
      "onboardingId": "pg_onboard_abc123",
      "partnerOnboardingId": "partner-merchant-001",
      "businessDetails": {
        "entityType": "<string>",
        "gstNumber": "<string>",
        "natureOfBusiness": "<string>",
        "registeredName": "<string>",
        "tradeName": "<string>",
        "iec": "<string>",
        "businessMonthlySize": "<string>",
        "websiteUrl": "<string>",
        "purposeCode": "<string>",
        "businessRegisteredAddress": {
          "streetAddress1": "<string>",
          "streetAddress2": "<string>",
          "zipcode": "<string>",
          "stateCode": "MH",
          "city": "<string>",
          "state": "Maharashtra"
        },
        "businessOperatingAddress": {
          "streetAddress1": "<string>",
          "streetAddress2": "<string>",
          "zipcode": "<string>",
          "stateCode": "MH",
          "city": "<string>",
          "state": "Maharashtra"
        }
      },
      "directorDetails": [
        {
          "designation": "<string>",
          "name": "<string>",
          "pan": "<string>"
        }
      ],
      "beneficialOwnerDetails": [
        {
          "designation": "<string>",
          "name": "<string>",
          "pan": "<string>",
          "percentageOwnership": 123
        }
      ],
      "authorisedSignatoryDetails": {
        "authSignatoryName": "<string>",
        "authSignatoryPan": "<string>",
        "contact": {
          "phone": "<string>",
          "email": "<string>"
        }
      },
      "settlementDetails": {
        "bankAccountNumber": "<string>",
        "bankIfscCode": "<string>",
        "accountHolderName": "<string>"
      }
    },
    "merchantOnboardingCheckListStatus": {
      "documentsToBeUploaded": [
        "<string>"
      ]
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.payglocal.in/llms.txt

Use this file to discover all available pages before exploring further.

​
When to Use

Submits or updates business information for a merchant onboarding record. Must be called after Create Onboarding.
Business details cannot be updated after the merchant has acknowledged the Terms & Conditions. Ensure all information is accurate before triggering Get Verification Redirect.

​
Notes

  • address.businessOperatingAddress is required only when address.isOperatingSameAsRegistered is false. When addresses differ, OPERATING_ADDRESS_PROOF is added to documentsToBeUploaded.
  • natureOfBusiness must be a subcategory code from Get Business Categories. State codes follow the 2-letter format — see State Codes.
  • For Partnership Firm entities, set noPartnershipRegistrationCheck: true when the partnership is not registered. This exempts PARTNERSHIP_REGISTRATION_CERTIFICATE from required documents.

​
Error Scenarios

ScenarioHTTP Code
Required fields missing or empty400
Invalid field format400
Update attempted after T&C is acknowledged400
onboardingId does not exist404
onboardingId does not belong to this partner403

Authorizations

​
x-gl-auth
string
header
required

Static API Key generated from the PayGlocal Partner Dashboard.

​
x-gl-digest
string
header
required

Per-request HmacSHA256 signature, Base64-encoded, using your API Secret as the HMAC key.

  • For GET requests: sign the request URI path (e.g. /gcc/v2/partner/merchant/onboard/business-category), including query string if present.
  • For POST/PUT requests: sign the exact raw request body.

Path Parameters

​
onboardingId
string
required

PayGlocal-generated onboarding ID returned by Create Onboarding.

Body

application/json
​
entityType
enum<string>
required

Legal constitution of the business.

Available options:
INDIVIDUAL,
PVT_LTD_COMPANY,
PUBLIC_LTD_COMPANY,
PROPRIETOR,
PARTNERSHIP_FIRM,
LLP_FIRM
Example:

"PVT_LTD_COMPANY"

​
natureOfBusiness
string
required

Subcategory code from the Get Business Categories API.

Example:

"BUS.IT_SERVICES"

​
websiteUrl
string
required

Merchant website or app store URL.

Example:

"https://acmepayments.com"

​
purposeCode
string
required

Primary purpose code for merchant transactions.

Example:

"P0802"

​
expectedMonthlyVolume
object
required
​
address
object
required
​
gstNumber
string

GST registration number.

Example:

"27AAPFU0939F1ZV"

​
tradeName
string

Trade name or brand name.

Example:

"Acme Payments"

​
iec
string

Importer Exporter Code (preferred for GOODS businesses).

Response

Business details updated successfully.

​
gid
string

PayGlocal global transaction ID.

Example:

"gl_9c2645ed09edb22e"

​
timestamp
string

Response timestamp (DD/MM/YYYY HH:MM:SS).

Example:

"10/01/2026 15:00:00"

​
reasonCode
string

Empty string on success.

Example:

""

​
data
object