Javadoc
The discard_transferToken API is a client API used to discard a
transferToken obtained through the get_transferToken API at the same
node. This API accepts either a transferToken or a keyBag as parameters
to remove the permission to transfer data associated with a particular
transferToken. If a keyBag is provided, all tokens corresponding to the
keys in the keyBag will be discarded and will no longer be valid for
custody or ownership transfer after the discard_transferToken is
processed, irrespective of whether the keys match any known business or
tmodelKey values. In the event that the keyBag represents a subset of the
keyBag for one or more transferToken elements, the transferToken is
discarded and will no longer be valid for transferring any entity. If the
token passed in the transferToken argument does not match an existing
token known to the system, no action is taken and success is reported.
Keys in the keyBag argument that do not have a corresponding token are
ignored.