Update Business Details

Submits or updates business information for a merchant. Cannot be updated after T&C is acknowledged by the merchant.

PUT /gcc/v2/partner/merchant/onboard/{onboardingId}/business-details

Update Business Details

cURL

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"
    }
  }
}
'

201

{
  "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>"
      ]
    }
  }
}

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

Scenario	HTTP Code
Required fields missing or empty	400
Invalid field format	400
Update attempted after T&C is acknowledged	400
onboardingId does not exist	404
onboardingId does not belong to this partner	403

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

Show child attributes

address · object · required

Show child attributes

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

201

application/json

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

Show child attributes