Sokin Embedded API
  1. Guides
Sokin Embedded API
  • Getting Started
    • Sokin Definitions
    • Guides
      • Authentication
      • Receiving Payments
      • FX Payments
      • Payments
      • Unfunded Payments
      • Unfunded FX Payments
      • Corporate Onboarding
        • Data Requirements
        • Step 1: Create a corporate profile
        • Step 2: Add associates
        • Step 3: Add a parent entity (if applicable)
        • Step 4: Upload company documents
        • Step 5: Upload associate documents
        • Real-time Status Updates via Webhook
        • Conditional Step: Upload Parent Entity documents (if applicable)
        • Step 6: Finalise onboarding submission
        • Uploading supporting documents using Pre-signed URLs
        • Onboarding Reference Data
        • Onboarding Models
          • Data-Only model
          • Supported Jurisdictions & National ID Requirements
      • Payments Reference Data
        • Purpose of Payment
        • Transfer Reasons
        • Beneficiary Fields
  • Authentication
    • Get Token
      POST
    • Get Token on behalf of corporate
      POST
    • Schemas
      • TokenResponse
  • Corporates
    • v2025-12-01
      • Create a new Corporate
      • Add a parent entity (corporate associate) to an onboarding request
      • Add an associate to a corporate onboarding request
      • Request pre-signed URLs for onboarding document uploads
      • Request pre-signed URLs for parent entity document uploads
      • Request pre-signed URLs for associate document uploads
      • Finalise corporate onboarding submission
    • Schemas
      • NumericRange
      • ApiResponse[AddIndividualAssociateResponse]
      • ApiResponse[AddAssociateDocumentsResponse]
      • ApiResponse[AddOnboardingDocumentsResponse]
      • AddOnboardingDocumentsResponse
      • AssociateDocumentPresignedUrlResponse
      • AssociateType
      • ErrorResponse
      • MessageResponse
      • FinaliseSubmissionResponse
      • AddParentEntityRequest
      • MoneyRange
      • AddOnboardingDocumentsRequest
      • ApiResponse[CreateCorporateResponse]
      • CreateCorporateRequest
      • CreateCorporateResponse
      • FinaliseSubmissionRequest
      • PresignedUrlResponse
      • AddressTypeEnum
      • OwnershipType
      • AddAssociateDocumentsResponse
      • ErrorDetail
      • AddIndividualAssociateRequest
      • UboDetails
      • AddParentEntityResponse
      • AddIndividualAssociateResponse
      • CorporateAssociateType
      • AddParentEntityDocumentsRequest
      • AssociateDocumentPresignedUrlResponseItem
      • ApiResponse[AddParentEntityResponse]
      • AssociateIdentityType
      • AddAssociateDocumentsRequest
  • Corporate Currency Accounts
    • v2025-12-01
      • Get Corporate Currency Accounts
      • Get Corporate Currency Account By Reference
    • Schemas
      • ErrorResponse
      • PaginationInfo
      • ErrorDetail
      • ApiResponse[GetCCAByReferenceResponse]
      • GetCCAByReferenceResponse
      • GetCCAByReferenceResponsePayInDetail
      • GetCCAsResponseItem
      • PaginatedApiResponse[GetCCAsResponseItem]
  • Beneficiaries
    • v2025-12-01
      • Get Beneficiary Fields
      • Create External Beneficiary
      • Get Beneficiary List
      • Get Beneficiary Details
      • Delete Beneficiary
    • Schemas
      • ErrorResponse
      • FieldType
      • IdentifierType
      • TransactionTypeEnum
      • BeneficiaryType
      • AccountType
      • ApiResponse[BeneficiaryDetails]
      • ApiResponse[CreateExternalBeneficiaryData]
      • ApiResponse[DeleteBeneficiaryData]
      • ApiResponse[GetBeneficiaryFieldsResponse]
      • BeneficiaryField
      • BeneficiaryListItem
      • CreateExternalBeneficiaryData
      • CreateExternalBeneficiaryRequest
      • DeleteBeneficiaryData
      • GetBeneficiaryFieldsResponse
      • PaginatedApiResponse[BeneficiaryListItem]
      • StateOrProvince
      • PaginationInfo
      • PaginatedBeneficiaryFieldsResponse
      • ErrorDetail
      • BeneficiaryDetails
  • Instruction Requests
    • v2025-12-01
      • Get Instruction Request By Reference
      • Create Payment Instruction Request
      • Create Fx Instruction Request
      • Create Fx Payment Instruction Request
      • Create Unfunded Payment Instruction Request
      • Create Unfunded Fx Payment Instruction Request
    • Schemas
      • ErrorResponse
      • ApiResponse[CreateInstructionRequestResponse]
      • ErrorDetail
      • ApiResponse[GetInstructionRequestResponse]
      • CreateFXInstructionRequest
      • CreateFxPaymentInstructionRequest
      • CreateInstructionRequestResponse
      • CreatePaymentInstructionRequest
      • CreateUnfundedFxPaymentInstructionRequest
      • CreateUnfundedPaymentInstructionRequest
      • GetInstructionRequestResponse
  • Instructions
    • v2025-12-01
      • Get Instruction By Reference
    • Schemas
      • ErrorDetail
      • ErrorResponse
      • ApiResponse[GetInstructionResponse]
      • GetInstructionResponse
  • Foreign Exchange
    • v2025-12-01
      • Get Fx Rate
    • Schemas
      • ErrorResponse
      • FxRateData
      • FixedSide
      • ApiResponse[FxRateData]
      • ErrorDetail
      • FxRateRequest
  • Webhooks
    • Webhooks
    • v2025-12-01
      • Create Subscription
      • Update Subscription Status
      • Update Subscription
      • Delete Subscription
      • Get Subscription By Id
      • List Notification Logs
      • Retry Notification
    • Schemas
      • ApiResponse[CreateSubscriptionResponse]
      • NotificationStatus
      • ApiResponse[NotificationLogList]
      • NotificationAttemptResponse
      • ApiResponse[UpdateSubscriptionResponse]
      • NotificationLogList
      • ErrorResponse
      • NotificationLogResponse
      • SubscriptionCreateOrUpdate
      • SubscriptionStatusUpdate
      • CreateSubscriptionResponse
      • UpdateSubscriptionResponse
      • InstructionCreated
      • ErrorDetail
      • InstructionReqeustRejected
      • InstructionProcessedWebhook
      • InstructionRejectedWebhook
      • OnboardingRequestApproved
      • OnboardingRequestRejected
      • CorporateActivated
      • CorporateDeactivated
      • CorporateCurrencyAccountFundingReceived
      • WebhookSubscription
      • WebhookNotificationLogs
  1. Guides

Corporate Onboarding

Unlock multi-currency accounts for your clients, compliantly and at scale.#

Integrate Sokin’s compliance-first Onboarding API to provision multi-currency accounts for your clients directly within your platform.
As a Sokin Partner, you remain the primary interface for your clients. Sokin provides the regulated financial infrastructure and performs the required review.
Once approved, onboarded clients gain access to:
26+ currency accounts
Payouts to 170+ countries
A secure, globally compliant payments infrastructure
You manage the user experience. Sokin manages compliance and account issuance.

Overview#

An onboarded client is an organisation or individual (Soletrader) on your platform who is issued a Sokin account under Embedded Payments.
Before an account can be created and activated, the client must first be onboarded to Sokin. This ensures compliance with applicable regulatory and due diligence requirements.
Onboarding is initiated by submitting the required data via the API.

Flexible due diligence models#

Sokin supports multiple onboarding models to align with your regulatory structure and operational setup.
The applicable model is determined by your partnership setup and your client’s jurisdiction.

Available models#

Non-Reliance#

Best for partners who prefer Sokin to conduct full verification.
Global coverage
Full corporate and associate documentation required
Sokin performs complete compliance review

Semi-Reliance#

Best for partners operating under structured reliance frameworks.
Global coverage
Full corporate and associate documentation required
Mandatory Due Diligence Bundle (Partner-provided KYC/KYB evidence)
Shared compliance responsibilities

Limited availability model#

Data Only (Non-Doc)#

Designed for specific US-based use cases.
US entities only
Reduced documentation requirements
Screening and eligibility constraints apply
Proof of identity may still be required
ModelBest forCoverageDocument requirements
Non-ReliancePartners who prefer Sokin to conduct full verificationGlobalFull corporate and identity documentation
Semi-RelianceShared verification responsibilitiesGlobalReduced documentation with Partner attestation
Data-OnlyLow-friction US onboardingUS onlyNo document uploads required (proof of ID may apply)

Onboarding API structure#

The onboarding process is divided into three API groups, each representing a stage in the onboarding life cycle.
It is strongly recommended to implement them in sequence, as earlier calls return identifiers required in subsequent requests.

API groups#

1. Create a new Corporate
Initialises the corporate onboarding request and creates a draft corporate entity in Sokin’s system.
This endpoint:
Captures core business and compliance data
Determines onboarding model validation
Creates the corporate record
Generates required IDs for associate and document submission
Initiates the account creation workflow (pending approval)
POST
/corporates
2. Add Associates API group
Submits individuals or corporate associates linked to the entity.
Examples include:
Directors
Beneficial Owners (UBOs)
Partners
Corporate Partners
POST
/corporates/associates
/corporates/parent-entities
Associate requirements depend on entity type (see below under Legal entity associates requirement section).
3. Document Attachment API group
Uploads supporting documentation, where required by model.
Corporate documents:
POST /corporates/documents
(For Semi-Reliance, this must also include submission of the Due Diligence Bundle)
Associate documents:
POST /corporates/associates/documents
Parent entity documents (if applicable):
POST /corporates/parent-entities/documents

Mandatory API sequence#

To successfully onboard a corporation and provision its account, the following API calls are required:
1.Create a new Corporate
POST /corporates
2.Add an associate to a corporate onboarding request
POST /corporates/associates
3.Add onboarding documents (if required by model)
POST /corporates/documents
4.Add associate documents
POST /corporates/associates/documents
5.Finalise Submission
POST /corporates/finalise-submission

Conditional API call#

If the ownership structure includes a parent company or layered corporate ownership, the following endpoint becomes mandatory:
Add a parent entity (corporate associate) to an onboarding request
(POST /corporates/parent-entities)
Parent entity details (company and associate details, along with required documents) must be submitted before finalising the onboarding request. Failure to provide required layered ownership data will result in validation errors or rejection at review stage.
Final submission triggers compliance review.
POST /corporates/finalise-submission

Legal entity associate requirements#

Associate structure is validated based on the legal entity type provided in the Create Onboarding Request.

LTD / LLC / PLC / Pty Ltd#

Minimum structure:
At least 1 Director and
At least 1 Beneficial Owner (UBO, typically ≥25% ownership)
Or 1 individual who performs both roles
Allowed associate types:
Director
Beneficial Owner
Director + UBO (combined role)
Corporate Director/Corporate Beneficial Owner

LLP (Limited Liability Partnership)#

Minimum structure:
2 Partners
OR
1 Partner and 1 Corporate Partner
Allowed associate types:
Partner
Corporate Partner

Sole Trader#

Minimum structure:
Exactly 1 Sole Trader
No additional associates permitted.

Submission lifecycle#

Sokin uses a structured draft-to-finalise submission model.

Step 1 – Draft creation#

Create corporate profile.
Status: PENDING

Step 2 – Associate submission#

Add required individuals and ownership structure.

Step 3 – Document upload (if required)#

Upload corporate, associate, and (if applicable) parent entity documents.

Step 4 – Finalise submission#

Submit for review.
Status transitions to: COMPLIANCE REVIEW

Step 5 – Compliance review#

Application status updates to:
APPROVED
REJECTED
MORE_INFORMATION_REQUIRED
Once approved, corporate accounts are provisioned and enabled for transactions.

Sequence Diagram#

Modified at 2026-02-19 06:51:35
Previous
Unfunded FX Payments
Next
Data Requirements
Built with