Get Merchant
Retrieve the details of a specific merchant by its ID.
Overview
Retrieve the full details of a specific sub-merchant by its ID, including company information, settlement details, and current KYC status.Request Parameters
Path Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| merchant_id | string | Yes | The unique identifier of the sub-merchant (e.g., 6692437779) |
Response
The response includes the same fields as Create Merchant and Update Merchant responses.| Name | Type | Description |
|---|---|---|
| id | string | Unique merchant identifier |
| company_details | object | Company registration, business, and contact details |
| settlement_details | object | Bank settlement details including settlement currency |
| kyc_status | string | Current KYC/onboarding status (PENDING, IN_REVIEW, CHANGES_REQUESTED, APPROVED, REJECTED) |
| created_at | string | ISO 8601 timestamp of creation |
| last_updated_at | string | ISO 8601 timestamp of last update |
Response Example
Error Codes
| Code | Message | Description |
|---|---|---|
| ERR_MERCHANT_001 | Validation error | Merchant not found or access denied |
Authorizations
Client Application ID - Your unique application identifier used to authenticate API requests. You can find your Client ID in the Developer Settings section of the merchant dashboard.
Client Secret Key - Your secret key used alongside the Client ID for secure authentication. Keep this confidential and never expose it in client-side code. Available in the Developer Settings section of the merchant dashboard.
API Version - Specifies which version of the API to use (e.g., '1.X.X', '2.X.X', or '3.X.X'). This header allows you to control which API version your integration uses. Default version information is available in the Developer Settings.
Path Parameters
The ID of the merchant to retrieve.