Skip to main content
POST
/
partners
/
merchants
Create Merchant
curl --request POST \
  --url https://api-staging.eximpe.com/partners/merchants/ \
  --header 'Content-Type: application/json' \
  --header 'X-Client-ID: <api-key>' \
  --header 'X-Client-Secret: <api-key>' \
  --data '
{
  "settlement_details": {
    "bank_account_number": "1234567890",
    "bank_account_name": "Example Company Ltd",
    "bank_swift_code": "ABCDUS33",
    "bank_name": "Example Bank",
    "bank_branch_name": "Main Branch",
    "bank_address": "456 Bank St",
    "bank_city": "New York",
    "bank_state": "NY",
    "bank_country": "United States",
    "bank_pincode": "10002",
    "routing_number": "021000021"
  },
  "company_details": {
    "legal_name": "shrine",
    "brand_name": "TechSubshrine",
    "registration_number": "REG123456",
    "international_org_type": "PRIVATE_LIMITED",
    "tax_id": "TAX789012",
    "website": "https://techsub.example.com",
    "monthly_avg_transaction_value": "50000.00",
    "monthly_avg_transaction_volume": "100",
    "communication_address": "123 Tech Street",
    "communication_city": "San Francisco",
    "communication_state": "CA",
    "communication_country": "United States",
    "communication_pincode": "94105",
    "same_as_registered_address": true,
    "registered_address": "123 Tech Street",
    "registered_city": "San Francisco",
    "registered_state": "CA",
    "registered_country": "United States",
    "registered_pincode": "94105",
    "business_category": "TECHNOLOGY",
    "business_mode": "B2B",
    "commodity": "Software Services",
    "payment_terms": "NET_30",
    "hs_codes": [
      "84713010",
      "85423100"
    ],
    "category": "E-commerce",
    "description_of_products_and_services": "We provide comprehensive IT solutions including software development, cloud migration, data analytics, and digital transformation services for enterprises. Our solutions help businesses streamline operations, improve efficiency, and accelerate digital adoption.",
    "agreement_details": "global_company aggrement",
    "purpose_code": "P0101"
  }
}
'
{
  "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",
      "tax_id": "94-1234567",
      "website": "https://www.globaltech.io",
      "monthly_avg_transaction_value": "150000.00",
      "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": "TECHNOLOGY",
      "business_mode": "B2B",
      "commodity": "Enterprise Software Solutions",
      "payment_terms": "NET_30",
      "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",
      "purpose_code": "P0101"
    }
  }
}

Authorizations

​
X-Client-ID
string
header
required

Client app ID. You can find your app id in the merchant dashboard.

​
X-Client-Secret
string
header
required

Client secret key. You can find your secret in the merchant dashboard.

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