spec Gone response for order status

1 files changed, 12 insertions, 1 deletions

diff --git a/core/api-merchant.rst b/core/api-merchant.rst
index 381e17bd..db1bf9cb 100644
--- a/core/api-merchant.rst
+++ b/core/api-merchant.rst
@@ -1409,6 +1409,8 @@ Payment processing
     The response is a `StatusUnpaidResponse`.
   :status 403 Forbidden:
     The ``h_contract`` (or the ``token`` for unclaimed orders) does not match the order.
+  :status 410 Gone:
+    The response is a `StatusGoneResponse`.
   :status 404 Not found:
     The merchant backend is unaware of the order.
   :status 406 Not Acceptable:
@@ -1436,7 +1438,7 @@ Payment processing
 
   .. ts:def:: StatusUnpaidResponse
 
-    interface StatusUnpaid {
+    interface StatusUnpaidResponse {
       // URI that the wallet must process to complete the payment.
       taler_pay_uri: string;
 
@@ -1446,6 +1448,15 @@ Payment processing
 
     }
 
+  .. ts:def:: StatusGoneResponse
+
+    // The client tried to access the order via the claim
+    // token (and not a valid h_contract), but the order can't be claimed
+    // anymore, as it is already paid.
+    interface StatusGoneResponse {
+      // Fulfillment URL for the order.
+      fulfillment_url: string;
+    }
 
   .. ts:def:: MerchantCoinRefundStatus