Merchant

Get merchant by ID

Retrieve detailed information for a specific merchant within an organization. Requires ORGANIZATION_SETTINGS_VIEW_MERCHANT or MERCHANT_SETTINGS_VIEW_USER permission.

get/api/v1/organizations/{organizationId}/merchants/{merchantId}

Request

  • Base URL: https://api-sandbox.koywe.com
  • URL: https://api-sandbox.koywe.com/api/v1/organizations/{organizationId}/merchants/{merchantId}
  • Auth: HTTP bearer

Path parameters

organizationIdstring required
Example:org_abc123

Organization identifier

merchantIdstring required
Example:mer_def456

Merchant identifier

Response

Merchant information retrieved successfully

merchantIdstring required
slugstring required
businessTypestring required
businessStructurestring required
chargesEnabledboolean required
countryIdstring required
createdAtstring date-time required
defaultCurrencyIdstring required
kybCompleteboolean required
disabledboolean required
disabledReasonstring required
lifecycleStatus'DRAFT' | 'ENABLED_LIMITED' | 'KYB_REQUIRED' | 'ACTIVE' | 'KYB_RENEWAL_REQUIRED' | 'REJECTED' required

Current lifecycle state of the merchant

canOperateboolean required

Whether the merchant can currently process transactions

validTransitionsstring[] required

Valid next states the merchant can transition to

Example response

{
  "merchantId": "mrc_31fd8637-f889-43fa-8b31-50d9296abfdc",
  "slug": "republic",
  "profile": {
    "name": "Galactic Republic Trading",
    "description": "1234 Main St, Coruscant",
    "address": "1234 Main St, Coruscant",
    "addressLine2": "Suite 100",
    "city": "Springfield",
    "postalCode": "90210",
    "state": "California",
    "stateId": "st_xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "countyId": "cnt_xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "email": "galactic.republic@row.com",
    "phone": "1234567890",
    "url": "https://galacticrepublic.com",
    "supportEmail": "galacticrepublic",
    "supportPhone": "1234567890",
    "supportUrl": "https://galacticrepublic.com/support",
    "taxIdType": "CUIT",
    "taxIdNumber": "123456789",
    "dateOfBirth": "1990-01-15T00:00:00.000Z",
    "nationalityCountryId": "ctry_xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  },
  "businessType": "Galactic Republic Trading",
  "businessStructure": "Galactic Republic Trading",
  "capabilities": {
    "payments": true,
    "collections": true
  },
  "chargesEnabled": true,
  "countryId": "ctry_84b8b218-2777-4e7f-863e-7d0601ac289f",
  "createdAt": "2024-07-01T22:40:22.003Z",
  "defaultCurrencyId": "cur_8289dc19-e775-4c0c-a42a-e0da129e3b64",
  "kybComplete": true,
  "disabled": true,
  "disabledReason": "N/D",
  "billing": {
    "roundingType": "NET"
  },
  "branding": {
    "icon": "https://example.com/icon.png",
    "logo": "https://example.com/logo.png",
    "primaryColor": "#FF0000",
    "secondaryColor": "#00FF00"
  },
  "lifecycleStatus": "ENABLED_LIMITED",
  "canOperate": true,
  "validTransitions": [
    "KYB_REQUIRED"
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.