Phase 3 — Organisation Documents & T&Cs
Steps 8–9 of reseller onboarding — upload the KYB business documents and record the merchant's source of funds.
Part of Merchant Acquiring Reseller — Phase 3 of 6 · Actor: ResellerUpload all KYB-required business documents against the organisation, plus the merchant's source of funds. Everything here must be in place before ratification is submitted in Phase 4. The merchant's Terms & Conditions are accepted digitally later, in Phase 6, Step 16 — not here.
Step 08 — Upload organisation business documents
All KYB-required business documents are uploaded against the organisation record. One call per document. All documents must be in place before ratification is submitted in Step 12.
Actor: Reseller
POST /eclipse-conductor/rest/v1/tenants/{tenantId}/organisations/{organisationId}/documents📎 API reference: Add a document to the organisation
| Field | Notes |
|---|---|
documentType | See supported types below |
base64EncodedDocument | Base64-encoded file content |
mediaType | image/jpeg · image/png · application/pdf |
extraInfo | Optional metadata or context note |
performOcr | Query param — enables OCR on upload |
validateDocType | Query param — verifies content matches the declared type (requires performOcr=true) |
Mandatory — all business types
CERT_OF_INCORP or CERT_OF_REGISTRATION · PROOF_OF_ADDRESS · TAX · BANK_ACCOUNT_CONFIRMATION · BANK_STATEMENT (Source of Funds)
UBO information and declaration are mandatory for every merchantUBO stands for "Ultimate Beneficial Owner" — the real person(s) who ultimately own or control the company. They are the individuals who benefit from the company's profits or have significant influence over its operations and decision-making. You must provide details of every individual with a 5% or more ownership stake or control, and a UBO declaration is mandatory for every merchant.
Each UBO must be registered as a customer in Phase 2, Step 04, with their identity document mandatorily uploaded and KYC'd and their source of funds recorded as a
SOURCE_OF_FUNDScustomer attachment (Phase 2, Step 05).
Sole Proprietor — no registered company
CERT_OF_INCORPandCERT_OF_REGISTRATIONare not applicable. Upload the owner's personal KYC documents at the customer level (ID, proof of address) in Phase 2, Step 05, plus aTAXdocument (SARS income tax reference) at the organisation level. The KYB ruleset relies on the positional holder's KYC data in lieu of a company registration certificate.
CERT_OF_INCORPvsCERT_OF_REGISTRATION
CERT_OF_REGISTRATIONis the correct type for CIPC-issued documents. UseCERT_OF_INCORPif the tenant's KYB ruleset references that specific field name — they serve the same purpose.
Optional — supported document types
BUSINESS_LICENSE · PARTNERSHIP_DEED · TRUST_DEED · LOGO · PROOF_OF_FUNDS · ENHANCED_DUE_DILIGENCE · USA_W_8 · USA_W_9 · AFFIDAVIT
Step 09 — Record the source of funds as an organisation attachment
Records the organisation's source of funds against the organisation. One attachment — call the endpoint once.
Actor: Reseller
POST /eclipse-conductor/rest/v1/tenants/{tenantId}/organisations/{organisationId}/attachments📎 API reference: Add an attachment to the organisation — supported media types: application/pdf, image/png, image/jpeg, application/json, text/plain.
| Field | Notes |
|---|---|
attachmentType | SOURCE_OF_FUNDS |
info | The organisation's source-of-funds value — one of the accepted values below |
mediaType | Media type of the attachment — required in practice, even for this info-only attachment. The API spec marks it optional, but the backend rejects a null media_type with 400 SQL001. Use text/plain for a text info value, or application/pdf / image/png / image/jpeg for a document. |
base64EncodedAttachment | Optional supporting document (Base64-encoded), if provided |
Source of funds is mandatory at the merchant levelEvery merchant must have an organisation-level
SOURCE_OF_FUNDSattachment. This is in addition to the per-customerSOURCE_OF_FUNDSattachment recorded for each UBO in Phase 2, Step 05.
Source of funds — accepted values
Salary · Securities / Investments · Property (Commercial / residential investments) · Beneficiaries of trusts or foundations · Inheritance, gift, or donations · Business / Partnership · Divorce settlement · Sale of business or other principle asset · Savings · Sale of Investments · Loan · Maturity or surrender of life assurance policy · Insurance claims · Other court award · Other income · Relationship to third party · Business income / profits · Asset swap · Winnings · Trust donor · Passive income (rental, dividends, interest) · Other
Website URL is set on the organisationThe merchant's website URL is captured as the
businessWebsitefield on the organisation at creation (Phase 1, Step 01) or update (Phase 4, Step 10) — it is no longer recorded as an attachment here.
Terms & Conditions are handled separatelyThe merchant's T&C acceptance is not an attachment here. It is captured by a dedicated digital-acceptance API in Phase 6, Step 16 (stored as
terms.acceptance), which must be completed before the first submit-for-review.
Navigation
- ◀ Previous: Phase 2 — Customer Registration & Positions
- ▲ Overview: Merchant Acquiring Reseller
- ▶ Next: Phase 4 — Verification & KYB Submission
Updated about 1 hour ago