From 3e8ca50bb60de1f47cc3380dc3db331399ce1178 Mon Sep 17 00:00:00 2001 From: Christian Grothoff Date: Tue, 23 Jun 2020 19:51:32 +0200 Subject: document status codes used that were missing --- core/api-merchant.rst | 11 +++++++++++ 1 file changed, 11 insertions(+) (limited to 'core') 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. -- cgit v1.2.3