1. Guides
Sokin Embedded API
  • 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
          • Data-Only model
          • Supported Jurisdictions & National ID Requirements
  • 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
      • 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
      • CreateCorporateRequest
      • FinaliseSubmissionResponse
      • AssociateIdentityType
  • Corporate Currency Accounts
    • v2025-12-01
      • Get Corporate Currency Accounts
      • Get Cca Ledger Items
      • Get Corporate Currency Account By Reference
    • 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
      • Get Beneficiary Schema
      • Create Beneficiary
      • Get Beneficiary List
      • Get Beneficiary Details
      • Delete Beneficiary
      • Validate Beneficiary
      • List Financial Institutions
      • List Financial Institution Branches
    • Schemas
      • BeneficiaryValidationPayload
      • PaymentMethodType
      • PaymentRail
      • FinancialInstitutionReferenceResponse
      • ApiResponse[GetBeneficiarySchemaResponse]
      • ApiResponse[list[FinancialInstitutionReferenceResponse]]
      • DeleteBeneficiaryData
      • AddressResponse
      • ApiResponse[list[BankCountryCurrencyResponse]]
      • ErrorDetail
      • PageInfo
      • BeneficiaryValidationResultResponse
      • StateOrProvince
      • ApiResponse[ValidateBatchBeneficiariesResponse]
      • DestinationResponse
      • BeneficiaryField
      • BeneficiaryStatus
      • ValidationStatus
      • PaginationInfo
      • BeneficiaryType
      • FinancialInstitutionRequest
      • ValidateBeneficiariesRequest
      • ApiResponse[DeleteBeneficiaryData]
      • CompanyDetailsResponse
      • ValidateBeneficiaryRequest
      • FieldErrorResponse
      • StateOrProvince
      • PaginatedApiResponse[FinancialInstitutionBranchReferenceResponse]
      • CreateBeneficiaryRequest
      • VirtualAccountDestinationRequest
      • ErrorResponse
      • BankCountryCurrencyResponse
      • FieldType
      • CreateExternalBeneficiaryRequest
      • SokinInternalDestinationRequest
      • GetBeneficiaryFieldsResponse
      • BeneficiarySchemaField
      • BeneficiaryResponse
      • FinancialInstitutionBranchReferenceResponse
      • ApiResponse[BeneficiaryResponse]
      • IdentifierType
      • IndividualDetailsRequest
      • SchemaFieldType
      • ApiResponse[ValidateBeneficiaryResponse]
      • ValidateBeneficiaryResponse
      • TransactionTypeEnum
      • AccountType
      • ETransferDestinationRequest
      • AccountNumberType
      • BankAccountCategory
      • PaginatedApiResponse[BeneficiaryResponse]
      • ApiResponse[list[BankCountryResponse]]
      • AddressRequest
      • RegionalHints
      • BeneficiaryDestinationValidationResult
      • PaginationInfo
      • ValidateBatchBeneficiariesResponse
      • ApiResponse[GetBeneficiaryFieldsResponse]
      • BankAccountDestinationRequest
      • CreateExternalBeneficiaryData
      • GetBeneficiarySchemaResponse
      • ApiResponse[CreateExternalBeneficiaryData]
      • CompanyDetailsRequest
      • BankCountryResponse
      • CurrencyCode
      • IndividualDetailsResponse
      • BeneficiarySchemaCondition
      • BeneficiaryEntityType
      • RoutingCodeRequest
      • ApiResponse[BeneficiaryDetails]
      • BeneficiaryListItem
      • PaginatedApiResponse[BeneficiaryListItem]
      • StateOrProvince
      • PaginationInfo
      • PaginatedBeneficiaryFieldsResponse
      • BeneficiaryDetails
      • RoutingScheme
      • ApiResponse[ListFinancialInstitutionsResponse]
      • ListFinancialInstitutionsResponse
  • Instruction Requests
    • v2025-12-01
      • Create Payment Instruction Request
      • Create Fx Instruction Request
      • Create Fx Payment Instruction Request
      • Create Unfunded Payment Instruction Request
      • Create Unfunded Fx Payment Instruction Request
      • Get Instruction Request By Reference
    • 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
    • v2025-12-01
      • Get Instruction By Reference
    • Schemas
      • GetInstructionResponse
      • PaginatedApiResponse[InstructionListResponseItem]
      • ApiResponse[GetInstructionResponse]
      • PaginationInfo
      • ErrorResponse
      • ErrorDetail
      • PageInfo
      • InstructionListResponseItem
      • PaginationInfo
  • Foreign Exchange
    • v2025-12-01
      • Get Fx Rate
    • v2026-08-01
      • Request FX Quote
    • Schemas
      • ApiResponse[FxRateData]
      • CurrencyCode
      • FixedSide
      • FxRateRequest
      • FXValidityPeriod
      • FxRateData
      • ErrorResponse
      • ErrorDetail
      • FXTenorType
      • RequestFxQuoteRequest
      • CreateQuoteResponse
      • ApiResponse[CreateQuoteResponse]
  • Webhooks
    • v2025-12-01
      • Create Subscription
      • Update Subscription
      • Get Subscription By Id
      • Delete Subscription
      • Update Subscription Status
      • List Notification Logs
      • Retry Notification
    • Schemas
      • ApiResponse[UpdateSubscriptionResponse]
      • PaginationInfo
      • SubscriptionCreateOrUpdate
      • NotificationStatus
      • NotificationAttemptResponse
      • SubscribableWebhookEventType
      • SubscriptionStatusUpdate
      • ApiResponse[CreateSubscriptionResponse]
      • UpdateSubscriptionResponse
      • PaginatedApiResponse[NotificationLogResponse]
      • PaginationInfo
      • ErrorResponse
      • ErrorDetail
      • PageInfo
      • CreateSubscriptionResponse
      • NotificationLogResponse
      • WebhookSubscription
  • Payment Acceptance
    • Payment Acceptance
  1. Guides

Payments

This flow allows you to create a same currency payment to an external beneficiary.

Steps in Flow#

Step 1: GET Beneficiary Fields#

Retrieves the schema needed to create an external beneficiary
Endpoint: Get Beneficiary Fields

Step 2:POST Create External Beneficiary#

Creates an external beneficiary
Endpoint: Create External Beneficiary

Step 3:POST Instruction-Request Payment#

Instruct a payment from a CCA to an external beneficiary
Endpoint: Create Payment Instruction Request

Sequence Diagram#

Modified at 2026-07-31 15:13:09
Previous
FX Payments
Next
Unfunded Payments
Built with