Skip to main content

EUR OWTOWT Outgoing Wire Transfer - a transaction that moves funds from a Weavr managed account to a bank account held at a third-party financial institution. OWTs require the managed account to have an assigned IBAN and the user to complete Strong Customer Authentication. with Verification of PayeeVerification of Payee The EU equivalent of Confirmation of Payee CoP. A servivce that validates that the name of a payment beneficiary matches the IBAN registered with their bank or Payment Service Provider (PSP) before a SEPA payment is executed.

This guide walks through the steps to create and execute an EUR Outgoing 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). (OWTOWT Outgoing Wire Transfer - a transaction that moves funds from a Weavr managed account to a bank account held at a third-party financial institution. OWTs require the managed account to have an assigned IBAN and the user to complete Strong Customer Authentication.) with a Verification of PayeeVerification of Payee The EU equivalent of Confirmation of Payee CoP. A servivce that validates that the name of a payment beneficiary matches the IBAN registered with their bank or Payment Service Provider (PSP) before a SEPA payment is executed. (VoP) check.

The flow follows the same pattern as CoP for GBP OWTs, with two important differences:

  • VoP results include a Not Possible outcome in addition to Match, Close Match, and No Match.
  • The /confirm step is always required for EUR OWTsOWT Outgoing Wire Transfer - a transaction that moves funds from a Weavr managed account to a bank account held at a third-party financial institution. OWTs require the managed account to have an assigned IBAN and the user to complete Strong Customer Authentication. — including when sending to a Linked Account.

Overview of the flow​

  1. Create OWTOWT Outgoing Wire Transfer - a transaction that moves funds from a Weavr managed account to a bank account held at a third-party financial institution. OWTs require the managed account to have an assigned IBAN and the user to complete Strong Customer Authentication. → VoP check performed automatically
  2. Review validationOutcomes in the response
  3. Display result to end-user
  4. /confirm or /cancel based on end-user decision

Step 1: Create the OWTOWT Outgoing Wire Transfer - a transaction that moves funds from a Weavr managed account to a bank account held at a third-party financial institution. OWTs require the managed account to have an assigned IBAN and the user to complete Strong Customer Authentication.​

Create the OWTOWT Outgoing Wire Transfer - a transaction that moves funds from a Weavr managed account to a bank account held at a third-party financial institution. OWTs require the managed account to have an assigned IBAN and the user to complete Strong Customer Authentication. using the standard endpoint. Weavr automatically performs a VoP check against the beneficiaryBeneficiary A trusted recipient for payments that includes both information about the business or individual as well as their bank account or instrument details. When using trusted beneficiaries, customers may be allowed to skip Strong Customer Authentication (SCA) when executing Outgoing Wire Transfer or Send transactions, reducing the number of approval steps required.'s 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. at the point of creation.

POST/outgoing_wire_transfersTry it

Example request body​

{
  "profileId": "{{profileId}}",
  "tag": "Invoice payment",
  "sourceInstrument": {
    "type": "managed_accounts",
    "id": "{{managedAccountId}}"
  },
  "transferAmount": {
    "currency": "EUR",
    "amount": 10000
  },
  "description": "Payment for services",
  "destinationBeneficiary": {
    "name": "Acme GmbH",
    "address": {
      "addressLine1": "123 Main Street",
      "city": "Berlin",
      "country": "DE",
      "postCode": "10115"
    },
    "bankAccountDetails": {
      "iban": "DE89370400440532013000"
    }
  }
}

Step 2: Review the VoP result​

The response to the Create OWTOWT Outgoing Wire Transfer - a transaction that moves funds from a Weavr managed account to a bank account held at a third-party financial institution. OWTs require the managed account to have an assigned IBAN and the user to complete Strong Customer Authentication. request includes a validationOutcomes array. For EUR OWTsOWT Outgoing Wire Transfer - a transaction that moves funds from a Weavr managed account to a bank account held at a third-party financial institution. OWTs require the managed account to have an assigned IBAN and the user to complete Strong Customer Authentication., this contains a SEPAVerificationOfPayee entry.

Example response (excerpt)​

{
  "id": "{{owtId}}",
  "state": "REQUIRES_CONFIRMATION",
  "validationOutcomes": [
    {
      "type": "SEPAVerificationOfPayee",
      "result": "CLOSE_MATCH",
      "actualName": "Acme GmbH & Co."
    }
  ]
}

VoP result values​

result valueMeaning
MATCHThe name provided matches the name registered to the 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..
CLOSE_MATCHThe name provided is similar but not identical. Check accountName for the registered name.
NO_MATCHThe name provided does not match the name registered to the 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..
NOT_POSSIBLEThe VoP check could not be completed (e.g. the receiving institution does not support VoP).
No reason codes for VoP

Unlike CoP for GBP payments, VoP does not return reason codes. The result field and, where available, the actualName field are the only information returned to inform the end-user's decision.

The OWTOWT Outgoing Wire Transfer - a transaction that moves funds from a Weavr managed account to a bank account held at a third-party financial institution. OWTs require the managed account to have an assigned IBAN and the user to complete Strong Customer Authentication. state will be REQUIRES_CONFIRMATION. It cannot proceed until it is either confirmed or cancelled.

Step 3: Display the result to the end-user​

You are required to display the VoP result to your end-user before they confirm the payment. The end-user should be given the option to:

  • Proceed — confirm the OWTOWT Outgoing Wire Transfer - a transaction that moves funds from a Weavr managed account to a bank account held at a third-party financial institution. OWTs require the managed account to have an assigned IBAN and the user to complete Strong Customer Authentication. and submit the payment.
  • Cancel — cancel the OWTOWT Outgoing Wire Transfer - a transaction that moves funds from a Weavr managed account to a bank account held at a third-party financial institution. OWTs require the managed account to have an assigned IBAN and the user to complete Strong Customer Authentication. if they are not satisfied with the result.

Step 4: Confirm or cancel the OWTOWT Outgoing Wire Transfer - a transaction that moves funds from a Weavr managed account to a bank account held at a third-party financial institution. OWTs require the managed account to have an assigned IBAN and the user to complete Strong Customer Authentication.​

Based on the end-user's decision, call either the /confirm or /cancel endpoint.

Confirm​

POST/outgoing_wire_transfers/{id}/confirmTry it

This submits the OWTOWT Outgoing Wire Transfer - a transaction that moves funds from a Weavr managed account to a bank account held at a third-party financial institution. OWTs require the managed account to have an assigned IBAN and the user to complete Strong Customer Authentication. for processing. The state will transition from PENDING_CONFIRMATION to PENDING_CHALLENGE (so that an SCA transaction confirmation can be completed), and eventually to COMPLETED.

Cancel​

POST/outgoing_wire_transfers/{id}/cancelTry it

This cancels the OWTOWT Outgoing Wire Transfer - a transaction that moves funds from a Weavr managed account to a bank account held at a third-party financial institution. OWTs require the managed account to have an assigned IBAN and the user to complete Strong Customer Authentication.. The state will transition to CANCELLED and the funds will be released back to the source 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..

Linked AccountsLinked Account An entity in the Weavr system that represents an external bank account or payment service provider (PSP) account which an Identity has verified they own and control. This feature enables users to perform transactions, such as outgoing and incoming wire transfers, between their Linked Accounts and their Managed Accounts as 'self-to-self' transfers.​

/confirm is always required for EUR OWTs to Linked Accounts

For GBP OWTsOWT Outgoing Wire Transfer - a transaction that moves funds from a Weavr managed account to a bank account held at a third-party financial institution. OWTs require the managed account to have an assigned IBAN and the user to complete Strong Customer Authentication. via Faster Payments, the /confirm step is skipped when the destination is a Linked Account, as the beneficiaryBeneficiary A trusted recipient for payments that includes both information about the business or individual as well as their bank account or instrument details. When using trusted beneficiaries, customers may be allowed to skip Strong Customer Authentication (SCA) when executing Outgoing Wire Transfer or Send transactions, reducing the number of approval steps required. name was verified at account creation.

For EUR OWTsOWT Outgoing Wire Transfer - a transaction that moves funds from a Weavr managed account to a bank account held at a third-party financial institution. OWTs require the managed account to have an assigned IBAN and the user to complete Strong Customer Authentication. via SEPA, this exception does not apply. The /confirm step is always required — even when sending to a Linked Account. You must always display the VoP result to the end-user.