1. Guides
Framnex for Developers
  • Introduction
    • Overview
    • Quick Start
    • Authentication
    • Environments
  • Guides
    • Onboard a client
    • Open an account
    • Create an outgoing transfer
    • Handle webhooks
  • Accounts
    • Opens a new account for a client
      POST
    • Returns the paged list of accounts, optionally filtered by client
      GET
    • Returns an account by its identifier
      GET
  • Auth
    • Exchanges integrator client credentials for an access token.
      POST
  • Clients
    • Onboards a client using the JSON fields returned by the client creation fields endpoint.
      POST
    • Returns the paged list of clients, optionally filtered
      GET
    • Returns the OpenAPI 3.0 creation schema for the authenticated brand and requested type.
      GET
    • Returns a client by its identifier
      GET
    • Returns the current client onboarding or profile state
      GET
  • ExchangeRates
    • Returns the exchange rate between the sell and buy accounts
      GET
  • Transfers
    • Creates a new outgoing transfer
      POST
    • Returns the paged list of transfers, filtered by the provided filter
      GET
    • Returns a transfer by its identifier
      GET
  • Webhooks
    • Registers (or replaces) the URL webhooks are delivered to for the integrator
      POST
    • Returns the currently registered webhook URL for the integrator
      GET
    • Returns the paged list of webhook deliveries, filtered by the provided filter
      GET
    • Returns a webhook delivery by its identifier
      GET
    • Re-queues a failed webhook delivery for another attempt
      POST
  • IncomingTransfers
    • Creates (simulates) an incoming transfer
  • TransferDocuments
    • Downloads a document by its file name.
    • Gets all documents
    • Uploads multiple documents.
  • Schemas
    • BaaS API
      • Account
      • AccountCredentials
      • AccountOpenedWebhookPayload
      • AccountOpeningFailedWebhookPayload
      • AccountPagedDataDto
      • AccountState
      • AccountType
      • AchCredentials
      • Address
      • AuthTokenRequest
      • AuthTokenResponse
      • BankDetails
      • BusinessClient
      • BusinessEntity
      • Client
      • CreateBusinessClientRequest
      • ClientCreateType
      • CreateClientRequest
      • ClientCreatedResponse
      • ClientPagedDataDto
      • CreateIndividualClientRequest
      • ClientState
      • ClientStateResponse
      • ClientType
      • ClientsFilter
      • CreateAccountRequest
      • CreateExchangeTransferRequest
      • CreateIncomingTransferRequest
      • CreateOutgoingTransferRequest
      • CredentialsState
      • CreateTransferRequest
      • ErrorDetailsDto
      • ExchangeRate
      • CreateTransferType
      • CreatedResponse
      • Credentials
      • CredentialsIssueFailedWebhookPayload
      • CredentialsIssuedWebhookPayload
      • ExchangeTransferProcessingWebhookPayload
      • CryptoCredentials
      • IError
      • CryptoTransferDetails
      • IReason
      • DocumentDto
      • ISuccess
      • IdentificationDocument
      • ExchangeTransfer
      • IdentificationDocumentType
      • ExchangeTransferCancelledWebhookPayload
      • ExchangeTransferExecutedWebhookPayload
      • FasterUkCredentials
      • FedWireCredentials
      • ForeignTransferParty
      • GasPaymentWebhookPayload
      • IncomingTransfer
      • IncomingTransferReceivedWebhookPayload
      • OutgoingTransferProcessingWebhookPayload
      • IndividualClient
      • IndividualEntity
      • PageInfoDto
      • InternalCredentials
      • Participant
      • LegalEntity
      • LegalEntityType
      • LocalAEDCredentials
      • ProblemDetails
      • LocalXafCredentials
      • NeftCredentials
      • Result
      • OnboardingCompletedWebhookPayload
      • RiskLevel
      • OnboardingFailedWebhookPayload
      • OutgoingTransfer
      • SortOrderDto
      • OutgoingTransferCancelledWebhookPayload
      • OutgoingTransferExecutedWebhookPayload
      • TransferPagedDataDto
      • PagedFilterDto
      • PaymentMethod
      • TransfersFilter
      • PixCredentials
      • RegisterWebhookRequest
      • ValidationProblemDetails
      • WebhookDelivery
      • WebhookDeliveryPagedDataDto
      • SepaCredentials
      • SortDto
      • WebhookSubscription
      • SwiftCredentials
      • TedPayCredentials
      • WebhooksFilter
      • Transfer
      • TransferDetails
      • TransferDetailsType
      • TransferGas
      • TransferState
      • TransferType
      • UaeFtsCredentials
      • UaeIppCredentials
      • WebhookPayload
      • WebhookState
      • WebhookType
      • YeePayKesLocalCredentials
      • YeePayMxnLocalCredentials
      • YeePayNgnLocalCredentials
GuidesBaaS API Reference
Bank Client API Reference
GuidesBaaS API Reference
Bank Client API Reference
  1. Guides

Handle webhooks

Use webhooks to process asynchronous changes in BaaS flows such as client onboarding, account opening, and transfer processing.

1. Register the webhook URL#

Register, or replace, the URL that Framnex uses for webhook deliveries:
Register the webhook URL
Configure the webhook URL separately for each environment.

2. Confirm the current registration#

Read the currently registered webhook URL when you need to verify the active configuration:
Get the registered webhook URL

3. Process deliveries#

Webhook events report asynchronous changes. Your integration should use the event payload and related resource identifiers to update its own state.
The generated schemas include payloads for onboarding, account, credential, incoming-transfer, exchange-transfer, and outgoing-transfer events. Use the current schema reference when implementing event handling.

4. Inspect delivery history#

Use the delivery endpoints when you need to investigate webhook processing:
List webhook deliveries
Get a webhook delivery
Keep your internal logs correlated with the Framnex resource identifiers so a failed business flow can be traced from the resource to its webhook delivery.

5. Retry a failed delivery#

Framnex exposes an operation to re-queue a failed webhook delivery:
Retry a failed webhook delivery
Use retry for failed deliveries after you have corrected the receiving-side issue. Do not use it as a substitute for fixing repeated processing failures in your integration.
Modified at 2026-09-26 19:17:00
Previous
Create an outgoing transfer
Next
Opens a new account for a client
Built with