Sokin Embedded API
  1. Payments Reference Data
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. Payments Reference Data

Transfer Reasons

Transfer Reason - Master List#

ItemIDTransfer Reason - Master ListIndividualCompany
12311DebenturesYesYes
20111Debt or Loan or Mortgages PaymentYesYes
811DonationYesYes
1088284Dividend paymentYesYes
8912EMI payments / Repayment of LoansNoYes
1088285Employee Expenses / Living AllowancesYesYes
1088286Financial ServicesYesYes
1088287Freelancer PaymentYesNo
1088288Freight Cost/ServicesYesYes
1088289Funeral ServicesYesYes
1912GiftYesYes
1111House ConstructionYesYes
1088290Import/Export of Goods/ServicesYesYes
11411InsuranceYesYes
1088292Intellectual PropertyYesYes
911InvestmentNoYes
1088293IT ServicesYesYes
1088294Legal ServicesYesYes
1088176Medical Expenses/HealthcareNoYes
6811Move abroadYesNo
12211Mutual FundYesYes
1088295Operating CostYesYes
1088296Outsourcing/ConsultancyYesYes
12611Payment for purchase of goodsYesYes
12711Payment to vendorYesYes
1088175Pension TransferYesNo
15011Pilgrimage/Religious-RelatedYesYes
1088297Property ManagementYesYes
1088298Repatriation of FundsYesYes
1088299Research and Development ServicesYesYes
14511RentYesYes
20113Sale or Purchase via InternetYesYes
1211SavingsYesYes
4913School / Education FeesNoYes
14811Send To SelfNoYes
12111SharesYesYes
15111Sharing Of Administrative ExpensesYesYes
950Social Security SystemYesYes
11311Tax PaymentNoYes
12411Trade TransactionYesYes
1011TravelYesYes
11211Utility Bill PaymentNoYes
1411Wages/SalariesYesNo

Transfer Reason - India#

ItemIDTransfer Reason - IndiaIndividualCompany
12311DebenturesYesYes
20111Debt or Loan or Mortgages PaymentYesYes
1088284Dividend paymentYesYes
8912EMI payments / Repayment of LoansNoYes
1088285Employee Expenses / Living AllowancesYesYes
1088286Financial ServicesYesYes
1088287Freelancer PaymentYesNo
1088288Freight Cost/ServicesYesYes
1088289Funeral ServicesYesYes
1912GiftYesYes
1111House ConstructionYesYes
1088290Import/Export of Goods/ServicesYesYes
11411InsuranceYesYes
1088292Intellectual PropertyYesYes
911InvestmentNoYes
1088293IT ServicesYesYes
1088294Legal ServicesYesYes
1088176Medical Expenses/HealthcareNoYes
6811Move abroadYesNo
12211Mutual FundYesYes
1088295Operating CostYesYes
1088296Outsourcing/ConsultancyYesYes
12611Payment for purchase of goodsYesYes
12711Payment to vendorYesYes
1088175Pension TransferYesNo
1088297Property ManagementYesYes
1088298Repatriation of FundsYesYes
1088299Research and Development ServicesYesYes
14511RentYesYes
20113Sale or Purchase via InternetYesYes
1211SavingsYesYes
4913School / Education FeesNoYes
14811Send To SelfNoYes
12111SharesYesYes
15111Sharing Of Administrative ExpensesYesYes
950Social Security SystemYesYes
11311Tax PaymentNoYes
12411Trade TransactionYesYes
1011TravelYesYes
11211Utility Bill PaymentNoYes
1411Wages/SalariesYesNo
Modified at 2026-02-23 08:46:45
Previous
Purpose of Payment
Next
Beneficiary Fields
Built with