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

Purpose of Payment

China#

CodeDescription
CTFCross-border capital transfer
GODCross-border goods trade
STRCross-border service transfer
RMTCross-border individual remittance
OTFOther transfers

UAE#

CodeDescription
ACMAgency Commission
AESAdvance Payment Against EOS
AFAReceipts Or Payments From Personal Residents Bank Account Or Deposits Abroad
AFLReceipts Or Payments From Personal N-Resident Bank Account In The UAE
ALWAllowance
ATSAir Transport
BONBonus
CCPCorporate Card Payments
CEAEquity For Establishment Of New Company From Residents Abroad Equity Of Merger Or Acquisition Of Companies Abroad From Residents And Participation To Capital Increase Of Related Company Abroad
CELEquity For Establishment Of New Company In UAE From Non-Residents Equity Of Merger Or Acquisition Of Companies In The UAE From Non-Residents Participation To Capital Increase Of Related
CHCCharitable Contributions
CINCommercial Investments
COMCommission
COPCompensation
DCPPre-Paid Reloadable Personalized Debit Card Payments
DIFDebt Instruments Intragroup Loans Securities Deposits Foreign
DILDebt Instruments Intragroup Loans Securities Deposits In The UAE
DIVDividend Payouts
DLLTrading Of Securities Issued By Residents More Than Year In The Company
DLATrading Of Foreign Debt Security More Than Year In The Related Company
DOEDividends On Equity Not Intra Group
DSAPurchases And Sales Of Foreign Debt Securities Less Than Year In The Related Company
DSLPurchases And Sales Of Securities Issued By Residents Less Than Year In The Related Companies
EDUEducational Support
EMIEquated Monthly Installments
EOSEnd Of Service/Final Settlement
FDAFinancial Derivatives Foreign
FDLFinancial Derivatives In The UAE
FIAInvestment Fund Shares Foreign
FILInvestment Fund Shares In The UAE
FISFinancial Services
FSAEquity Other Than Investment Fund Shares In The Related Companies Abroad
FSLEquity Other Than Investment Fund Shares In The Related Companies In The UAE
GDSGoods Bought Or Sold
GMSProcessing Repair And Maintenance Services On Goods
GOSGovernment Goods And Services Embassies Etc
GRIGovernment Related Income Taxes Tariffs Capital Transfers Etc
IIDIntra Group Interest On Debt
IGDIntra Group Dividends
INSInsurance Services
IODIncome On Deposits
IOLIncome On Loans
IPCCharges For The Use Of Intellectual Property Royalties
IPOIPO Subscriptions
ISHIncome On Investment Funds Shares
ISLInterest On Securities More Than A Year
ISSInterest On Securities Less Than A Year
ITSComputer Services
LASLeave Salary
LEALeasing Abroad
LELLeasing In The UAE
LIPLoan Interest Payments
LLALoans-Drawings Or Repayments On Loans Extended To Non-Residents — Long Term
LLLDrawings Or Repayments On Foreign Loans To Residents — Long Term
LNCLoan Charges
LNDLoan Disbursements
MCRMonetary Claim Reimbursement
OTSOther Modes Of Transport
OVTOvertime
PENPension
PIPProfits On Islamic Products
PMSProfessional And Management Consulting Services
PORRefunds/Reversals On IPO Subscriptions
POSPOS Merchant Settlement
PPAPurchase Of Real Estate Abroad From Residents
PPLPurchase Of Real Estate In The UAE From Non-Residents
PRRProfits Or Rents On Real Estate
PRSPersonal Cultural Audio Visual And Recreational Services
RDSResearch And Development Services
RFSRepos On Foreign Securities
RLSRepos On Securities Issued By Residents
RNTRent Payments
SAASalary Advance
SALSalary
SCOConstruction
SLALoans-Drawings Or Repayments On Loans Extended To Non-Residents — Short Term
SLLLoans-Drawings Or Re-Payments On Foreign Loans Extended To Residents — Short Term
STRTravel
STSSea Transport
TCSTelecommunication Services
TCPTrade Credits And Advances Payable
TCRTrade Credits And Advances Receivable
TKTTickets
TTSTechnical Trade Related And Other Business Services
UTLUtility Bill Payments

EFT#

IDName
922763Access Grants
23084Accounts Payable
23027Adjustment Payroll
23024Advance Payroll
107950Agreement Revoked – Business
922745Agri Stabilization
922746AgriInvest
23032Annuity
23071Appliance Rent/Leases
23043Auto Insurance
922765Auto Payment
922767Automobile Insurance Plan
23070Automobile Rent/Leases
23073Bill Payment
922766Bill Payment Error Correction
23026Bonus Payroll
23096Business PAD
23077Cable Bill Payment
922748Canada Child Benefit
23072Cash Management
23045Casualty Insurance
922755CF Superannuation
922775Children Assistance
24714Clearing Items
23092Combined Fed-Prov Payment
107931Commercial Accounts Payable
107905Commercial Auto Insurance
107929Commercial Auto Payment
107918Commercial Automobile Rent/Lease
107920Commercial Bill Payment
107924Commercial Cable Bill Payment
107919Commercial Cash Management
107907Commercial Casualty Insurance
922777Commercial Creditor Insurance
107917Commercial Equipment Rent/Lease
107930Commercial Expense Payment
107932Commercial Fees/Dues
107925Commercial Fuel Bill Payment
107922Commercial Gasoline Bill Payment
107914Commercial GST
107923Commercial Hydro Bill Payment
107912Commercial Income Taxes
107904Commercial Insurance
107927Commercial Internet Bill Payment
107903Commercial Investments
107909Commercial Loans
23057Commercial Mortgage
107910Commercial Mortgage
107908Commercial Mortgage Insurance
107906Commercial Property Insurance
107915Commercial Property Taxes
107916Commercial Rent/Lease
23068Commercial Rent/Leases
107913Commercial Sales Taxes
107911Commercial Taxes
107921Commercial Telephone Bill Payment
107926Commercial Utility Bill Payment
107928Commercial Water Bill Payment
23025Commission Payroll
23034Common Dividend
23062Corporate Taxes
922750CPP
922760CSB Interest
23082Customer Cheques
107952Customer Initiated Return
23050Dealer Plan Loans
922770Disability Payment
23033Dividend
23086Donations
922757EI
23094Employment Assistance
23069Equipment Rent/Leases
23083Expense Payment
922761External Affairs
23088Family Support Plan
23051Farm Improvement Loans
23058Farm Mortgage
922744Federal Payment
23029Federal Pension
23085Fees/Dues
23078Fuel Bill Payment
23075Gasoline Bill Payment
922773Grant/Bursary
922749GST
922768Health Care Premium
23047Health/Dental Claim Insurance
23052Home Improvement Loans
23089Housing Allowance
922747HRDC – Training
23076Hydro Bill Payment
23090Income Security Benefits
23060Income Taxes
23041Insurance
23054Insurance Loans
23040Interest
23095Inter-FI Funds Debit
23080Internet Access Payment
23036Investment
23042Life Insurance
23048Loans
922743Lottery Prize Payment
23081Miscellaneous Payment
23055Mortgage
23046Mortgage Insurance
23037Mutual Funds
107945No Agreement Existed
107951No Confirmation/Pre-Notification – Business
107949Not According to Agreement - Business
107934NSF (Debit Only)
922769Offences and Fines
922751Old Age Security
23023Overtime Payroll
922758PAD CCRA
922771Parental Insurance
23020Payroll Deposit
23028Pension
23049Personal Loans
23035Preferred Dividend
23031Private Pension
23044Property Insurance
23064Property Taxes
23091Provincial Family Benefits
23087Provincial Government
23030Provincial Pension
922754PS Superannuation
922742RDSP Contribution
23066Rent/Leases
23056Residential Mortgage
23067Residential Rent/Leases
922740RESP Contribution
23039Retirement Income Fund
23038RSP Contribution
23061Sales Taxes
922762Savings Plan
23063School Taxes
922774Solidarity Tax Credit
23021Special Payroll
922739Spousal RSP Contribution
922759Student Loan
922772Student Loan
922741Tax Free Savings Account
922756Tax Refund
922776Tax Refund
23059Taxes
23074Telephone Bill Payment
23053Term Loans
23079Utility Bill Payment
922753VAC
23022Vacation Payroll
922752War Veterans’ Allow
922764Water Bill Payment
23065Water Taxes
23093Worker’s Compensation Board
Modified at 2026-02-23 08:48:12
Previous
Supported Jurisdictions & National ID Requirements
Next
Transfer Reasons
Built with