DOC-1024 Merchant doc updates #316
Open
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
✅ Deploy Preview for incomparable-tiramisu-91a96a ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
racene-swan
reviewed
Jun 9, 2025
| | `Suspended` | Status **assigned by Swan** when the merchant's use of their profile or payment method needs to be reviewed. The status can't return to `Enabled` without a review. | | ||
| | `Rejected` | Final status **assigned by Swan** when Swan decides the risk of this profile or the risk of this payment method for the associated merchant is too high, or for some other risk-related reason. | | ||
| | `Disabled` | Final status **set by you** using the `requestMerchantPaymentMethods` mutation. | | ||
|
|
||
| ## Merchant profiles {#profiles} | ||
|
|
||
| A **merchant profile** is a collection of business, risk, and support information that fulfills two primary requirements: **approve the account holder** as a merchant, and **facilitate accepting payments** with Swan. | ||
| A **merchant profile** is a collection of business, risk, and support information that fulfills two primary requirements: **approve the account holder** as a merchant, and **facilitate accepting payments** with Swan. |
There was a problem hiding this comment.
This should be in a numbered list.
racene-swan
reviewed
Jun 9, 2025
| A **merchant profile** is a collection of business, risk, and support information that fulfills two primary requirements: **approve the account holder** as a merchant, and **facilitate accepting payments** with Swan. | ||
| If a Swan account holder wants to accept payments from customers, they must have at least one merchant profile. | ||
|
|
||
| Merchant profiles can be created at the same time as onboarding. |
There was a problem hiding this comment.
same time as an onboarding? Or simultaneously with onboarding?
racene-swan
reviewed
Jun 9, 2025
| If a Swan account holder wants to accept payments from customers, they must have at least one merchant profile. | ||
|
|
||
| Merchant profiles can be created at the same time as onboarding. | ||
| Since merchants are considered high risk, profiles should only be created for users who need merchant features. |
There was a problem hiding this comment.
high-risk - what do we mean by "users who need merchant features" - this is unclear since this whole section is about Merchant profiles.
racene-swan
reviewed
Jun 9, 2025
|
|
||
| Merchant profiles can be created at the same time as onboarding. | ||
| Since merchants are considered high risk, profiles should only be created for users who need merchant features. | ||
| Requesting profiles for all users may lead to unmet expectations. |
There was a problem hiding this comment.
What do we mean by this? will it be rejected? what's the user impact here?
racene-swan
reviewed
Jun 9, 2025
| - Projected volumes | ||
| - Logo (optional), displayed online and on mandate PDFs | ||
| - Payment frequency | ||
| - Logo (optional), in `.png` format and less than 1 mb, displayed online and on mandate PDFs |
racene-swan
reviewed
Jun 9, 2025
|
|
||
| A merchant profile is required of all Swan account holders wanting to accept payments from customers. | ||
| If you want to accept payments from customers, you must have at least one merchant profile. | ||
| To speed up enabling your merchant profile, complete as many information fields as possible. |
There was a problem hiding this comment.
Rework this sentence - it's clunky.
racene-swan
reviewed
Jun 9, 2025
| The merchant profile status doesn't change. | ||
|
|
||
| When a merchant payment method is requested, Swan may ask for additional information even if the merchant profile is already `Enabled`. | ||
| Swan will contact the you or the user directly, based on your communication preferences. |
There was a problem hiding this comment.
Swan will contact you or the user directly
racene-swan
requested changes
Jun 9, 2025
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Merchant overview page ready for review. Still need to update the guides.