Skip to main content
PUT
/
gcc
/
v2
/
partner
/
merchant
/
onboard
/
{onboardingId}
/
bank-details
Update Bank Details
curl --request PUT \
  --url https://api.onboard.payglocal.in/gcc/v2/partner/merchant/onboard/{onboardingId}/bank-details \
  --header 'Content-Type: application/json' \
  --header 'x-gl-auth: <api-key>' \
  --header 'x-gl-digest: <api-key>' \
  --data '
{
  "bankAccountNumber": "123456789012",
  "bankIfscCode": "HDFC0001234",
  "accountType": "CURRENT"
}
'
{
  "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

Submits or updates the settlement bank account. PayGlocal performs a penny drop verification to confirm the account is active and the IFSC is valid.
Bank details cannot be updated after the merchant’s verification step is complete. If the penny drop fails, prompt the merchant to re-enter their bank details.

​
Notes

  • If penny drop verification fails in Production, CANCELLED_CHEQUE is added to documentsToBeUploaded. Upload a cancelled cheque via Upload Documents with merchantDocType: CANCELLED_CHEQUE.
  • In UAT, use account number 1234567890 and IFSC SBIN0000000 for successful verification. Any other combination triggers a CANCELLED_CHEQUE pendency. See Sandbox Testing → Partner Onboarding.

​
Error Scenarios

ScenarioHTTP Code
Required fields missing or empty400
Penny drop verification fails400
Update attempted after verification step is complete400
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
​
bankAccountNumber
string
required

Bank account number for settlement.

Example:

"123456789012"

​
bankIfscCode
string
required

11-character IFSC code of the bank branch.

Example:

"HDFC0001234"

​
accountType
enum<string>
required

Type of bank account.

Available options:
CURRENT,
SAVINGS
Example:

"CURRENT"

Response

Bank 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