document status codes used that were missing

1 files changed, 11 insertions, 0 deletions

diff --git a/core/api-merchant.rst b/core/api-merchant.rst
index d1fa3406..1c99a79e 100644
--- a/core/api-merchant.rst
+++ b/core/api-merchant.rst
@@ -868,15 +868,26 @@ Payment processing
     Either the client request is malformed or some specific processing error
     happened that may be the fault of the client as detailed in the JSON body
     of the response.
+  :status 402 Payment required:
+    There used to be a sufficient payment, but due to refunds the amount effectively
+    paid is no longer sufficient. (If the amount is generally insufficient, we
+    return "406 Not Acceptable", only if this is because of refunds we return 402.)
   :status 403 Forbidden:
     One of the coin signatures was not valid.
   :status 404 Not found:
     The merchant backend could not find the order or the instance
     and thus cannot process the payment.
+  :status 406 Not Acceptable:
+    The payment is insufficient (sum is below the required total amount).
+  :status 408 Request Timeout:
+    The backend took too long to process the request. Likely the merchant's connection
+    to the exchange timed out. Try again.
   :status 409 Conflict:
     The exchange rejected the payment because a coin was already spent before.
     The response will include the ``coin_pub`` for which the payment failed,
     in addition to the response from the exchange to the ``/deposit`` request.
+  :status 410 Gone:
+    The offer has expired and is no longer available.
   :status 412 Precondition Failed:
     The given exchange is not acceptable for this merchant, as it is not in the
     list of accepted exchanges and not audited by an approved auditor.