taler-docs

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

post-unregistration.rst (955B)

      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       // Current timestamp in the ISO 8601
     14       timestamp: string;
     15 
     16       // Public key used for registration
     17       authorization_pub: EddsaPublicKey;
     18 
     19       // Signature of the timestamp using the authorization_pub private key
     20       // Prevent replay attack
     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:`404 Not found`:
     31       Unknown registration.
     32   :http:statuscode:`409 Conflict`:
     33       * ``TALER_EC_BANK_OLD_TIMESTAMP``: the timestamp is too old.
     34       * ``TALER_EC_BANK_BAD_SIGNATURE``: signature is invalid.