web-bitdeals-content/md/en-US/manual.md

## User manual

### 1. Creating a deal

A deal can be created on a site with BitDeals support, or in our [Deal Module](https://git.bitdeals.org/private/apostol-dm) web interface.

The deals can be two types: In a **Prepayment** deal a seller receives your money before receiving your feedback. In a **Postpayment** deal - after, and there is possible a customer to refund money in case of a dispute depending of a deal arbitrator's decision. If a customer leave a negative feedback, but an arbitrator is not involved in the deal, the money goes to our favor.

After payment of a deal amount, the order state changes from **Created** to **Paid**. And then to **Completed** immediately, or after your feedback in Postpayment deals.

After a deal creation is necessary to verify its signature, we sign all our deals with our [PGP key](https://bitdeals.org/pgp) digital signature. The example of new signed deal is available hereinafter.

An users identificators in a deals are their bitcoin addresses. Check your bitcoin address is participating in your deal as a customer.

Also pay attention to a users **rating**, consisting of the number of deals and number of successfully completed deals from the last hundred.

The deal states a bitcoin sum and payment address. For accept deal payment a transaction should be confirmed by inclusion in one bitcoin block for a time stated in "**until**" field, otherwise the deal will be Canceled and the payment will be sent back to the customer's address.

Please check a deal "**leave-before**" field date, before which your feedback may affect the deal money distribution.

An example of deal data:

```
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA512

BitDeal:
  order: Created
  type: Postpayment
  at: http://example.com
  date: 2020-01-01 12:00:00 UTC
  seller:
    address: mjTbMV3cbjtGxYMKV2uKZpZt5v7LRp8TBJ
    rating: 200+, 99%
  customer:
    address: mukvhKgb6CVz36o7Cnu1pnzckqktf7dwcU
    rating: 10, 100%
  payment:
    address: 3N376PKK9qWaX6MSjF9XTKNQRhpeDfD89jg
    until: 2020-01-02 12:00:00 UTC
    sum: 0.0123 BTC
  feedback:
    leave-before: 2020-02-02 12:00:00 UTC

-----BEGIN PGP SIGNATURE-----
Version: cc

iQEzBAEBCgAdFiEEHx6AT+33g1dSZXThknAyJg0n59cFAl3CIXMACgkQknAyJg0n
59ffTQf/X98auPSoMmb76HIf3l1YCiG5KL27ohBf1GiMQfKgWtpE6CTb6RkiGjld
ziSzCq9+y8PZOrLdrgd+ZiKH/hVrJ40BrQNfqtAA3xv+MwzbZ28J0UbVlVIQlHto
+/8waZaHUsZoXi/Z7xEs=
=QVjJ
-----END PGP SIGNATURE-----
```

### 2. Leaving a deal feedback

In addition to the possibility of **leave feedback on a site that created the deal**, if necessary, you can leave a negative deal feedback through [our site](https://bitdeals.org) or by Bitmessage bot. For this, send a signed by the customer's private bitcoin key message to the bot with "**negative**" in the subject and the deal payment address and your feedback text line in the message body (see example). The bots addresses are specified in our [PGP key](https://bitdeals.org/pgp) comments. 

An example of negative feedback message:

```
3D2oetdNuZUqQHPJmcMDDHYoqkyNVsFk9r
Save yourself the trouble!
H9n843mvWrnK70Vudo8IyI0UhIfy4CpKSW8m10S5LfksKBfnGp6NYh7alg+M8hboefnGY1WM=
```

### 3. Seller cancellation of a deal

If you can't perform a deal, **you can cancel it**. Canceling a deal affects your rating and there is no fee on a Canceled deals.

For cancel a deal you should send a signed by the seller's private bitcoin key message with "**cancel**" in the subject and the deal payment address and your cancel reason text line in the message body (see example). The bots addresses are specified in our [PGP key](https://bitdeals.org/pgp) comments.

The message format is equal to feedback message in the example above.

### 4. Deal creation trust system

The trust system is based on a list of sites you trust to create a deals with your participation.

With new user registration on a site, the site URL is added to the trust list automatically.

The account data changes takes place through [our site](https://bitdeals.org) or Bitmessage bot. The bots addresses are specified in our [PGP key](https://bitdeals.org/pgp) comments. For add a site you need to send a signed by the user private bitcoin key message with "**update**" in the subject and current date and the site URL in the message body to the bot. More details about bot usage you can get by send a message to the bot containing "**help**" in the subject.

An example of add URL in trusted list message:

```
2020-01-01
https://example.org
H9n843mvWrnK70Vudo8IyI0UhIfy4CpKSW8m10S5LfksKBfnGp6NYh7alg+M8hboefnGY1WM=
```

### 5. User account registration

A new customer and seller registrations occurs automatically with deal creation.

For an account registration allowing **to create a deals and participate in them as arbitrator** you will need: bitcoin address, RSA PGP public key with your site URL in the key ID comment.

Your private PGP key must be used by [Deal Module](https://git.bitdeals.org/private/apostol-dm) on your site to sign deals. If necessary, you can change your account PGP key.

The account registration takes place through [our site](https://bitdeals.org) or Bitmessage bot. The bots addresses are specified in our [PGP key](https://bitdeals.org/pgp) comments. For registration you need to send a message with "**new**" in the subject to the bot containing stated account data in the message body. More details about bot usage you can get by send a message to the bot containing "**help**" in the the subject.

In addition to the user account, you will need the [Deal Module](https://git.bitdeals.org/private/apostol-dm) - the program that provides an interfaces for creating and modifying user accounts and deals.

You can get the [Deal Module](https://git.bitdeals.org/private/apostol-dm) source code, here the [REST-API](https://git.bitdeals.org/private/apostol-dm/src/branch/master/doc/REST-API-ru.md) documentation, also the Docker image at [registry.bitdeals.org/apostol-dm](https://registry.bitdeals.org/) is available.