FinLego for developers
  1. Payments
FinLego for developers
  • FinLego Core Banking
    • Services REST API
      • ClientProfile - FrontOffice
        • Client
          • /Client
          • /Client/deletion-notifications
          • /Client/plan
      • ClientProfile - System
        • Clients
          • /internal/Clients
          • /internal/Clients
          • /internal/Clients/{clientId}/block
          • /internal/Clients/{clientId}/unblock
          • /internal/Clients/{clientId}
          • /internal/Clients/{clientId}
          • /internal/Clients/{clientId}/status
        • Documents
          • /internal/Clients/{clientId}/Documents/upload
          • /internal/Clients/{clientId}/Documents/upload/bulk
          • /internal/Clients/{clientId}/Documents/{documentId}/download
          • /internal/Clients/{clientId}/Documents
          • /internal/Clients/{clientId}/Documents/{documentId}
        • RelatedIndividualsDocuments
          • /internal/Clients/{clientId}/related-individuals/{relatedIndividualId}/documents
          • /internal/Clients/{clientId}/related-individuals/{relatedIndividualId}/documents/upload
          • /internal/Clients/{clientId}/related-individuals/{relatedIndividualId}/documents/{documentId}/download
      • GeneralLedger - System (1)
        • Accounts
          • /Accounts
          • /v2/internal/Accounts
          • /Accounts
          • /v2/internal/Accounts/recalculate
          • /Accounts/{id}
          • /internal/Accounts/calculateBalances
          • /Accounts/{id}
          • /v2/ledger/internal/Accounts/{accountId}
          • /Accounts/{id}
          • /v2/ledger/internal/Accounts/search
          • /Accounts/send-otp
          • /v2/ledger/internal/Accounts/by-account-numbers
          • /Accounts/otp-verification
          • /v2/ledger/internal/Accounts/getAggregatedAmounts
          • /Accounts/{accountNumber}
          • /Accounts/reorder-accounts
        • Transactions
          • Transactions by filter
          • /internal/Transactions/{id}
          • /internal/Transactions
          • /internal/Transactions/query
          • /internal/Transactions/report
        • BaasProvider
          • /BaasProvider/available-currencies
        • BackgroundJob
          • /internal/BackgroundJob/AccountBalanceCheckJob
        • DailyAccountBalance
          • /internal/DailyAccountBalance
          • /internal/DailyAccountBalance/recalculate
        • DailyCheck
          • /internal/DailyCheck
          • /internal/DailyCheck/details
        • Reports
          • /internal/Reports/ReconciliationReport
        • TreasuryManagement
          • /internal/TreasuryManagement/summary
        • Payments
          • Creates payment with single transaction and transfers money between accounts
            POST
          • Creates payment in Draft state without any money transfers
            POST
          • Pends payment and holds funds in case of withdrawals
            POST
          • Pends payments and holds funds in case of withdrawals
            POST
          • Posts payment, withdraws held funds and deposits it to corresponding account
            POST
          • Posts payments, withdraws held funds and deposits it to corresponding account
            POST
          • Cancels payment and performs payback in case of held
            POST
          • Cancels payments and performs payback in case of held
            POST
        • Currencies
          • /internal/Currencies
          • /internal/Currencies
          • /internal/Currencies/{code}
          • /internal/Currencies/{code}
      • GeneralLedger - System (2)
        • Accounts
          • /v2/internal/Accounts
          • /v2/internal/Accounts/recalculate
          • /internal/Accounts/calculateBalances
          • /v2/ledger/internal/Accounts/{accountId}
          • /v2/ledger/internal/Accounts
          • /v2/ledger/internal/Accounts/getAggregatedAmounts
        • Payments
          • Creates payment with single transaction and transfers money between accounts
          • Creates payment in Draft state without any money transfers
          • Pends payment and holds funds in case of withdrawals
          • Posts payment, withdraws held funds and deposits it to corresponding account
          • Cancels payment and performs payback in case of held
      • TransferOrchestrator - FrontOffice
        • Confirmations
          • Generate a new confirmation code for the specified transfer.
        • Documents
          • Downloads a document by its file name.
        • Recipients
          • Fetch recipients based on the specified filters.
          • Fetch recipients based on the specified filters.
          • Add a recipient.
          • Fetch recipient details by the specified recipient identifier.
          • Fetch recipient details by the specified recipient identifier.
          • Update the visibility details of a recipient.
        • Transfers
          • Fetch transfers based on the specified filters.
          • Fetch transfers based on the specified filters.
          • Fetch transfer details by the specified transfer identifier.
          • Fetch transfer details by the specified transfer identifier.
          • Create an outgoing transfer.
          • Fetch outgoing transfer details by the specified transfer identifier.
          • Confirm an outgoing transfer.
          • Fetch incoming transfer details by the specified transfer identifier.
          • Cancel an outgoing transfer by the transfer identifier.
          • Fetch foreign exchange transfer details by the specified transfer identifier.
          • Fetch outgoing transfer details by the specified transfer identifier.
          • Fetch incoming transfer details by the specified transfer identifier.
          • Create a foreign exchange transfer.
          • Confirm an outgoing transfer.
          • Cancel an outgoing transfer by the transfer identifier.
          • Fetch foreign exchange transfer details by the specified transfer identifier.
          • Fetch a transfer type by recipient account and currency.
      • TransferOrchestrator - System (1)
        • Documents
          • Downloads a document by its file name and client identifier.
        • IncomingRequests
          • Fetch internal requests based on the specified filters.
          • process a transfer manually.
        • Recipients
          • Add a recipient.
        • Transfers
          • Fetch internal transfers based on the specified filters.
          • Fetch outgoing transfer details by the specified transfer identifier.
          • Fetch incoming transfer details by the specified transfer identifier.
          • Assign an unrecognized incoming transfer.
          • Fetch foreign exchange transfer details by the specified transfer identifier.
          • Execute a transfer manually.
          • Continue processing of an outgoing transfer.
          • Fetch outgoing transfers based on the specified filters.
          • Fetch incoming transfers based on the specified filters.
          • Fetch foreign exchange transfers based on the specified filters.
      • TransferOrchestrator - System (2)
        • Recipients
          • Add a system recipient.
        • Transfers
          • /internal/integration/Transfers/outgoing
          • /internal/integration/Transfers/outgoing/payment-request
  • Onboarding Integration
    • ClientsImport
      • Imports a new individual client from an integrated WL customer's onboarding system
      • Imports a new company client from an integrated WL customer's onboarding system
    • SumsubWebhooks
      • /integration/sumsub-webhooks/update-state
      • Simulates a verification response.
  1. Payments

Pends payments and holds funds in case of withdrawals

POST
/internal/Payments/pend

Request

Body Params application/json

Example
{
    "paymentIds": [
        "497f6eca-6276-4993-bfeb-53cbbbba6f08"
    ],
    "parentId": "70850378-7d3c-4f45-91b7-942d4dfbbd43",
    "limitedIncomingAccountRestrictions": [
        {
            "accountId": "3d07c219-0a88-45be-9cfc-91e9d095a1e9",
            "limit": 0
        }
    ]
}

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 --request POST '/internal/Payments/pend' \
--header 'Content-Type: application/json' \
--data-raw '{
    "paymentIds": [
        "497f6eca-6276-4993-bfeb-53cbbbba6f08"
    ],
    "parentId": "70850378-7d3c-4f45-91b7-942d4dfbbd43",
    "limitedIncomingAccountRestrictions": [
        {
            "accountId": "3d07c219-0a88-45be-9cfc-91e9d095a1e9",
            "limit": 0
        }
    ]
}'

Responses

🟢200OK
application/json
OK
Body

Example
{
    "payments": [
        {
            "paymentId": "472e651e-5a1e-424d-8098-23858bf03ad7",
            "parentId": "70850378-7d3c-4f45-91b7-942d4dfbbd43",
            "obligatoryDate": "2019-08-24T14:15:22Z",
            "parentType": "transfer",
            "transactions": [
                {
                    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
                    "paymentId": "472e651e-5a1e-424d-8098-23858bf03ad7",
                    "parentId": "70850378-7d3c-4f45-91b7-942d4dfbbd43",
                    "parentType": "transfer",
                    "debtorAccountId": "d9695c4c-f4a8-4c4e-b1b1-0b2201504693",
                    "debtorAccountNumber": "string",
                    "creditorAccountId": "0411bd28-c6c2-4498-8a47-b18d967449d7",
                    "creditorAccountNumber": "string",
                    "currency": "string",
                    "amount": 0,
                    "state": "draft",
                    "stateReason": "string",
                    "createdDate": "2019-08-24T14:15:22Z",
                    "postedDate": "2019-08-24T14:15:22Z",
                    "stateChanges": [
                        {
                            "paymentId": "472e651e-5a1e-424d-8098-23858bf03ad7",
                            "from": "draft",
                            "to": "draft",
                            "timestamp": "2019-08-24T14:15:22Z"
                        }
                    ]
                }
            ]
        }
    ]
}
🟠400Bad Request
🟠404Record Not Found
🟠422Parameter Error
🔴500Server Error
Modified at 2025-07-24 15:52:29
Previous
Pends payment and holds funds in case of withdrawals
Next
Posts payment, withdraws held funds and deposits it to corresponding account
Built with