Skip to main content
POST
/
partners
/
merchants
Create Merchant
curl --request POST \
  --url https://api-pacb-uat.eximpe.com/partners/merchants/ \
  --header 'Content-Type: application/json' \
  --header 'X-API-Version: <api-key>' \
  --header 'X-Client-ID: <api-key>' \
  --header 'X-Client-Secret: <api-key>' \
  --data '
{
  "settlement_details": {
    "bank_account_number": "6789123450987654",
    "bank_account_name": "InnovateTech Solutions Private Limited",
    "bank_swift_code": "CHASINUS33XXX",
    "bank_name": "JPMorgan Chase Bank",
    "bank_branch_name": "Financial District Branch",
    "bank_address": "270 Park Avenue, New York",
    "bank_city": "New York",
    "bank_state": "NY",
    "bank_country": "United States",
    "bank_pincode": "10017",
    "routing_number": "021000021"
  },
  "company_details": {
    "legal_name": "InnovateTech Solutions Private Limited",
    "brand_name": "InnovateTech",
    "registration_number": "US-CORP-2024-IT789456",
    "international_org_type": "Private Limited Company",
    "tax_id": "94-8765432",
    "website": "https://www.innovatetech.com",
    "monthly_avg_transaction_volume": "485",
    "communication_address": "Suite 1200, 101 California Street",
    "communication_city": "San Francisco",
    "communication_state": "CA",
    "communication_country": "United States",
    "communication_pincode": "94111",
    "same_as_registered_address": false,
    "registered_address": "1455 Market Street, Suite 1600",
    "registered_city": "San Francisco",
    "registered_state": "CA",
    "registered_country": "United States",
    "registered_pincode": "94103",
    "business_category": "goods_merchant",
    "business_mode": "b2b",
    "hs_codes": [
      "85234910",
      "84715000"
    ],
    "category": "Enterprise Software and Cloud Services",
    "description_of_products_and_services": "InnovateTech provides cutting-edge cloud computing solutions, artificial intelligence platforms, and enterprise software systems. We specialize in machine learning algorithms, data analytics, and scalable cloud infrastructure for Fortune 500 companies.",
    "agreement_details": "Master Service Agreement for Cloud Solutions dated 2024-03-15"
  }
}
'
{
  "success": true,
  "message": "Sub-merchant created successfully",
  "data": {
    "id": "6182929449",
    "settlement_details": {
      "bank_account_number": "9876543210",
      "bank_account_name": "GlobalTech Solutions Inc.",
      "bank_swift_code": "CHASUS33XXX",
      "bank_name": "JPMorgan Chase Bank",
      "bank_branch_name": "Corporate Banking Division",
      "bank_address": "270 Park Avenue",
      "bank_city": "New York",
      "bank_state": "NY",
      "bank_country": "United States",
      "bank_pincode": "10017",
      "routing_number": "021000021",
      "settlement_currency": "USD"
    },
    "created_at": "2025-01-15T10:30:00.000000Z",
    "updated_at": "2025-01-15T10:30:00.000000Z",
    "invoice_file": null,
    "company_details": {
      "legal_name": "GlobalTech Solutions Inc.",
      "brand_name": "GlobalTech",
      "registration_number": "US-CORP-99887766",
      "international_org_type": "Private Limited Company",
      "tax_id": "94-1234567",
      "website": "https://www.globaltech.io",
      "monthly_avg_transaction_volume": "300",
      "communication_address": "500 Mission Street, Suite 2400",
      "communication_city": "San Francisco",
      "communication_state": "CA",
      "communication_country": "United States",
      "communication_pincode": "94105",
      "same_as_registered_address": false,
      "registered_address": "1600 Amphitheatre Parkway",
      "registered_city": "Mountain View",
      "registered_state": "CA",
      "registered_country": "United States",
      "registered_pincode": "94043",
      "business_category": "goods_merchant",
      "business_mode": "b2b",
      "hs_codes": [
        "85234910",
        "84715000"
      ],
      "category": "Enterprise SaaS",
      "description_of_products_and_services": "GlobalTech provides cloud-native enterprise software, including AI-powered analytics platforms, CRM solutions, and infrastructure automation tools. We enable digital transformation for Fortune 500 companies through scalable and secure software systems.",
      "agreement_details": "Master Service Agreement dated 2024-01-10 with Global Clients"
    }
  }
}

Authorizations

X-Client-ID
string
header
required

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.

X-Client-Secret
string
header
required

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.

X-API-Version
string
header
required

API Version - Specifies which version of the API to use (e.g., '1.X.X' or '2.X.X'). This header allows you to control which API version your integration uses. Default version information is available in the Developer Settings.

Body

application/json

Merchant details to create

settlement_details
object
required
company_details
object
required

Response

Merchant created successfully.

success
boolean
required

Indicates if the request was successful

message
string
required

Response message

data
object
required