Simulator
The Simulator is a Sandbox-only set of tools for triggering events that would otherwise require real-world activity — a customer completing KYCKYC Know Your Customer - the identity verification process for consumer identities. This process allows you to seamlessly and securely verify your user's identity. Weavr will ask users to submit the necessary information and documentation so that they can get approved by financial providers., a wire arriving from another bank, a card being used at a merchant. Everything in this section only exists in Sandbox; in Live the Simulator menu is hidden.
The same actions are also available via the Simulator API, which is what you'll script for automated tests. The Portal-based Simulator is best for ad-hoc one-off triggers and for walking through flows when you're learning the platform.
When to use the Simulator
Use the Simulator to:
- Move a corporate or consumer through KYBKYB Know Your Business - the identity verification process for corporate identities. This process allows you to seamlessly and securely verify your business customer's identity. Weavr will ask users to submit the necessary information and documentation so that they can get approved by financial providers. / KYCKYC Know Your Customer - the identity verification process for consumer identities. This process allows you to seamlessly and securely verify your user's identity. Weavr will ask users to submit the necessary information and documentation so that they can get approved by financial providers. verification without supplying real ID documents.
- Receive an incoming wire transferWire Transfer A transaction that moves funds between accounts. An incoming wire transfer moves funds from a third-party bank account to a Weavr managed account, while an outgoing wire transfer moves funds from a Weavr managed account to a third-party bank account. Wire transfers require the managed account to have an assigned IBAN (for EUR) or sort code and account number (for GBP). on a managed accountManaged Account An account held at a financial institution that can be created and managed through the Weavr platform. Each account has a balance where customers can hold funds. Optionally, an IBAN can be assigned to enable wire transfers to bank accounts outside of Weavr. so you can test funding flows.
- Authorize a card purchase to test spend rules, 3DS3DS 3-D Secure - an additional security layer for online credit and debit card transactions. It adds an authentication step where the cardholder verifies their identity with the card issuer during the purchase, reducing fraud and providing liability protection for merchants., and authorisation forwarding.
- Mark a card as expired or about to expire to test renewal logic.
- Generate push notifications to test step-up authentication.
- Change Open BankingOpen Banking A service that allows customers to securely share their bank account information and authorize payments directly from their bank account. In Payment Run, Open Banking can be used to link accounts and fund payment runs, providing a seamless experience for buyers. AIS consent state.
Available actions
The simulator menu has the following entries for MultiMulti Weavr Multi is an embedded finance solution that allows you to integrate financial services into your own application, providing a seamless experience for your customers. It enables you to offer managed accounts, managed cards, and transactions without requiring financial expertise. programmesProgramme A programme represents your application within Weavr. Everything you create — Identities, Instruments, Transactions — sits beneath a Programme. When you register as an Embedder, you receive a Programme in the Sandbox and, once approved, one in Production.. Each entry opens a small form where you fill in identifiers (corporate ID, account ID, card ID) and any action-specific values (amount, merchant, currency).
Identity verification
| Action | What it does |
|---|---|
| Verify Business (KYBKYB Know Your Business - the identity verification process for corporate identities. This process allows you to seamlessly and securely verify your business customer's identity. Weavr will ask users to submit the necessary information and documentation so that they can get approved by financial providers.) | Moves a corporate's KYBKYB Know Your Business - the identity verification process for corporate identities. This process allows you to seamlessly and securely verify your business customer's identity. Weavr will ask users to submit the necessary information and documentation so that they can get approved by financial providers. state to APPROVED (or REJECTED, depending on what you choose). |
| Verify Consumer (KYCKYC Know Your Customer - the identity verification process for consumer identities. This process allows you to seamlessly and securely verify your user's identity. Weavr will ask users to submit the necessary information and documentation so that they can get approved by financial providers.) | Moves a consumer's KYCKYC Know Your Customer - the identity verification process for consumer identities. This process allows you to seamlessly and securely verify your user's identity. Weavr will ask users to submit the necessary information and documentation so that they can get approved by financial providers. state to APPROVED (or REJECTED). |
After running one of these, the identity's state changes immediately and you'll see a corresponding webhook event in Webhook logs.
Incoming funds
| Action | What it does |
|---|---|
| IWTIWT Incoming Wire Transfer - a transaction that occurs when funds from a bank account held at a third-party financial institution are moved to a Weavr managed account. IWTs are initiated externally by the owner of the source bank account, and the managed account must have an assigned IBAN to receive funds. processing | Simulates an incoming wire transferWire Transfer A transaction that moves funds between accounts. An incoming wire transfer moves funds from a third-party bank account to a Weavr managed account, while an outgoing wire transfer moves funds from a Weavr managed account to a third-party bank account. Wire transfers require the managed account to have an assigned IBAN (for EUR) or sort code and account number (for GBP). to a managed accountManaged Account An account held at a financial institution that can be created and managed through the Weavr platform. Each account has a balance where customers can hold funds. Optionally, an IBAN can be assigned to enable wire transfers to bank accounts outside of Weavr. by IBANIBAN International Bank Account Number - a standardized international bank account identifier. Managed accounts can be assigned an IBAN to enable wire transfers to and from bank accounts outside of Weavr. IBANs are required for EUR accounts and enable SEPA transfers. or sort code / account number. |
| IWTIWT Incoming Wire Transfer - a transaction that occurs when funds from a bank account held at a third-party financial institution are moved to a Weavr managed account. IWTs are initiated externally by the owner of the source bank account, and the managed account must have an assigned IBAN to receive funds. by account ID | The same, but targeted at the account ID instead of the bank coordinates — handy when you have the ID. |
For the lifecycle of an incoming wire transferWire Transfer A transaction that moves funds between accounts. An incoming wire transfer moves funds from a third-party bank account to a Weavr managed account, while an outgoing wire transfer moves funds from a Weavr managed account to a third-party bank account. Wire transfers require the managed account to have an assigned IBAN (for EUR) or sort code and account number (for GBP). and how to consume the events that follow, see Incoming wire transfers.
Card activity
| Action | What it does |
|---|---|
| Purchase by card number | Simulates a card purchase using the card's PAN. Useful when you want to test the cardholder's perspective. |
| Purchase by card ID | The same, but using the card's Weavr ID. Faster when you have the ID handy. |
| Card expired | Marks a card as expired so you can test downstream behaviour. |
| Card about to expire | Triggers the "about to expire" event so you can test renewal flows. |
Each purchase form lets you set amount, currency, merchant category code, and merchant details so you can exercise spend rules.
Push notifications
| Action | What it does |
|---|---|
| User authentication | Sends a push notification for an authentication step-up. |
| Outgoing wire transfersWire Transfer A transaction that moves funds between accounts. An incoming wire transfer moves funds from a third-party bank account to a Weavr managed account, while an outgoing wire transfer moves funds from a Weavr managed account to a third-party bank account. Wire transfers require the managed account to have an assigned IBAN (for EUR) or sort code and account number (for GBP). | Sends a push notification for an outgoing-wire-transfer step-up. |
Use these to exercise the step-up authentication flow without performing real device interactions.
Open bankingOpen Banking A service that allows customers to securely share their bank account information and authorize payments directly from their bank account. In Payment Run, Open Banking can be used to link accounts and fund payment runs, providing a seamless experience for buyers.
| Action | What it does |
|---|---|
| AIS Consent Status Change | Changes the status of an Account Information Services consent for Open BankingOpen Banking A service that allows customers to securely share their bank account information and authorize payments directly from their bank account. In Payment Run, Open Banking can be used to link accounts and fund payment runs, providing a seamless experience for buyers. testing. |
Running an action
- Open Simulator from the left navigation. The default sub-page is IWTIWT Incoming Wire Transfer - a transaction that occurs when funds from a bank account held at a third-party financial institution are moved to a Weavr managed account. IWTs are initiated externally by the owner of the source bank account, and the managed account must have an assigned IBAN to receive funds. processing for MultiMulti Weavr Multi is an embedded finance solution that allows you to integrate financial services into your own application, providing a seamless experience for your customers. It enables you to offer managed accounts, managed cards, and transactions without requiring financial expertise. programmesProgramme A programme represents your application within Weavr. Everything you create — Identities, Instruments, Transactions — sits beneath a Programme. When you register as an Embedder, you receive a Programme in the Sandbox and, once approved, one in Production..
- Pick the action you want from the simulator sub-menu.
- Fill in the form. Most fields validate inline — IDs that don't match real Sandbox objects are rejected.
- Submit. The Portal confirms with a toast; the result of the action shows up immediately in the Console and any matching webhooks appear in Webhook logs.
Scripting the simulator
For automated tests, prefer the Simulator API over the Portal. The API exposes the same actions and is what your test harness should call. The Portal Simulator is essentially a UI on top of those endpoints.
Next steps
- Simulator API reference
- Webhook logs — see events emitted by simulator actions
- Step-up authentication
- Incoming wire transfers