Sokin Embedded API
    Sokin Embedded API
    • Getting Started
      • Sokin Definitions
      • Guides
        • Authentication
        • Receiving Payments
        • FX Payments
        • Payments
        • Unfunded Payments
        • Unfunded FX Payments
    • Authentication
      • Get Token
        POST
      • Get Token on behalf of corporate
        POST
      • Schemas
        • TokenResponse
    • Corporates
      • v2025-12-01
        • Create a new Corporate
        • Finalise corporate onboarding submission
        • Request pre-signed URLs for onboarding document uploads
      • Schemas
        • AddOnboardingDocumentsRequest
        • ApiResponse[CreateCorporateResponse]
        • CreateCorporateRequest
        • CreateCorporateResponse
        • FinaliseSubmissionRequest
        • FinaliseSubmissionResponse
        • PresignedUrlResponse
    • Corporate Currency Accounts
      • v2025-12-01
        • Get Corporate Currency Accounts
        • Get Corporate Currency Account By Reference
      • Schemas
        • ApiResponse[GetCCAByReferenceResponse]
        • GetCCAByReferenceResponse
        • GetCCAByReferenceResponsePayInDetail
        • GetCCAsResponseItem
        • PaginatedApiResponse[GetCCAsResponseItem]
    • Beneficiaries
      • v2025-12-01
        • Get Beneficiary Fields
        • Create External Beneficiary
        • Beneficiary List
        • Delete Beneficiary
      • Schemas
        • ApiResponse[BeneficiaryDetails]
        • ApiResponse[CreateExternalBeneficiaryData]
        • ApiResponse[DeleteBeneficiaryData]
        • ApiResponse[GetBeneficiaryFieldsResponse]
        • BeneficiaryField
        • BeneficiaryListItem
        • CreateExternalBeneficiaryData
        • CreateExternalBeneficiaryRequest
        • DeleteBeneficiaryData
        • GetBeneficiaryFieldsResponse
        • PaginatedApiResponse[BeneficiaryListItem]
        • PaginatedBeneficiaryFieldsResponse
        • StateOrProvince
    • 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
        • CreateFXInstructionRequest
        • CreateFxPaymentInstructionRequest
        • CreateInstructionRequestResponse
        • CreatePaymentInstructionRequest
        • CreateResellerFxPaymentInstructionRequest
        • CreateResellerPaymentInstructionRequest
        • GetInstructionRequestResponse
    • Instructions
      • v2025-12-01
        • Get Instruction By Reference
      • Schemas
        • GetInstructionResponse
    • Foreign Exchange
      • v2025-12-01
        • Get Fx Rate
      • Schemas
        • FxRateRequest
    • Webhooks
      • Webhooks
      • v2025-12-01
        • Subscriptions
          • Create Subscription
          • Update Subscription
          • Update Subscription Status
          • Delete Subscription
          • Get Subscription
        • Notifications
          • Get Notifications
          • Retry Failed Notification
      • Schemas
        • InstructionCreated
        • InstructionReqeustRejected
        • InstructionProcessedWebhook
        • InstructionRejectedWebhook
        • OnboardingRequestApproved
        • OnboardingRequestRejected
        • CorporateActivated
        • CorporateDeactivated
        • CorporateCurrencyAccountFundingReceived
        • WebhookSubscription
        • WebhookNotificationLogs

    CreateCorporateRequest(CreateCorporateRequest)

    Request payload for creating a new corporate onboarding request.
    This model supports both new API-friendly formats (booleans, range objects)
    and legacy formats (Yes/No strings) for backward compatibility.

    {
        "corporateName": "Acme Technologies Ltd",
        "registrationId": "12345678",
        "dateOfIncorporation": "2020-01-15",
        "doingBusinessAs": "Acme Tech",
        "natureOfBusiness": "62020",
        "businessIncorporationDate": "Over 2 years",
        "taxNumber": "GB123456789",
        "website": "https://www.acme-tech.com",
        "corporateCategory": "LTD",
        "customerExpectedTransactionValue": {
            "currency": "USD",
            "max": 150000,
            "min": 0
        },
        "customerExpectedAmountVolume": {
            "max": 10,
            "min": 1
        },
        "outgoingTransactionValuePerYear": {
            "currency": "USD",
            "max": 200000,
            "min": 0
        },
        "yearsOfTrading": {
            "max": 2,
            "min": 0
        },
        "annualRevenue": {
            "currency": "USD",
            "max": 500000,
            "min": 0
        },
        "annualFxVolumeInUsd": {
            "currency": "USD",
            "max": 500000,
            "min": 0
        },
        "businessAddress": "123 Business Street",
        "country": "GB",
        "postalCode": "SW1A 1AA",
        "city": "London",
        "stateOfProvince": "Greater London",
        "isSameOperatingAddress": true,
        "operatingAddress": "456 Operating Avenue",
        "operatingAddressCountry": "GB",
        "operatingAddressPostalCode": "EC1A 1BB",
        "operatingAddressCity": "London",
        "operatingAddressStateOfProvince": "Greater London",
        "contactName": "John Smith",
        "corporateEmailAddress": "contact@acme-tech.com",
        "phoneNumber": "+441234567890",
        "notificationEmail": "notifications@acme-tech.com",
        "paymentQueriesContactName": "Jane Doe",
        "paymentQueriesEmailAddress": "payments@acme-tech.com",
        "paymentQueriesMobileNo": "+441234567891",
        "isExistingBankAccount": true,
        "bankAccountDetails": "HSBC Business Account",
        "isDispute": false,
        "disputeDetails": "None",
        "isBankruptcy": false,
        "bankruptcyDetails": "None",
        "isRegulated": false,
        "regulatedDetails": "None",
        "anticipateReceivingPayment": "Clients/Customers, Vendors/Partners",
        "purposeOfReceivingPayment": "Sales revenue from customers",
        "anticipateSendingPayment": "Suppliers/Vendors/Partners, Employees",
        "purposeOfSendingPayment": "Supplier payments and payroll",
        "intendPaymentCountry": "GB, US, DE",
        "receivePaymentCountry": "GB, US, FR",
        "makeReceivePaymentCurrency": "GBP, USD, EUR",
        "sourceOfFunds": [
            "Inter-company payments",
            "Income from ongoing operations"
        ],
        "sourceOfFundsInfo": "Revenue from software licensing",
        "planToUseSokinServices": [
            "Pay Suppliers or Contractors",
            "Receive money from your customers"
        ],
        "otherPlan": "",
        "briefBusinessDescription": "Technology consulting company providing IT solutions and software development services to enterprise clients across Europe and North America.",
        "source": "API"
    }
    Built with