Skip to main content
PUT
/
gcc
/
v2
/
partner
/
merchant
/
onboard
/
{onboardingId}
/
products
Configure Products and Fees
curl --request PUT \
  --url https://api.onboard.payglocal.in/gcc/v2/partner/merchant/onboard/{onboardingId}/products \
  --header 'Content-Type: application/json' \
  --header 'x-gl-auth: <api-key>' \
  --header 'x-gl-digest: <api-key>' \
  --data '
{
  "products": [
    "GLOBAL_FUND_TRANSFER",
    "INTERNATIONAL_CARDS_AND_ALT_PAYS",
    "DOMESTIC_CARDS_UPI_AND_INB"
  ],
  "productFees": {
    "GLOBAL_FUND_TRANSFER": {
      "feeType": "PERCENTAGE",
      "fee": 1.2
    },
    "INTERNATIONAL_CARDS_AND_ALT_PAYS": [
      {
        "cardNetwork": "AMERICAN_EXPRESS",
        "feeType": "FIXED",
        "fee": 5
      },
      {
        "cardNetwork": "DINERS",
        "feeType": "PERCENTAGE",
        "fee": 2.99
      },
      {
        "cardNetwork": "DISCOVER",
        "feeType": "PERCENTAGE",
        "fee": 2.99
      },
      {
        "cardNetwork": "OTHER_DEBIT_CARDS",
        "feeType": "PERCENTAGE",
        "fee": 2.75
      },
      {
        "cardNetwork": "OTHER_CREDIT_CARDS",
        "feeType": "PERCENTAGE",
        "fee": 2.75
      }
    ],
    "DOMESTIC_CARDS_UPI_AND_INB": {
      "feeType": "FIXED",
      "feeRate": 3
    }
  }
}
'
{
  "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://payglocal.mintlify.app/llms.txt

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

​
When to Use

Configures which payment products to enable for the merchant and sets the fee structure for each. Must be completed before triggering Get Verification Redirect.

​
Fee Structure Rules

The productFees object is keyed by product name. The shape of each value depends on the product:
  • GLOBAL_FUND_TRANSFER — single object with feeType (FIXED or PERCENTAGE) and fee (number).
  • INTERNATIONAL_CARDS_AND_ALT_PAYS — array of objects, one entry per card network. All five card networks must be present: AMERICAN_EXPRESS, DINERS, DISCOVER, OTHER_DEBIT_CARDS, OTHER_CREDIT_CARDS.
  • DOMESTIC_CARDS_UPI_AND_INB — single object with feeType (FIXED or PERCENTAGE) and feeRate (up to 2 decimal places).
Enable all three products in the products array to offer the full PayGlocal product suite.

​
Error Scenarios

ScenarioHTTP Code
Missing required fields400
Invalid field format400
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

Body

application/json
​
products
enum<string>[]
required

List of payment products to enable.

Available options:
GLOBAL_FUND_TRANSFER,
INTERNATIONAL_CARDS_AND_ALT_PAYS,
DOMESTIC_CARDS_UPI_AND_INB
Example:
[
  "GLOBAL_FUND_TRANSFER",
  "INTERNATIONAL_CARDS_AND_ALT_PAYS",
  "DOMESTIC_CARDS_UPI_AND_INB"
]
​
productFees
object
required

Fee configuration keyed by product name.

Response

Products and fees configured 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