- Getting Started
- Sokin Definitions
- Guides
- Authentication
- Receiving Payments
- FX Payments
- Payments
- Unfunded Payments
- Unfunded FX Payments
- Webhooks
- 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
- Sokin MCP
- Authentication
- 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
- CreateCorporateRequest
- UboDetails
- OwnershipType
- AssociateDocumentPresignedUrlResponse
- AddOnboardingDocumentsRequest
- MessageResponse
- AssociateDocumentPresignedUrlResponseItem
- ErrorDetail
- CorporateAssociateType
- ErrorResponse
- PresignedUrlResponse
- AddressTypeEnum
- FinaliseSubmissionRequest
- AddParentEntityRequest
- CreateCorporateResponse
- AssociateIdentityType
- ApiResponse[AddOnboardingDocumentsResponse]
- CorporateCategories
- AddOnboardingDocumentsResponse
- ApiResponse[CorporateDetailResponse]
- ApiResponse[AddAssociateDocumentsResponse]
- AddParentEntityDocumentsRequest
- AddAssociateDocumentsResponse
- AddParentEntityResponse
- AddIndividualAssociateRequest
- ApiResponse[CreateCorporateResponse]
- AddIndividualAssociateResponse
- CorporateDetailResponse
- AssociateType
- ApiResponse[AddParentEntityResponse]
- NumericRange
- ApiResponse[AddIndividualAssociateResponse]
- MoneyRange
- AddAssociateDocumentsRequest
- FinaliseSubmissionResponse
- AssociateIdentityType
- v2025-12-01
- Corporate Currency Accounts
- v2025-12-01
- Schemas
- GetCCAByReferenceResponse
- GetCCAsResponseItem
- PaginatedApiResponse[GetCCALedgerItemsResponseItem]
- ErrorDetail
- PageInfo
- SearchCCALedgersResponseItem
- PaginationInfo
- GetCCAUnifiedBalanceResponse
- PaginatedApiResponse[SearchCCALedgersResponseItem]
- ErrorResponse
- ApiResponse[GetCCAUnifiedBalanceResponse]
- SearchCCALedgersRequest
- PaginatedApiResponse[GetCCAsResponseItem]
- ApiResponse[GetCCAByReferenceResponse]
- PaginationInfo
- SearchCCALedgersPagination
- GetCCAByReferenceResponsePayInDetail
- CurrencyCode
- GetCCALedgerItemsResponseItem
- PaginationInfo
- Beneficiaries
- v2025-12-01
- Schemas
- ProviderBankIdentifierRequest
- ErrorDetail
- FinancialInstitutionReferenceResponse
- ApiResponse[list[FinancialInstitutionReferenceResponse]]
- DeleteBeneficiaryData
- AddressResponse
- BeneficiarySchemaFieldCondition
- StateOrProvince
- ApiResponse[list[BankCountryCurrencyResponse]]
- PageInfo
- BeneficiarySchemaField
- BeneficiaryValidationResultResponse
- StateOrProvince
- ApiResponse[BeneficiaryResponse]
- BeneficiaryField
- RegionalHints
- BeneficiaryStatus
- DestinationResponse
- ValidationStatus
- BeneficiaryType
- PaymentMethodType
- CreateBeneficiaryRequest
- PaginatedApiResponse[FinancialInstitutionBranchReferenceResponse]
- ValidateBeneficiariesRequest
- ApiResponse[ValidateBatchBeneficiariesResponse]
- CompanyDetailsResponse
- SchemaFieldVisibility
- FieldErrorResponse
- RoutingScheme
- StateOrProvince
- ValidateBeneficiaryRequest
- ErrorResponse
- FieldType
- VirtualAccountDestinationRequest
- ApiResponse[DeleteBeneficiaryData]
- SokinInternalDestinationRequest
- GetBeneficiaryFieldsResponse
- BeneficiaryResponse
- ApiResponse[ValidateBeneficiaryResponse]
- FinancialInstitutionBranchReferenceResponse
- IdentifierType
- IndividualDetailsRequest
- SchemaFieldType
- CurrencyCode
- TransactionTypeEnum
- CryptoDestinationRequest
- AccountType
- BeneficiaryValidationPayload
- ApiResponse[GetBeneficiaryFieldsResponse]
- AccountNumberType
- PatchBeneficiaryRequest
- BankAccountCategory
- ApiResponse[GetBeneficiarySchemaResponse]
- PaginatedApiResponse[BeneficiaryResponse]
- ApiResponse[list[BankCountryResponse]]
- AddressRequest
- PaginationInfo
- BankCountryCurrencyResponse
- PaginationInfo
- ValidateBatchBeneficiariesResponse
- PaymentRail
- CreateExternalBeneficiaryData
- FinancialInstitutionRequest
- ApiResponse[CreateExternalBeneficiaryData]
- CompanyDetailsRequest
- BankCountryResponse
- CreateExternalBeneficiaryRequest
- BankAccountDestinationRequest
- IndividualDetailsResponse
- BeneficiarySchemaCondition
- BeneficiaryDestinationValidationResult
- BeneficiaryEntityType
- GetBeneficiarySchemaResponse
- ETransferDestinationRequest
- ValidateBeneficiaryResponse
- RoutingCodeRequest
- ApiResponse[BeneficiaryDetails]
- BeneficiaryListItem
- PaginatedApiResponse[BeneficiaryListItem]
- PaginationInfo
- PaginatedBeneficiaryFieldsResponse
- BeneficiaryDetails
- ApiResponse[ListFinancialInstitutionsResponse]
- ListFinancialInstitutionsResponse
- Instruction Requests
- v2025-12-01
- Schemas
- ApiResponse[GetInstructionRequestResponse]
- ValidateInstructionCreationRequest
- ErrorDetail
- InstructionType
- CreateInstructionRequestResponse
- ApiResponse[CreateInstructionRequestResponse]
- ValidateInstructionCreationResponse
- CreateFxPaymentInstructionRequest
- FeeBreakdownResponse
- ErrorResponse
- CreateUnfundedPaymentInstructionRequest
- CreateUnfundedFxPaymentInstructionRequest
- ApiResponse[list[str]]
- GetInstructionRequestResponse
- PaymentPurpose
- CreatePaymentInstructionRequest
- CreateFXInstructionRequest
- ApiResponse[ValidateInstructionCreationResponse]
- CreateSokinDirectInstructionRequest
- Instructions
- Foreign Exchange
- Webhooks
- v2025-12-01
- Schemas
- ApiResponse[UpdateSubscriptionResponse]
- PaginationInfo
- SubscriptionCreateOrUpdate
- NotificationStatus
- NotificationAttemptResponse
- SubscribableWebhookEventType
- SubscriptionStatusUpdate
- ApiResponse[CreateSubscriptionResponse]
- UpdateSubscriptionResponse
- PaginatedApiResponse[NotificationLogResponse]
- PaginationInfo
- ErrorResponse
- ErrorDetail
- PageInfo
- CreateSubscriptionResponse
- NotificationLogResponse
- WebhookSubscription
- Payment Acceptance
PatchBeneficiaryRequest(PatchBeneficiaryRequest)
{
"displayName": "string",
"entityType": "individual",
"countryCode": "st",
"currencyCode": "AED",
"paymentRail": "internal",
"bankAccount": {
"property1": "string",
"property2": "string"
},
"eTransfer": {
"property1": "string",
"property2": "string"
},
"virtualAccount": {
"property1": "string",
"property2": "string"
},
"sokinInternal": {
"property1": "string",
"property2": "string"
},
"crypto": {
"property1": "string",
"property2": "string"
},
"individual": {
"property1": "string",
"property2": "string"
},
"company": {
"property1": "string",
"property2": "string"
},
"address": {
"property1": "string",
"property2": "string"
},
"otp": "string",
"confirmVerifiedPayeeName": false
}