Skip to main content

EUR OWT with Verification of Payee

This guide walks through the steps to create and execute an EUR Outgoing Wire TransferWire TransferA 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). 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 PayeeThe EU equivalent of Confirmation of Payee (CoP). A service that validates the name of a payment beneficiary against 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). 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.

Create and execute an OWT​

  1. Create OWTOWT (Outgoing Wire Transfer). 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. Act on the result: accept suggested name, enter new name, confirm, or cancel
    • Accepting a suggested name or entering a new name re-runs the VoP check-return to step 3
  5. Confirm the OWTOWT (Outgoing Wire Transfer). 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.

1. Create the OWT​

Create the OWTOWT (Outgoing Wire Transfer). 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. We automatically perform a VoP check against the payee's IBANIBAN (International Bank Account Number). 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_transfersOpen API reference 
/outgoing_wire_transfers
{  "profileId": "10001",  "tag": "customer-123",  "sourceInstrument": {    "type": "managed_accounts",    "id": "123456789"  },  "transferAmount": {    "currency": "GBP",    "amount": 1250  },  "purpose": "Invoice payment",  "description": "Invoice 1042",  "destinationBeneficiary": {    "name": "Alex Smith",    "type": "PERSONAL",    "address": "1 High Street, London W1A 1AA",    "bankName": "National Westminster Bank PLC",    "bankAddress": "250 Bishopsgate, London EC2M 4AA",    "bankCountry": "GB",    "bankAccountDetails": {      "iban": "GB29NWBK60161331926819",      "bankIdentifierCode": "NWBKGB2L"    },    "nationality": "GB",    "dateOfBirth": "1990-01-01"  },  "scheduledTimestamp": "1786118400000"}

2. Review the VoP result​

The response to POST/outgoing_wire_transfers (and to GET/outgoing_wire_transfers and GET/outgoing_wire_transfers/{id}) includes a validationOutcomes array. For EUR OWTsOWT (Outgoing Wire Transfer). 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). 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). 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). 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 canceled.

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. Depending on the result, the end-user should be given the option to:

  • Accept the suggested name - for Close Match results where actualName is returned, the payee name updates to the registered name and the check re-runs.
  • Enter a new name - correct the payee name and re-run the check.
  • Confirm - proceed with the OWTOWT (Outgoing Wire Transfer). 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. as entered.
  • Cancel - cancel the OWTOWT (Outgoing Wire Transfer). 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..

4. Act on the VoP result​

Based on the end-user's decision, four actions are available.

Accept suggested name​

Only available for CLOSE_MATCH results where actualName is returned. This updates the payee name to the registered name and re-runs the VoP check.

PATCH/outgoing_wire_transfers/{id}Open API reference 
/outgoing_wire_transfers/123456789
{  "name": "Alex Smith",  "acceptVerifiedName": true}
{
  "acceptVerifiedName": true
}

The response includes updated validationOutcomes. Return to step 3 to display the new result.

Enter new name​

The end-user can provide a corrected payee name. This updates the name on the OWTOWT (Outgoing Wire Transfer). 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 re-runs the VoP check.

PATCH/outgoing_wire_transfers/{id}Open API reference 
/outgoing_wire_transfers/123456789
{  "name": "Alex Smith",  "acceptVerifiedName": true}
{
  "name": "Corrected Payee Name"
}

The response includes updated validationOutcomes. Return to step 3 to display the new result.

5. Confirm​

Confirm the OWT​

To confirm and proceed with the OWTOWT (Outgoing Wire Transfer). 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., use the /confirm endpoint.

POST/outgoing_wire_transfers/{id}/confirmOpen API reference 
/outgoing_wire_transfers/123456789/confirm

The OWTOWT (Outgoing Wire Transfer). 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 immediately changes from PENDING_CONFIRMATION to PENDING_CHALLENGE, which requires completing before the OWTOWT (Outgoing Wire Transfer). 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. is fully submitted.

Returned stateWhat it means and what to do next
PENDING_CHALLENGEConfirmation succeeded. Complete the transaction confirmation challenge.
PENDING_CONFIRMATIONThe transfer still needs confirming. Call the confirm endpoint again.
SUBMITTED, or any state that follows itThe transfer is already accepted and in flight. Don't call the confirm endpoint again. Track progress with the POST/outgoing_wire_transfers/watch webhook instead.

The value returned by /confirm is authoritative, and you should check that rather than assuming the transfer has moved to PENDING_CHALLENGE.

Complete SCA​

Complete the transaction confirmation SCASCA (Strong Customer Authentication). Strong Customer Authentication - a two-factor authentication solution required by PSD2 regulations for when end-users are accessing their payment account sensitive information or initiating transactions. SCA requires at least two of the following: something you know (password), something you have (device), or something you are (biometrics). challenge, then call /confirm again.

The state then changes from PENDING_CHALLENGE to SUBMITTED, and eventually to COMPLETED.

A 200 response doesn't guarantee that the state advanced, so always read state from the /confirm response.

Cancel​

POST/outgoing_wire_transfers/{id}/cancelOpen API reference 
/outgoing_wire_transfers/123456789/cancel
{  "cancellationReason": "Payment no longer required"}

This cancels the OWTOWT (Outgoing Wire Transfer). 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 AccountAn 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 accounts​

/confirm is always required for EUR OWTs to linked accounts

For GBP OWTsOWT (Outgoing Wire Transfer). 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 PaymentsFaster PaymentsThe UK domestic real-time payment scheme (run by Pay.UK) used to clear GBP wire transfers between UK bank accounts in seconds. GBP managed accounts settle incoming and outgoing wire transfers via Faster Payments, and our [Confirmation of Payee](/transactions/owt/cop/overview) checks run over this scheme., the /confirm step is skipped when the destination is a linked account, because the payee name was verified at account creation.

For EUR OWTsOWT (Outgoing Wire Transfer). 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 SEPASEPA (Single Euro Payments Area). Single Euro Payments Area - the European scheme that standardises euro-denominated bank transfers across participating countries. EUR managed accounts settle incoming and outgoing wire transfers via SEPA Credit Transfer (SCT) or SEPA Instant; our [Verification of Payee](/transactions/owt/vop/overview) check runs against the IBAN registered with the beneficiary's bank or PSP before a SEPA payment executes., 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.

Webhook event​

The POST/outgoing_wire_transfers/watch webhook includes the eventType PENDING_CONFIRMATION in its payload, letting you react asynchronously when an OWTOWT (Outgoing Wire Transfer). 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. is awaiting confirmation.

POST/outgoing_wire_transfers/watchOpen reference