Integration Guides
  1. Direct Acquiring

Phase 1 — Organisation Setup

Steps 1–2 of reseller onboarding — create the merchant legal entity and record its address(es).

📘

Part of Merchant Acquiring Reseller — Phase 1 of 6 · Actor: Reseller

Create the legal entity and its address record. The organisationId returned here is required by every later step.

Step 01 — Create the merchant organisation

Register the legal entity. The returned organisationId is required for every subsequent call.

Actor: Reseller

POST /eclipse-conductor/rest/v1/tenants/{tenantId}/organisations

📎 API reference: Register a new organisation

FieldNotes
externalUniqueIdYour unique reference for this org (6–100 chars)
nameLegal registration name (3–50 chars)
typeBUSINESS · CLUB · FAMILY · OTHER
businessTypeLIMITED_COMPANY · SOLE_PROPRIETOR · PARTNERSHIP · CLOSE_CORPORATION · TRUST · PUBLIC_LISTED_COMPANY
companyNumberCIPC registration number — required for MATCH screening (5–20 chars)
businessRegistrationDateFormat: yyyyMMdd e.g. 20180305
taxNumberSARS income tax reference (3–20 chars)
categoryCode4-digit MCC — must be on the tenant's allowed list
vatNumberVAT registration number, if applicable
tradingNameTrading name if different from legal name
emailOrganisation contact email
phone1Primary contact number
⚠️

companyNumber is mandatory for MATCH

Omitting companyNumber causes the Mastercard MATCH check to be skipped. A skipped MATCH flags the ratification result for manual compliance review and delays activation. For Sole Proprietors with no registered company, see Phase 3, Step 08 for the alternative document set.

Step 02 — Add organisation address

Submit registered and trading addresses separately if they differ.

Actor: Reseller

POST /eclipse-conductor/rest/v1/tenants/{tenantId}/organisations/{organisationId}/addresses

📎 API reference: Add a new address for the organisation

FieldNotes
addressTypeREGISTERED · PHYSICAL · POSTAL · OPERATING · HEADQUARTERS · BRANCH · PRIMARY
line1Street address (3–150 chars)
cityCity (2–20 chars)
stateProvince or state (3–50 chars)
countryISO 3166-1 alpha-2 e.g. ZA
codePostal code (3–10 chars)
📘

Two calls if addresses differ

Call this endpoint twice if the trading address differs from the registered address — once with addressType: REGISTERED and once with addressType: PHYSICAL.

Navigation