taler-docs

Documentation for GNU Taler components, APIs and protocols
Log | Files | Refs | README | LICENSE

delete-purses-PURSE_PUB.rst (989B)

      1 .. http:delete:: /purses/$PURSE_PUB
      2 
      3   Delete a purse that is unmerged and not yet expired. Refunds any money that
      4   is already in the purse.
      5 
      6   **Request:**
      7 
      8   The request body must be empty, as recommended for HTTP delete in general.
      9 
     10   To authorize the request, the header must contain the following HTTP header:
     11 
     12   *Taler-Purse-Signature*:
     13     $PURSE_SIG`` where ``$PURSE_SIG`` is the Crockford base32-encoded EdDSA
     14     signature of purpose TALER_SIGNATURE_WALLET_PURSE_DELETE.
     15 
     16   **Response:**
     17 
     18   :http:statuscode:`204 No Content`:
     19     The operation succeeded, the exchange confirms that the purse
     20     was deleted.
     21   :http:statuscode:`403 Forbidden`:
     22     The signature is invalid.
     23     This response comes with a standard `ErrorDetail` response.
     24   :http:statuscode:`404 Not Found`:
     25     The purse is not known. Might have already been deleted previously.
     26   :http:statuscode:`409 Conflict`:
     27     It is too late to delete the purse, its fate (merge or expiration)
     28     was already decided.