1. Transfers
Framnex for Developers
  • Client Profile
    • Client
      • /Client
      • /Client/deletion-notifications
      • /Client/plan
    • Kyc
      • /Kyc/StartAction
  • Transfer Orchestrator
    • Activities
      • /Activities/{id}
      • /Activities/correlation/{id}
      • /Activities
    • BankDetailsDirectory
      • Returns the bank details known for a BIC, to complete the recipient's bank on the send-money form.
    • ClientOperations
      • Get allowed client operations
      • /ClientOperations/requestFxAccount
    • Documents
      • Downloads a document by its file name.
      • Uploads multiple documents.
      • Gets all documents for the current user.
    • Participants
      • Get payment methods available for the account, to render the participant-creation options.
      • Get required participant fields based on account
      • Get required participant fields based on account
      • /Participants
      • /Participants/get-paged
    • Transfers
      • Fetch transfers based on the specified filters.
        GET
      • Fetch transfer details by the specified transfer identifier.
        GET
      • Fetch incoming transfer details by the specified transfer identifier.
        GET
      • Create a foreign exchange transfer.
        POST
      • Fetch foreign exchange transfer details by the specified transfer identifier.
        GET
      • Create a self transfer (same-BAAS or cross-BAAS same currency).
        POST
      • Get list of available accounts to make fx transfer to (in/cross baas)
        GET
      • Get list of available accounts to make self/crossbaas transfer to
        GET
      • Create an outgoing transfer.
        POST
      • Create a mass payout - many outgoing transfers from one account, confirmed together by a single OTP. Nothing is created unless every payment can be: a request with any unusable payment is refused as a whole, listing what is wrong with each of them again
        POST
      • Fetch a mass payout of the current client by its identifier.
        GET
      • Fetch outgoing transfer details by the specified transfer identifier.
        GET
      • Check whether a confirmation document is required for an outgoing transfer with the given parameters.
        GET
      • Get the additional payment-data fields (form descriptors) required for an outgoing transfer from the given account to the given recipient over the given payment system — e.g. the UAE purpose-of-payment code, or fields configured for the account's provid
        GET
      • Get the constraints configured for the transfer's reference and purpose, so the form can apply the provider's alphabet and length limits before the payment is sent. An empty array means nothing is configured and the platform defaults apply.
        GET
  • Dfns Integration
    • AccessRecovery
      • Starts access recovery and returns the challenge the new credentials attest to, together with the encrypted recovery key stored by Dfns.
    • CredentialOperations
      • Reports how a credential ceremony ended.
    • Credentials
      • Lists the keys and devices of the client, together with whether an active recovery key exists.
      • Starts issuing a credential and returns what the client needs to generate it.
      • Hands over the generated credential and creates the confirmation authorizing its registration.
      • Starts revoking a credential and creates the confirmation authorizing it.
    • CustodialKey
      • Starts issuing the custodial key and creates the confirmation authorizing it.
    • Devices
      • Starts adding a device and creates the confirmation authorizing the one-time code.
      • Exchanges the one-time code for the challenge the new device's passkey attests to.
      • Registers the passkey the new device produced, which ends the ceremony.
    • Gas
      • Tells whether a crypto account can pay the network's coin one transfer needs, and what to tell a person when it cannot.
  • Accounts
    • Accounts
      • /Accounts/{id}
      • /Accounts/{id}
      • /Accounts/{id}
      • /Accounts/{id}/incoming-requisites
      • /Accounts
      • /Accounts
      • /Accounts/{id}/get-commission-strategies
      • /Accounts/reorder-accounts
      • /Accounts/request-account
    • Currencies
      • /Currencies
      • /Currencies/available-for-open
    • Settings
      • /Settings
  • Cards
    • Cards
      • Returns the caller's configured card routes and their required KYC status.
      • Issues an allowed provider/currency card for the calling client.
      • Returns a page of the caller's own cards.
      • Returns one of the caller's own cards.
      • Returns the accounts one of the caller's own cards draws on.
      • /Cards/{cardId}/freeze
      • /Cards/{cardId}/unfreeze
      • Prepares a provider-defined encrypted session for one of the caller's cards.
      • Relays an opaque encrypted-session exchange for one of the caller's cards.
  • Confirmations
    • Challenges
      • /Challenges/{id}
      • /Challenges/{id}/retry
      • /Challenges/{id}/confirm
      • /Challenges/{id}/cancel
  • Reporter
    • Reports
      • Generates an account statement report.
      • Generates an account confirmation report.
      • Generates a transfer statement report.
      • Gets the overall balance across all client accounts, converted to EUR, GBP, and USD.
  • Merchant
    • PaymentSession
      • /frontoffice/payment-session/{id}
      • /frontoffice/payment-session/pay
      • /frontoffice/payment-session/{id}/cancel
    • Transfer
      • /frontoffice/transfer/{transferId}
  • Onboarding Lite
    • Onboarding
      • Returns an applicant's profile. If it doesn't exist, the system reads info from SSO and creates it.
      • Set profile type for user
      • /frontoffice/onboarding/GetAvailableProfileTypes
    • Sumsub
      • Generates applicant's verification flow token for WebSDK access.
  • Fee
    • Card
      • /Card/issuance-fee
    • Transfers
      • Method returns fee for transfers in transfer’s currency for front-office
  • Exchange
    • Transactions
      • Starts monitoring fx rate and returns actual value. How much of the quote currency is needed to buy 1 unit of the base currency
  • Schemas
    • Client Profile
      • AddressDto
      • BeneficiaryType
      • BusinessPartnerDto
      • ClientCompanyDto
      • ClientDto
      • ClientDtoResult
      • ClientIndividualDto
      • ClientState
      • ClientType
      • CompanyType
      • ComplianceEvaluationDto
      • CountriesGroup
      • CustomerType
      • DocumentSide
      • DocumentType
      • EmployeeCount
      • FundFlowsDto
      • HighRiskActivity
      • IError
      • IReason
      • ISuccess
      • IdentificationDocumentDto
      • IdentificationDocumentType
      • Industry
      • KycBlockDto
      • KycBlockStatus
      • PurposeAccountOpening
      • RelatedIndividualInfoDto
      • Result
      • SourceOfFunds
      • StartActionDto
      • TariffPlan
      • Turnover
      • TurnoverUsd
      • UploadedDocumentDto
      • UploadedDocumentFileDto
    • Transfer Orchestrator
      • AccountType
      • AchCredentials
      • Address
      • ApplePayCredentials
      • BankDetails
      • BankDetailsByBicDto
      • BizumCredentials
      • BlikCredentials
      • BlockchainNetworkCode
      • BunqCredentials
      • BusinessEntity
      • CardCredentials
      • CardMerchantCredentials
      • CardNetwork
      • CardPayOutActivityDto
      • CardPaymentInfo
      • CardProvider
      • CardholderType
      • CoinsPaidCredentials
      • CreateParticipantDto
      • Credentials
      • CryptoCredentials
      • CryptoCurrencyResponseDto
      • CryptoTransferDetails
      • CurrencyResponseDto
      • CustomerFxTransferDto
      • CustomerIncomingTransferDto
      • CustomerOutgoingTransferDto
      • CustomerTransferBatchDto
      • CustomerTransferBatchItemDto
      • CustomerTransferDto
      • CustomerTransferDtoPagedDataDto
      • CustomerTransferStateDto
      • DocumentDto
      • ErrorDetailsDto
      • ExchangeTransferActivityDto
      • FasterUkCredentials
      • FedWireCredentials
      • FeeAllocationDto
      • FiatCurrencyResponseDto
      • FieldCondition
      • FieldInfo
      • FieldType
      • FieldValueFormatter
      • FieldValueInfo
      • FxAccountType
      • FxBaseAccountDto
      • FxBuyAccountDto
      • FxOpenAccountDto
      • FxRequestAccountDto
      • FxTransferParamsDto
      • GasPaymentActivityDto
      • GasPaymentInfoDto
      • GetUsedParticipantsDto
      • GooglePayCredentials
      • IActivityDto
      • IActivityDtoPagedDataDto
      • IncomingTransferActivityDto
      • IndividualEntity
      • InternalCredentials
      • LegalEntity
      • LegalEntityType
      • LocalAEDCredentials
      • LocalXafCredentials
      • MBWayCredentials
      • MidpointRounding
      • MultibancoCredentials
      • N26Credentials
      • NeftCredentials
      • NetellerCredentials
      • OpenBankingCredentials
      • OperationTypeDto
      • OutgoingBatchPaymentDto
      • OutgoingDocumentRequirementDto
      • OutgoingTransferActivityDto
      • OutgoingTransferBatchParamsDto
      • OutgoingTransferDocumentDto
      • OutgoingTransferParamsDto
      • PageInfoDto
      • PagedFilterDto
      • Participant
      • ParticipantDto
      • ParticipantPagedDataDto
      • PaymentSystem
      • PaysafecardCredentials
      • PixCredentials
      • ProblemDetails
      • Przelewy24Credentials
      • RequestFxAccountDto
      • RevolutCredentials
      • SelfAccountType
      • SelfBaseAccountDto
      • SelfBuyAccountDto
      • SelfRequestAccountDto
      • SelfTransferActivityDto
      • SelfTransferParamsDto
      • SepaCredentials
      • SkrillCredentials
      • SortDto
      • SortOrderDto
      • SwiftCredentials
      • TedPayCredentials
      • TransferBatchDraftedDto
      • TransferBatchDraftedItemDto
      • TransferDetails
      • TransferDraftedDto
      • TransferOperationDetailsDto
      • TransferSideDto
      • TransferTypeDto
      • UaeFtsCredentials
      • UaeIppCredentials
      • ValidationProblemDetails
      • WiseCredentials
      • YeePayKesLocalCredentials
      • YeePayMxnLocalCredentials
      • YeePayNgnLocalCredentials
    • Dfns Integration
      • AccessRecoveryChallengeDto
      • ClientCredentialDeviceDto
      • ClientCredentialDto
      • ClientCredentialKind
      • ClientCredentialOperationStatus
      • ClientCredentialPurpose
      • ClientCredentialStatus
      • ClientCredentialsDto
      • CredentialCreationAuthenticatorSelectionDto
      • CredentialCreationChallengeDto
      • CredentialCreationParamDto
      • CredentialCreationUserDto
      • CredentialOperationConfirmationDto
      • CredentialOperationStatusDto
      • EndUserDeviceMetadata
      • GasRequirementDto
      • GasTransferType
      • IssueCredentialRequest
      • PasskeyCreationChallengeDto
      • PasswordProtectedKeyCreationChallengeDto
      • PresentDeviceCodeRequest
      • RecoveryKeyCreationChallengeDto
      • RegisterCredentialRequest
      • RegisterDeviceCredentialRequest
      • RegisterDevicePasskeyRequest
      • RegisterDevicePasswordProtectedKeyRequest
      • RegisterPasskeyRequest
      • RegisterPasswordProtectedKeyRequest
      • RegisterRecoveryKeyRequest
      • UniversalCreationChallengeDto
    • Accounts
      • AccountDraftedDto
      • BankAccountFrontOfficeDto
      • BankAccountState
      • CommissionStrategy
      • CreateAccountDto
      • FrontOfficeAvailableCurrenciesDto
      • FrontOfficeAvailableCurrencyDto
      • FrontOfficeBankCurrencyDto
      • FrontOfficeOpenCurrencyDto
      • FrontOfficeRequestableCurrencyDto
      • FrontOfficeSettingsDto
      • IncomingRequisitesChannel
      • IncomingRequisitesDto
      • IncomingRequisitesGroupDto
      • IncomingRequisitesItemDto
      • IncomingRequisitesItemKind
      • IncomingRequisitesPaymentMethodDto
      • ParticipantLegalEntityType
      • RenameBankAccountDto
      • ReorderAccountsFrontOfficeDto
      • RequestAccountDto
      • SettlementInstructionsDto
    • Cards
      • AvailableCardDto
      • AvailableCardsDto
      • CardAccountDto
      • CardStatus
      • CardType
      • ClientCardDto
      • ClientCardDtoPagedDataDto
      • ClientCardsFilterDto
      • CreateEncryptedEnvelopeRequest
      • CreateEncryptedEnvelopeResponse
      • GetEncryptedCardDetailRequest
      • GetEncryptedCardDetailResponse
      • IssueOwnCardRequestDto
    • Confirmations
      • AccessRecoveryChallenge
      • AccessRecoveryChallengeDataDto
      • AccessRecoveryConfirm
      • AccessRecoveryConfirmation
      • AllowedCredential
      • ChallengeConfirm
      • ChallengeConfirmType
      • ChallengeDataDto
      • ChallengeDataType
      • ChallengeDto
      • ChallengeState
      • ConfirmResult
      • ConfirmResultOperationResult
      • CredentialCreationChallenge
      • CredentialCreationChallengeDataDto
      • CredentialCreationConfirm
      • CredentialRegistrationConfirmation
      • CredentialToRegisterKind
      • EmailChannelInfoDto
      • EmptyResult
      • EndUserCredentialToRegister
      • EndUserSignature
      • EndUserSignatureKind
      • KeyPairAllowedCredential
      • KeyPairCredentialToRegister
      • KeyPairSignature
      • NotificationChannel
      • OperationAssertionChallenge
      • OperationAssertionChallengeDataDto
      • OperationAssertionConfirm
      • OperationAssertionConfirmation
      • OtpChallengeConfirm
      • OtpChallengeDataDto
      • OtpChannelInfoDto
      • OtpState
      • PasswordProtectedKeyAllowedCredential
      • PasswordProtectedKeyCredentialToRegister
      • PasswordProtectedKeySignature
      • RecoveryCredentialToRegister
      • RecoveryKeySignature
      • RetryResult
      • RetryResultOperationResult
      • SmsChannelInfoDto
      • WebAuthnAllowedCredential
      • WebAuthnCoseAlgorithm
      • WebAuthnCredentialToRegister
      • WebAuthnPublicKeyCredentialParam
      • WebAuthnPublicKeyCredentialType
      • WebAuthnSignature
      • WebAuthnState
    • Reporter
      • CurrencyBalanceDto
      • OverallBalanceDto
      • ReportFormat
      • StatusCodeResult
    • Merchant
      • Currency
      • ExtendedPaymentSessionDto
      • InternalServerError
      • KeyValueDto
      • MakePaymentDto
      • PaymentSessionState
      • PayoutDto
      • PayoutState
      • TransferInfoDto
    • Onboarding Lite
      • ApplicantStatus
      • ProfileDto
      • ProfileType
      • ProfileTypeListResult
    • Fee
      • BaasProvider
      • CardIssuanceFeeDto
      • GetTransferTariffDto
      • TransferFeeDto
      • ValidationErrorInfo
    • Exchange
GuidesBaaS API ReferenceBank Client API ReferenceFrontOffice API Reference
GuidesBaaS API ReferenceBank Client API ReferenceFrontOffice API Reference
  1. Transfers

Create a mass payout - many outgoing transfers from one account, confirmed together by a single OTP. Nothing is created unless every payment can be: a request with any unusable payment is refused as a whole, listing what is wrong with each of them again

POST
/Transfers/outgoing/batch

Request

Body Params application/json

Example
{
    "senderAccountId": "4e468f86-26dc-4a94-b56b-b06297a94aed",
    "system": "sepa",
    "feeAllocation": "our",
    "payments": [
        {
            "recipient": {
                "credentials": {
                    "paymentMethod": "sepa",
                    "bankDetails": {
                        "bankName": "string",
                        "bankCountry": "string",
                        "bankRegion": "string",
                        "bankAddress": "string",
                        "bic": "string",
                        "intermediaryBic": "string",
                        "bankCode": "string",
                        "routingNumber": "string",
                        "sortCode": "string",
                        "branchCode": "string"
                    },
                    "iban": "string",
                    "reference": "string",
                    "$": "sepa"
                },
                "legalEntity": {
                    "type": "business",
                    "address": {
                        "country": "string",
                        "postalCode": "string",
                        "city": "string",
                        "state": "string",
                        "street": "string"
                    },
                    "businessType": "string",
                    "businessDetails": [
                        "string"
                    ],
                    "mobile": "string",
                    "idNumber": "string",
                    "companyName": "string",
                    "$": "business"
                }
            },
            "sendingAmount": 0,
            "reference": "string",
            "purposes": {
                "property1": "string",
                "property2": "string"
            },
            "purpose": "string",
            "documents": [
                "string"
            ]
        }
    ]
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/Transfers/outgoing/batch' \
--header 'Content-Type: application/json' \
--data '{
    "senderAccountId": "4e468f86-26dc-4a94-b56b-b06297a94aed",
    "system": "sepa",
    "feeAllocation": "our",
    "payments": [
        {
            "recipient": {
                "credentials": {
                    "paymentMethod": "sepa",
                    "bankDetails": {
                        "bankName": "string",
                        "bankCountry": "string",
                        "bankRegion": "string",
                        "bankAddress": "string",
                        "bic": "string",
                        "intermediaryBic": "string",
                        "bankCode": "string",
                        "routingNumber": "string",
                        "sortCode": "string",
                        "branchCode": "string"
                    },
                    "iban": "string",
                    "reference": "string",
                    "$": "sepa"
                },
                "legalEntity": {
                    "type": "business",
                    "address": {
                        "country": "string",
                        "postalCode": "string",
                        "city": "string",
                        "state": "string",
                        "street": "string"
                    },
                    "businessType": "string",
                    "businessDetails": [
                        "string"
                    ],
                    "mobile": "string",
                    "idNumber": "string",
                    "companyName": "string",
                    "$": "business"
                }
            },
            "sendingAmount": 0,
            "reference": "string",
            "purposes": {
                "property1": "string",
                "property2": "string"
            },
            "purpose": "string",
            "documents": [
                "string"
            ]
        }
    ]
}'

Responses

🟢200
application/json
Request has been successfully completed.
Bodyapplication/json

Example
{
    "batchId": "5579c111-9c50-47e2-af92-f16d52e63189",
    "challengeId": "007cfdcc-a46d-4340-a4c6-216ec2e4009c",
    "currency": "string",
    "totalAmount": 0,
    "totalFee": 0,
    "payments": [
        {
            "index": 0,
            "transferId": "e240f72a-b0bc-4f57-ab86-5b78f1d8ea9b",
            "amount": 0,
            "fee": 0
        }
    ]
}
🟠400
🟠403
🟠404
🟠422
🔴500
Modified at 2026-10-29 19:39:20
Previous
Create an outgoing transfer.
Next
Fetch a mass payout of the current client by its identifier.
Built with