v1

latestOpenAPI 3.0.32026-07-26206388.3 KB

Merchant Onboarding

Add / Update Beneficial Owner

Submits or replaces the complete list of Ultimate Beneficial Owners (UBOs). The array completely replaces the existing list — always send all UBOs together. Cannot be updated after the verification step is complete.

put/gcc/v2/partner/merchant/onboard/{onboardingId}/beneficial-owner

Path parameters

onboardingIdstring required

Request body

designationstring

Job title or role of the beneficial owner.

namestring required

Full legal name of the beneficial owner.

panstring required

Personal PAN (type P) of the beneficial owner.

percentageOwnershipnumber required

Ownership percentage (range 10–100).

Example request

[
  {
    "designation": "Director",
    "name": "Ravi Kumar",
    "pan": "ABCPK1234R",
    "percentageOwnership": 60
  }
]

Response

Beneficial owner details updated successfully.

gidstring

PayGlocal global transaction ID.

timestampstring

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

reasonCodestring

Empty string on success.

Example response

{
  "gid": "gl_9c2645ed09edb22e",
  "timestamp": "10/01/2026 15:00:00",
  "data": {
    "merchantInfo": {
      "onboardingId": "pg_onboard_abc123",
      "partnerOnboardingId": "partner-merchant-001",
      "businessDetails": {
        "businessRegisteredAddress": {
          "stateCode": "MH",
          "state": "Maharashtra"
        },
        "businessOperatingAddress": {
          "stateCode": "MH",
          "state": "Maharashtra"
        }
      }
    }
  }
}

All 20 operations