taler-docs

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

post-unregistration.rst (1012B)

      1 .. http:post:: /unregistration
      2 
      3   Remove an existing registered public key for wire transfer use.
      4 
      5   Use this endpoint to free a derived subject or cancel a recurrent paiment.
      6 
      7 
      8   **Request:**
      9 
     10   .. ts:def:: Unregistration
     11 
     12     interface Unregistration {
     13       timestamp: Timestamp;
     14 
     15       // Public key used for registration
     16       authorization_pub: EddsaPublicKey;
     17 
     18       // This is a signature over
     19       // a struct `TALER_PreparedTransferUnregisterPS` with purpose
     20       // ``TALER_SIGNATURE_WALLET_PREPARED_TRANSFER_UNREGISTER``.
     21       authorization_sig: EddsaSignature;
     22     }
     23 
     24   **Response:**
     25 
     26   :http:statuscode:`204 No content`:
     27       The registration have been deleted.
     28   :http:statuscode:`400 Bad request`:
     29       Input data was invalid.
     30   :http:statuscode:`403 Forbidden`:
     31       * ``TALER_EC_BANK_BAD_SIGNATURE``: signature is invalid.
     32   :http:statuscode:`404 Not found`:
     33       Unknown registration.
     34   :http:statuscode:`409 Conflict`:
     35       * ``TALER_EC_BANK_OLD_TIMESTAMP``: the timestamp is too old.