unclaimPayment

Release this wallet’s claim on an unpaid order, so that the payment can be handed off to another wallet.

The merchant is asked to release the order, and the operation returns a public taler://pay/ URI for the order that contains no private nonce. Another wallet can use this URI with preparePayForUriV2 to claim and pay the order instead. The payment can only be released before it is paid; use reclaimPayment to claim the order again for this wallet.

Request:

The args must be an UnclaimPaymentRequest object.

Response:

On success, the result is an UnclaimPaymentResult object.

Side effects:

Unclaims the payment at the merchant and generates a taler://pay URI that allows another wallet to complete it; changes the transaction state.

Expected errors:

The caller can handle the following errors inline: WALLET_TRANSACTION_NOT_FOUND, WALLET_REQUEST_TRANSACTION_STATE_UNSUPPORTED, WALLET_CORE_REQUEST_CANCELLED, WALLET_UNEXPECTED_REQUEST_ERROR.

interface UnclaimPaymentRequest {
  // Transaction identifier of the payment to release.
  transactionId: TransactionIdStr;

  // Enables progress correlation and cancellation through
  // cancelProgressToken.
  progressToken?: string;
}

interface UnclaimPaymentResult {
  // Public taler://pay/ URI that another wallet can claim.
  talerPayUri: TalerUriString;
}