|
|
| Line 1: |
Line 1: |
| − | Follow these rules to make your trades smooth and successful, and be aware of the tools available if you end up with issues.
| + | This page is pending transcription to this wiki. |
| | | | |
| − | To trade on Bisq, you assume one of two roles, no matter what national currency or cryptocurrency you’re trading: you either buy bitcoin or sell bitcoin.
| + | In the interim, see this page for details on trading rules and dispute resolution: |
| − | | + | https://docs.bisq.network/trading-rules.html |
| − | This document covers the rules and expectations for both roles, as well as details on the process for handling disputes.
| |
| − | | |
| − | =Trading Rules=
| |
| − | Whether making or taking an offer, bitcoin sellers put all the bitcoin they’re selling in the multisig escrow, so there’s less for them to do and fewer rules they need to follow.
| |
| − | | |
| − | The rules below are ''default'' rules for every transaction. Offer makers sometimes specify their own ''additional'' terms for handling/arranging payments. For example, a seller using cash deposit might require a picture of a receipt torn in half with "NO REFUND" written on it. Face-to-face traders often specify terms about where and how to meet. Make sure you’re okay with an offer-maker’s terms '''before''' you accept an offer!
| |
| − | | |
| − | ==Bitcoin Sellers==
| |
| − | Bitcoin sellers ''must'':
| |
| − | | |
| − | * Click Confirm payment after receiving payment
| |
| − | ** Sellers have until the end of the maximum trade period to do so.
| |
| − | ** Account signing, introduced in Bisq v1.2, enables a seller with a signed payment account to sign a buyer’s payment account when they successfully receive a payment. For such trades, it is recommended that the seller take as long as possible (i.e., wait until close to the end of the trade period) to confirm receipt of payment to reduce the chance of a chargeback.
| |
| − | | |
| − | * Collaborate with mediators and arbitrators
| |
| − | ** In case of a dispute, users must respond to inquiries within 48 hours and providing materials as requested to determine an outcome.
| |
| − | ** Mediators may take up to 48 hours to respond to messages, and arbitrators may take up to 5 days to respond to messages.
| |
| − | | |
| − | Bitcoin sellers ''may'':
| |
| − | | |
| − | * Open a dispute
| |
| − | ** If trader chat is not helpful, a seller can engage a mediator by clicking the '''Get Support''' button on the trade information screen (select the open trade in the '''Open Trades''' tab of the '''Portfolio''' screen). **See more details in the mediation section below.
| |
| − | | |
| − | * Respond to trader chat messages
| |
| − | ** This is optional. Please see the rules for trader chat below.
| |
| − | | |
| − | Bitcoin sellers ''should not'':
| |
| − | | |
| − | * Confirm payments that do not match details in trade contract
| |
| − | ** Payer name, payment method, institution, trade ID (if provided), and other details of a payment should ''exactly'' match the details in the trade contract. If not, the payment should not be accepted.
| |
| − | *** This is especially relevant for trades in which a signed seller trades with an unsigned buyer, because confirmation of payment receipt signs the buyer’s payment account. In case of such an issue, a dispute should be opened.
| |
| − | | |
| − | * Communicate with buyers away from Bisq
| |
| − | ** Using email addresses, phone numbers, and other means to contact traders is strongly discouraged. The trader chat feature built into Bisq should be used instead: not only is it more private, but the chat record can more easily be made available to mediators and arbitrators (useful in case a trader’s chat messages indicate they broke a rule).
| |
| − | ** At this point, the software itself does not provide a way to relay the message record between 2 traders to a mediator or arbitrator, so other means of sharing the chat record will be used if needed.
| |
| − | | |
| − | == Bitcoin Buyers ==
| |
| − | To avoid unexpected issues, make sure you can actually carry out a payment with the payment method you’ve set up in Bisq. Examples: Wells Fargo doesn’t allow cash deposits into bank accounts not owned by the depositor, and Zelle has weekly and monthly transfer maximums that are easy to overlook. The software will warn you about known issues, but cannot possibly keep up with all the newest banking and money transfer rules.
| |
| − | | |
| − | Bitcoin buyers ''must'':
| |
| − | | |
| − | * Make payment reasonably early within trade period
| |
| − | ** Buyer should complete at a time such that the seller has enough time to acknowledge receipt of the payment before the trade period is over. Waiting until the very end of the trade period to make a payment is not advised, as then the seller cannot reasonably act in time to acknowledge receipt (also, it’s annoying). The [https://bisq.network/faq/#trade-periods lengths of trade periods] vary based on payment method.
| |
| − | *** This is especially important for buyers with unsigned payment accounts trading with sellers with signed payment accounts. A seller will not want to confirm receipt of a payment made at the last minute from an untrusted account, so if you’re a buyer looking to get your payment account signed, you should make the payment ''as soon as possible.''
| |
| − | | |
| − | * Make payment from account used to make or take the offer
| |
| − | ** Intermediary banks or other payment methods from the same bank are not acceptable. Account information (e.g., name, account number, etc) of the account used to make the payment must ''exactly'' match the information in the Bisq payment account details.
| |
| − | ** If such a payment cannot be made, please communicate the issue through trader chat, or you’ll need to make your case to a mediator or arbitrator.
| |
| − | | |
| − | * Enter the trade ID in payment’s "reason for payment"
| |
| − | ** If possible, the trade ID should be included in the payment’s "reason for payment" field. The name of this field can vary by payment method; some call it "Message" or "Information for recipient" or similar. Pick the field (if available) that enables the user to tie the payment to the specific trade.
| |
| − | ** If there is no such field, just send the payment without specifying the trade ID.
| |
| − | | |
| − | * Click '''Payment started''' after sending payment
| |
| − | ** Seller cannot mark the payment as received until buyer confirms that they have sent it. Don’t forget!
| |
| − | | |
| − | * Pay any transaction fees
| |
| − | ** Any fees incurred to make the payment via the agreed payment method (e.g., bank fees for bank transfer, money-order fees for money orders, etc) are the buyer’s responsibility to pay.
| |
| − | ** The seller should receive the exact amount of the trade. The only exception to this rule is if the receiving institution imposes a fee on incoming payments—these fees are borne by the seller.
| |
| − | | |
| − | * Collaborate with mediators and arbitrators
| |
| − | ** In case of a dispute, users must respond to inquiries within 48 hours and providing materials as requested to determine an outcome.
| |
| − | ** Mediators may take up to 48 hours to respond to messages, and arbitrators may take up to 5 days to respond to messages.
| |
| − | | |
| − | Bitcoin buyers ''may'':
| |
| − | * Respond to trader chat messages
| |
| − | ** This is optional. Please see the rules for trader chat below.
| |
| − | | |
| − | *Open a dispute
| |
| − | ** If trader chat is not helpful, a buyer can engage a mediator by clicking the '''Get Support''' button on the trade information screen (select the open trade in the '''Open Trades''' tab of the '''Portfolio''' screen).
| |
| − | ** See more details in the mediation section below.
| |
| − | | |
| − | Bitcoin buyers ''should not'':
| |
| − | * Add any additional information in payment’s "reason for payment"
| |
| − | ** Any mentions of ''Bisq'' or ''Bitcoin'' or any text other than the trade ID is prohibited. The receiver is already expecting a payment from you using the agreed payment method in the amount of the trade, so there is no reason to reveal any more context or information.
| |
| − | *** This is an important rule, and potentially a serious problem if broken: many banks don’t like anything related to Bitcoin, and may create serious problems for you (or your trading peer) if they sense such a transaction.
| |
| − | | |
| − | * Communicate with buyers away from Bisq
| |
| − | ** Using email addresses, phone numbers, and other means to contact traders is strongly discouraged. The trader chat feature built into Bisq should be used instead: not only is it more private, but the chat record can more easily be made available to mediators and arbitrators (useful in case a trader’s chat messages indicate they broke a rule).
| |
| − | ** At this point, the software itself does not provide a way to relay the message record between 2 traders to a mediator or arbitrator, so other means of sharing the chat record will be used if needed.
| |
| − | | |
| − | == Face-to-Face (F2F) Trading ==
| |
| − | On Bisq, F2F trades are ''technically'' very similar to online trades. In fact, to carry out a F2F trade, you follow the same process within the Bisq software as you would for any other trade. The difference is in how the buyer pays the seller: instead of paying through a financial intermediary (like a bank or other money transfer service), the buyer meets the seller in real life and pays with cash.
| |
| − | | |
| − | This introduces some important practical differences. The rules above still apply, but keep in mind the suggestions and guidelines below.
| |
| − | | |
| − | === Meeting your trading partner ===
| |
| − | Doing a transaction face-to-face means you’ll be coming within close proximity of a stranger to exchange relatively substantial value.
| |
| − | | |
| − | ==== Be safe ====
| |
| − | People do local, in-person commerce all the time, all over the world. Incidents are rare, but they do happen. You should be cognizant of risks and do your part to minimize potential harm.
| |
| − | | |
| − | '''Guard your data'''. When you set up a face-to-face payment account in Bisq, you’ll need to provide contact information so you can arrange a meeting with your trading partner. Make sure this information isn’t traceable back to your property or identity.
| |
| − | | |
| − | '''Meet in a neutral public place'''. Meeting your trading partner in a place with witnesses and security cameras significantly reduces the chance of an incident.
| |
| − | | |
| − | '''Don’t bring more than you need'''. Even in a public place, incidents can still happen, but you can limit the chance even further by limiting valuables on your person that would interest a thief in the first place.
| |
| − | | |
| − | '''Bring backup'''. Consider bringing a friend with you. Also, depending on the laws in your area & your own comfort, consider carrying a concealed tool for self-defense. Even pepper-spray can hobble a criminal just enough to get you out of immediate danger.
| |
| − | | |
| − | ==== Validate payment ====
| |
| − | Face-to-face trades are usually settled with cash. Cash is wonderfully anonymous, but it can be counterfeited. Be sure you know the basics of detecting counterfeit currency. For example, there are several characteristics of US dollar bills one can examine to quickly determine fakes with high accuracy.
| |
| − | | |
| − | You could look for tools like counterfeit pens to do the work for you, but make sure you do thorough research before picking one. Counterfeit pens, for example, are often not reliable.
| |
| − | | |
| − | If you’d rather not take the chance of carrying or accepting cash, consider meeting at a bank where you can validate a buyer’s payment on the spot.
| |
| − | | |
| − | ==== Ensure you follow Bisq protocol ====
| |
| − | Ultimately, the deal will be completed in Bisq. Buyers must mark payment as sent before sellers can release assets.
| |
| − | | |
| − | '''Buyers''' should bring a laptop with them so they can mark the payment as sent. Otherwise, the buyer will end up paying the seller and have to walk away without the bitcoin they paid for (since the seller won’t be able to acknowledge receipt of payment before the buyer acknowledges they sent payment).
| |
| − | | |
| − | '''Sellers''' should bring a laptop with their Bisq client running no matter what. Once they receive a legitimate payment, they’ll need to mark the payment as received so the assets are released to the buyer. No buyer will want to walk away after paying without proof of a complete deal.
| |
| − | | |
| − | === Disputes ===
| |
| − | The lack of verifiable actions makes handling face-to-face disputes much harder.
| |
| − | | |
| − | This is why we highly recommend that both parties bring laptops and acknowledge their ends of the deal on the spot.
| |
| − | | |
| − | Otherwise, the same dispute process is in place for F2F trades (see below), but be advised that mediators and arbitrators often won’t have a way to settle disputes. This means funds may be held indefinitely, or until both parties can reach an agreement.
| |
| − | | |
| − | Mediators and arbitrators may attempt different tactics to get a handle on the situation. For example, they may ask a potential scammer for ID verification, which is a request a real scammer probably wouldn’t comply with.
| |
| − | | |
| − | = Dispute Resolution =
| |
| − | Dispute resolution on Bisq has 3 layers: trader chat, mediation, and arbitration.
| |
| − | | |
| − | Most issues on Bisq are minor and easily resolved when traders communicate with each other. Mediation is intended to resolve the vast majority of remaining issues. Arbitration is a rare last resort measure for extreme scenarios.
| |
| − | | |
| − | Bisq v1.2 introduced a new trade protocol which changed 2 key elements:
| |
| − | * trade funds (deposits, trade amount, and fees) are locked in a 2-of-2 multisig escrow
| |
| − | * a time-locked transaction to pay out all trade funds is made which is publishable in 10 days (altcoin trades) and 20 days (fiat trades)
| |
| − | | |
| − | Combined with trader chat, mediation, and arbitration, these 2 elements power Bisq’s dispute resolution.
| |
| − | | |
| − | If you used Bisq before v1.2, note that arbitration has changed significantly. Arbitrators no longer have a key to sign deposit funds to either peer. Please read the following sections carefully.
| |
| − | === Trader Chat ===
| |
| − | Direct end-to-end encrypted chat in Bisq allows traders to communicate with each other throughout the course of a trade to resolve trade issues quickly without involving a third party like a mediator or arbitrator.
| |
| − | | |
| − | [[File:Start-trader-chat.png|thumb|Start-trader-chat]]
| |
| − | | |
| − | This functionality was avoided for a while because of the risky nature of having 2 internet strangers communicate with each other, but we aim to mitigate these risks with the following rules:
| |
| − | | |
| − | * Responding to chat messages is always optional
| |
| − | ** If you’re not comfortable responding to chat messages, don’t respond. You have no obligation to communicate over this medium.
| |
| − | | |
| − | * Do not send links of any kind
| |
| − | ** For safety. If you want to send a link, describe it instead.
| |
| − | ** ''Not allowed'':
| |
| − | *** https://blockstream.info/tx/4b5417ec5ab6112bedf539c3b4f5a806ed539542d8b717e1c4470aa3180edce5
| |
| − | ** ''Allowed'':
| |
| − | *** Hey, could you look up txid 4b5417ec5ab6112bedf539c3b4f5a806ed539542d8b717e1c4470aa3180edce5 in your favorite block explorer?
| |
| − | | |
| − | * Do not encourage trading away from Bisq
| |
| − | ** Trades away from Bisq lack Bisq’s security mechanisms. If something goes wrong with an off-Bisq trade, you’re on your own.
| |
| − | | |
| − | * Do not send sensitive information like private keys, passwords, etc
| |
| − | ** Such information is never wise to share in general, and is ''never'' needed to solve trade disputes on Bisq.
| |
| − | | |
| − | * Do not attempt social engineering exploits
| |
| − | ** Any attempts to engage in foul play are prohibited.
| |
| − | | |
| − | * Respect a peer’s decision to avoid responding
| |
| − | ** If a peer seems unresponsive, or has signaled their intention to refrain from chatting, please respect it and don’t pressure them.
| |
| − | | |
| − | * Keep conversation scope limited to the trade
| |
| − | ** Please don’t use Bisq’s trader chat as a general-purpose messenger. Unnecessary exchanges add unnecessary strain to Bisq’s peer-to-peer network.
| |
| − | | |
| − | *Keep conversation friendly and respectful
| |
| − | ** Because friendlier traders resolve disputes quicker, and no one wants to deal with a jerk.
| |
| − | | |
| − | Hopefully, by following these rules, you can work directly with your trading peer to solve issues quickly and amicably.
| |
| − | | |
| − | If not, you may need to engage a mediator.
| |
| − | | |
| − | === Mediation ===
| |
| − | [[File:Start-mediation.png|thumb|Start mediation.]]
| |
| − | If trading peers cannot resolve issues on their own with trader chat, mediation is the next step.
| |
| − | | |
| − | ==== How Mediation Works ====
| |
| − | A mediator’s job is to evaluate a trade situation between two users and make a ''suggestion'' for a payout. Mediators do not have a key in the multisig escrow, so their suggested payout cannot be authoritative.
| |
| − | | |
| − | Trading peers should do their best to cooperate with the mediator and provide information they request, and are required to respond to messages within 48 hours.
| |
| − | | |
| − | Likewise, '''mediators may take up to 48 hours to respond to your messages'''. Please don’t panic if you don’t hear back immediately.
| |
| − | | |
| − | When a mediator suggests a payout:
| |
| − | * if both peers agree with the suggestion, the payout is completed and the trade is closed
| |
| − | * if one or both peers disagree with the suggestion, a peer can choose to engage an arbitrator to re-evaluate the situation (see arbitration below)
| |
| − | ** You don’t have to wait for the end of a trading period to request help from a mediator. You can engage a mediator at any point during the trading period, for example, if your trading peer’s chats make you feel uncomfortable.
| |
| − | ** But please be patient—for example, it’s not strictly against the rules for a buyer to send payment toward the end of the trade period, so engaging a mediator during the trade period (for this reason) may not be productive.
| |
| − | | |
| − | ==== Who Are Mediators? ====
| |
| − | [[Mediator]] roles are bonded roles in the Bisq DAO. Anyone can propose to become a mediator, but approval will depend on the network’s need for more mediators at the time a [[Proposals]] is made.
| |
| − | | |
| − | Once a proposal to become a mediator is approved by DAO voting, the mediator must lock a 10 000 BSQ bond to become active. This bond helps to ensure their continued availability and performance in the role, and can be confiscated by DAO voting in extreme circumstances (negligence, foul play, prolonged absence, etc).
| |
| − | | |
| − | You can see more details (current role owners, regular updates, etc) on the [https://github.com/bisq-network/roles/issues/83 mediator role issue].
| |
| − | | |
| − | === Arbitration ===
| |
| − | {{{:Arbitration}}}
| |
| − | | |
| − | == Dispute Process: What to Expect ==
| |
| − | When engaging with a mediator or arbitrator, you may be asked to provide various proofs of a payment transaction.
| |
| − | | |
| − | * Please note that the measures below are for real disputes, that is, when the very existence of a payment is disputed. Such cases are rare.
| |
| − | * The vast majority of disputes on Bisq are minor mistakes or issues that don’t require the measures below.
| |
| − | | |
| − | === "Notarized" bank site ===
| |
| − | [https://tlsnotary.org/pagesigner.html PageSigner] is a browser extension that allows users to "notarize" web pages, so that you can provide tamper-proof evidence that a particular website rendered particular information. This is helpful for Bisq buyers and sellers to prove whether they did (or didn’t) send or receive fiat payments.
| |
| − | | |
| − | A buyer claiming to have made a payment needs to send proof that they transferred the correct amount with the correct reference text. A seller claiming to have not received payment needs to show proof in the form of their transaction history (filtered by the offer ID, with trade period specified for time period).
| |
| − | | |
| − | PageSigner outputs a ''.pgsg'' file you can send to a mediator or arbitrator.
| |
| − | | |
| − | If it isn’t possible to generate the required proof with PageSigner, the user will be asked to request a digitally-signed statement from their bank with evidence of their position.
| |
| − | | |
| − | At this point, if there is no obvious resolution, both users will be asked to check with their banks to determine if the transaction was blocked or delayed by the bank. If it was, a mediator or arbitrator may allow the user more time to handle the issue with their bank.
| |
| − | | |
| − | '''The following measures are even more rare, but we document them here just in case.''' Fiat payment methods are tied tightly to identity, unfortunately, and if other payment verification methods fail, identity verification may be the only possible way to determine the veracity of two peers' claims.
| |
| − | | |
| − | === Video ID verification ===
| |
| − | A mediator or arbitrator may ask the user to send a picture of themself ("selfie") holding scans of 2 government-issued IDs (front and back). At least one of the documents must include a photo.
| |
| − | | |
| − | If a user can produce such a photo, they may then be asked to have a video chat with both documents so the mediator or arbitrator can compare the photo on the IDs to the user’s face on video.
| |
| − | | |
| − | Mediators and arbitrators are not required to reveal who they are.
| |
| − | | |
| − | * Remember—people in these roles have locked bonds to ensure their honesty, so knowing their identity isn’t necessary. If you suspect foul play, know that confiscating their bond is a possible remedy.
| |
| − | If one peer fails to successfully verify themself, the case will be decide in favor of the other peer (assuming that peer can verify their identity).
| |
| − | | |
| − | === Video transaction verification ===
| |
| − | If both peers pass identity verification, the next step is to show a mediator or arbitrator the relevant bank account web page with evidence of the payment in question (or lack thereof) on a screen-share or video-chat.
| |
| − | | |
| − | === Closure ===
| |
| − | If the arbitrator decides a payout is deserved by the user who requested arbitration, they will make the payout to the user and then request reimbursement from the Bisq DAO.
| |
