[bisq-network/bisq-docs] Update arbitration rules (#150)

Steve Jain notifications at github.com
Wed Aug 7 18:34:44 UTC 2019


m52go requested changes on this pull request.

Overall I think it's a good start. I'll probably follow this PR with some refinements.

>  
 This document covers the rules and expectations for each role, as well as details on the process for arbitrating disputes.
 
-== Offer maker
+== BTC buyer
 

I think we should add the following to this section:

* Payment should be completed reasonably early within the trade period, such that the seller has time to acknowledge receipt of the payment before the trade period is over. Waiting until the end of the trade period to make a payment is not acceptable, as then the seller cannot reasonably act in time. The lengths of trade periods vary based on payment method. See details [here](https://bisq.network/faq/#trade-periods).
* Any fees charged to make the payment are the buyer's responsibility to pay.

>  
-_Coming soon._
+* Must make payment from the account used to make/take the offer. The identifiers must match.

I would specify what "identifiers" means, because it's rather vague and a new user might confuse it with the trade ID. 

Perhaps say something like "The account information (e.g., name, account number, etc) must match".

>  
-_Coming soon._
+* Must make payment from the account used to make/take the offer. The identifiers must match.
+* Must enter the correct reference text in the payment transfer.

I would say "trade ID" instead of "reference text" and specify it as "reason for payment".

`Must enter the trade ID in the payment transfer "reason for payment" if possible.`

> @@ -4,28 +4,59 @@
 
 _This document is under development. Subscribe to https://github.com/bisq-network/bisq-docs/issues/80[bisq-network/bisq-docs#80] for updates._
 
-To trade on Bisq, you assume one of two roles. You either make a new offer to buy or sell an asset (offer maker), or you agree to accept an existing offer to buy or sell an asset (offer taker).
+To trade on Bisq, you assume one of two roles. You either buy (BTC buyer) or sell (BTC seller) bitcoin.
 
 This document covers the rules and expectations for each role, as well as details on the process for arbitrating disputes.
 

I would add the following:

```
IMPORTANT: Under **no circumstances** should you try to contact a trader using the contact information in their payment details, even if you have an issue with a trade. Always go through an arbitrator. Many people use Bisq for its high degree of privacy, and discussing Bisq away from Bisq is highly likely to compromise that privacy.

NOTE: The rules listed 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!
```

>  
-_Coming soon._
+* Must make payment from the account used to make/take the offer. The identifiers must match.
+* Must enter the correct reference text in the payment transfer.
+* Must click "Payment started" after having done so.

"Must click the "Payment started" button after making the payment" would be more clear, I think.

>  
-_Coming soon._
+* Must make payment from the account used to make/take the offer. The identifiers must match.
+* Must enter the correct reference text in the payment transfer.
+* Must click "Payment started" after having done so.
+* Is responsible for providing the arbitrator with tamper proof evidence of their payment in case of dispute.

This might raise more questions than it answers, as we're not detailing what "tamper-proof evidence" is. 

I would remove and just say "In case of a dispute, buyer must collaborate with the arbitrator, responding to inquiries within 48 hours and providing materials as requested to determine an outcome."

>  
-_Coming soon._
+* Must make payment from the account used to make/take the offer. The identifiers must match.
+* Must enter the correct reference text in the payment transfer.
+* Must click "Payment started" after having done so.
+* Is responsible for providing the arbitrator with tamper proof evidence of their payment in case of dispute.
+* Must be available, in case of dispute, 48 hours after the max. trade period runs out.

Lines 17 and 18 could probably be removed if you agree with the edit suggested above.

>  
-_Coming soon._
+* Must click "Confirm payment" after having received it. Has till the end of the max. trade period to do so.
+* Must be available, in case of dispute, 48 hours after the max. trade period runs out.

"In case of a dispute, seller must collaborate with the arbitrator, responding to inquiries within 48 hours and providing materials as requested to determine an outcome."

Same as above. If you agree, lines 23 and 24 could be replaced with this.

>  
-_Coming soon._
+* Must click "Confirm payment" after having received it. Has till the end of the max. trade period to do so.
+* Must be available, in case of dispute, 48 hours after the max. trade period runs out.
+* Has 48 hours to respond to each arbitrator inquiry.
 
 == Arbitration
 
 When trading partners cannot successfully complete a trade on their own, the trade is disputed, and an arbitrator steps in to determine a solution.

I would make the following section another big list, with the following introduction:

```
When trading partners cannot successfully complete a trade on their own, the trade is disputed, and an arbitrator steps in to determine a solution.

The following are possible circumstances and resulting outcomes.
```

>  
 == Arbitration
 
 When trading partners cannot successfully complete a trade on their own, the trade is disputed, and an arbitrator steps in to determine a solution.
 
-_Coming soon. For now, you can read more about the arbitration process https://bisq.network/faq/#8[here]._
+=== Confirm payment
+
+**The BTC buyer didn't confirm sending the funds and let the trade duration limit run out**

Need to add a new line in between the bold line and the next line, otherwise, both lines appear on the same line when compiled to HTML.

>  
 == Arbitration
 
 When trading partners cannot successfully complete a trade on their own, the trade is disputed, and an arbitrator steps in to determine a solution.
 
-_Coming soon. For now, you can read more about the arbitration process https://bisq.network/faq/#8[here]._
+=== Confirm payment
+
+**The BTC buyer didn't confirm sending the funds and let the trade duration limit run out**
+The arbitrator can release all the escrow funds to the BTC seller.
+
+**The BTC seller didn't release the trade funds by confirming receipt of the funds and let the trade duration limit run out**

Same here, add new line after bold line.

>  
 == Arbitration
 
 When trading partners cannot successfully complete a trade on their own, the trade is disputed, and an arbitrator steps in to determine a solution.
 
-_Coming soon. For now, you can read more about the arbitration process https://bisq.network/faq/#8[here]._
+=== Confirm payment

Remove this heading?

>  
 == Arbitration
 
 When trading partners cannot successfully complete a trade on their own, the trade is disputed, and an arbitrator steps in to determine a solution.
 
-_Coming soon. For now, you can read more about the arbitration process https://bisq.network/faq/#8[here]._
+=== Confirm payment
+
+**The BTC buyer didn't confirm sending the funds and let the trade duration limit run out**
+The arbitrator can release all the escrow funds to the BTC seller.
+
+**The BTC seller didn't release the trade funds by confirming receipt of the funds and let the trade duration limit run out**
+The BTC buyer is responsible to provide the arbitrator with proof of their payment. If they fail to do so and the BTC seller says they haven't received any funds, the BTC seller gets all the funds in escrow.
+The BTC seller has 48 hours after the end of the max. trade period to respond as to whether they have or not received the funds. After that the arbitrator can sign a transaction releasing all funds in escrow to the BTC buyer.
+
+Any effort to reach out to the arbitrators on the Bisq software should be replicated on the link:https://bisq.community/t/arbitrators/8074[forum] as to circumvent network issues.
+When facing any issue that stops you, as the BTC seller or buyer, from fulfilling your role during the trade period, a dispute should be opened immediately by pressing ctrl+o on the Portfolio > Open Trades screen.
+
+=== Failure to follow the trade protocol

Remove this heading too?

> -_Coming soon. For now, you can read more about the arbitration process https://bisq.network/faq/#8[here]._
+=== Confirm payment
+
+**The BTC buyer didn't confirm sending the funds and let the trade duration limit run out**
+The arbitrator can release all the escrow funds to the BTC seller.
+
+**The BTC seller didn't release the trade funds by confirming receipt of the funds and let the trade duration limit run out**
+The BTC buyer is responsible to provide the arbitrator with proof of their payment. If they fail to do so and the BTC seller says they haven't received any funds, the BTC seller gets all the funds in escrow.
+The BTC seller has 48 hours after the end of the max. trade period to respond as to whether they have or not received the funds. After that the arbitrator can sign a transaction releasing all funds in escrow to the BTC buyer.
+
+Any effort to reach out to the arbitrators on the Bisq software should be replicated on the link:https://bisq.community/t/arbitrators/8074[forum] as to circumvent network issues.
+When facing any issue that stops you, as the BTC seller or buyer, from fulfilling your role during the trade period, a dispute should be opened immediately by pressing ctrl+o on the Portfolio > Open Trades screen.
+
+=== Failure to follow the trade protocol
+
+==== The BTC buyer sent the funds to the wrong identifiers

Maybe make these sub-titles into regular bold text, like the 2 items above.

-- 
You are receiving this because you are subscribed to this thread.
Reply to this email directly or view it on GitHub:
https://github.com/bisq-network/bisq-docs/pull/150#pullrequestreview-272098453
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.bisq.network/pipermail/bisq-github/attachments/20190807/02ead4ba/attachment-0001.html>


More information about the bisq-github mailing list