Skip to content

DOC-1151/VOP-000: Single-page guide #344

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 70 commits into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
70 commits
Select commit Hold shift + click to select a range
70d6db4
Adding VOP page & referencing it in sidebar + index
max-koro Jul 10, 2025
4b10b7d
New diagram + swan style redux
max-koro Jul 10, 2025
48b97b1
Removed deprecated field
max-koro Jul 10, 2025
11ba3ca
Fixed prev commit
max-koro Jul 10, 2025
e4d01c1
Small touch-ups
max-koro Jul 10, 2025
1e5c421
Streamlined & improved visual elements
max-koro Jul 10, 2025
6acf57b
Added tabs
max-koro Jul 10, 2025
6153696
Tabs restyling
max-koro Jul 11, 2025
8d6a7b7
Prettier Tabs selector
max-koro Jul 11, 2025
2d03ffb
Tabs content + Verif page warning
max-koro Jul 11, 2025
68e75af
Explorer button overhaul
max-koro Jul 11, 2025
e2dbaff
Final touch-ups
max-koro Jul 11, 2025
bcad3ef
Added VoP warnings
max-koro Jul 11, 2025
1f2243e
Moved section in VoP
max-koro Jul 11, 2025
889ddeb
Improved formatting and phrasing
max-koro Jul 11, 2025
65140ab
Small semantic fixes
max-koro Jul 11, 2025
a15b827
Improved tab items design
max-koro Jul 11, 2025
71b7455
Aligned tabs on style guide
max-koro Jul 15, 2025
a8cd502
Rephrasing & adding key benefits
max-koro Jul 15, 2025
fc372dd
Reworked How It Works
max-koro Jul 15, 2025
7ede7b0
Added flow diagrams
max-koro Jul 15, 2025
d592468
Flow diagram touch-ups
max-koro Jul 15, 2025
1cd9582
Clarified payment proceeds
max-koro Jul 15, 2025
d7ca340
MVP, no code snippets
max-koro Jul 15, 2025
05f13f2
Fixed Verification diagram alignment
max-koro Jul 15, 2025
756ab9a
Fixed Verification diagram subgraph approach
max-koro Jul 15, 2025
6cabf3e
Fixed Verification diagram made extra node invisible
max-koro Jul 15, 2025
a13540c
Callout fix
max-koro Jul 16, 2025
816d96e
Peer review fixes
max-koro Jul 16, 2025
f2be37f
Peer review final edits
max-koro Jul 16, 2025
b5d96ad
Removed CTAs
max-koro Jul 16, 2025
1fe11ae
Update verification-of-payee.mdx
max-koro Jul 16, 2025
fc0d211
Theo review pt.1
max-koro Jul 18, 2025
15a0789
Full structural rework
max-koro Jul 18, 2025
80ced9e
v2 from final review
max-koro Jul 18, 2025
ecafb9b
v3: fixing phrasing issues
max-koro Jul 18, 2025
fb94368
Coming Soon redux
max-koro Jul 18, 2025
0be5067
Added new mobile images
max-koro Jul 20, 2025
1978b83
Adding in mobile consent screens
max-koro Jul 20, 2025
a86c2eb
Edits to the examples structure
max-koro Jul 21, 2025
734ef3c
Further anonymized examples
max-koro Jul 21, 2025
818ac8b
Apply suggestions from code review
max-koro Jul 21, 2025
4bfa4aa
High-level diagram update
max-koro Jul 21, 2025
3682836
New option terminology
max-koro Jul 21, 2025
29ab066
Update verification-of-payee.mdx
max-koro Jul 21, 2025
9f3c30c
Better anonymization
max-koro Jul 21, 2025
2fe4ed7
Updated figma examples
max-koro Jul 21, 2025
1d9b7b7
Update docs/topics/payments/credit-transfers/sepa/guide-add-beneficia…
max-koro Jul 21, 2025
1287bc4
Update docs/topics/payments/credit-transfers/sepa/guide-initiate-ct.mdx
max-koro Jul 21, 2025
e0f2feb
Updated images
max-koro Jul 21, 2025
7deaea1
Merge branch 'DOC-1151/VoP-000__single-page-guide' of https://github.…
max-koro Jul 21, 2025
add81c9
Update docs/topics/payments/credit-transfers/sepa/guide-verify-benefi…
max-koro Jul 21, 2025
cf861e7
Update docs/topics/payments/credit-transfers/sepa/index.mdx
max-koro Jul 21, 2025
383723d
Update docs/topics/payments/credit-transfers/sepa/verification-of-pay…
max-koro Jul 21, 2025
2630442
Update docs/topics/payments/credit-transfers/sepa/verification-of-pay…
max-koro Jul 21, 2025
5529b55
Update docs/topics/payments/credit-transfers/sepa/verification-of-pay…
max-koro Jul 21, 2025
f29f3f6
Update docs/topics/payments/credit-transfers/sepa/verification-of-pay…
max-koro Jul 21, 2025
b02dd3b
Update docs/topics/payments/credit-transfers/sepa/verification-of-pay…
max-koro Jul 21, 2025
fdd661f
Update docs/topics/payments/credit-transfers/sepa/verification-of-pay…
max-koro Jul 21, 2025
6b29d8f
Update docs/topics/payments/credit-transfers/sepa/verification-of-pay…
max-koro Jul 21, 2025
8762ffe
Update docs/topics/payments/credit-transfers/sepa/verification-of-pay…
max-koro Jul 21, 2025
94ef83c
Update docs/topics/payments/credit-transfers/sepa/verification-of-pay…
max-koro Jul 21, 2025
82dc8cf
Update docs/topics/payments/credit-transfers/sepa/verification-of-pay…
max-koro Jul 21, 2025
6b3d705
Apply suggestions from code review
max-koro Jul 21, 2025
d39f0c3
Peer review corrections wave
max-koro Jul 21, 2025
3ad5c05
Restructuring
max-koro Jul 21, 2025
95cb5c1
Final changes based on peer review
max-koro Jul 21, 2025
47e8710
Options overview rewrite
max-koro Jul 21, 2025
76dbb7b
Sidebar fix
max-koro Jul 21, 2025
8601b22
Apply suggestions from code review
max-koro Jul 22, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,10 @@ title: Add a trusted SEPA beneficiary

# Add a trusted SEPA beneficiary

:::warning VoP integration required
Starting October 9, 2025, trusted beneficiaries require a [Verification of Payee (VoP)](verification-of-payee) check before each transfer to comply with EU regulation.
:::

Add a trusted beneficiary for SEPA Credit Transfers with the API.

## Add a trusted beneficiary {#guide-add}
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,10 @@ title: Initiate a credit transfer

# Initiate a credit transfer

:::warning VoP Integration Required
Starting October 9, 2025, Swan automatically includes [Verification of Payee (VoP)](verification-of-payee) in all SEPA Credit Transfers. For an optimal user experience, consider integrating the `verifyBeneficiary` mutation.
:::

Send SEPA Credit Transfers, Instant SEPA Credit Transfers, and Swan Internal Credit Transfers with the API.
Review sample mutations for all three, as well as a payload.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,10 @@ title: Verify a beneficiary
Verify a beneficiary with the API.
[Verifying beneficiaries](./index.mdx#beneficiary-verification) reduces the risk of errors and potential fraud.

:::danger Migration required
The `beneficiaryVerification` query will be deprecated on October 9, 2025. Migrate to the new [Verification of Payee (VoP)](verification-of-payee) instead before the compliance deadline.
:::

## Guide {#guide}

1. Call the `beneficiaryVerification` query.
Expand Down
8 changes: 8 additions & 0 deletions docs/topics/payments/credit-transfers/sepa/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,10 @@ title: SEPA Credit Transfers

# SEPA Credit Transfers

:::warning
Starting October 9, 2025, Swan automatically includes [Verification of Payee (VoP)](verification-of-payee) in all SEPA Credit Transfers to comply with the EU Instant Payments Regulation.
:::

## Overview {#overview}

Transfer euros between accounts located in the [Single Euro Payments Area (SEPA)](../../index.mdx#sepa).
Expand Down Expand Up @@ -41,6 +45,10 @@ Due to the manual review, flagged SEPA Credit Transfers take longer to execute.

### Verifying beneficiaries {#beneficiary-verification}

:::danger Breaking change
The `beneficiaryVerification` query will be deprecated. Plan [your migration](verification-of-payee) before the compliance deadline to ensure uninterrupted service.
:::

**IBAN verification** allows debtors to verify that credit transfers are sent to the right beneficiary *before* initiating the transfer, thus reducing errors and potential fraud.

:::info Dutch IBANs only
Expand Down
Loading