Void an Authorization

Close an authorization that you will not capture. The operator can call void at any time to return all remaining capturable funds. If the operator becomes inactive, the payer can call reclaim at or after authorizationExpiry.

Demo

The demo above is mock only. If you want to see onchain demos on Vibenet, head to Base chain demos.

Path	Caller	Available when
`void(paymentInfo)`	Operator	Any time a capturable balance remains
`reclaim(paymentInfo)`	Payer	At or after `authorizationExpiry`

Void the Remaining Authorization

void returns the complete capturableAmount; there is no partial-void operation. Capture the final fulfilled amount first, then void the remainder.

TypeScript

export async function voidAuthorization(payment: StoredProtocolPayment) {
  const [, capturableAmount] = await publicClient.readContract({
    address: AUTH_CAPTURE_ESCROW,
    abi: authCaptureEscrowAbi,
    functionName: "paymentState",
    args: [payment.paymentInfoHash],
  });
  if (capturableAmount === 0n) throw new Error("Authorization has no remaining funds");
  const simulation = await publicClient.simulateContract({
    account,
    address: AUTH_CAPTURE_ESCROW,
    abi: authCaptureEscrowAbi,
    functionName: "void",
    args: [payment.paymentInfo],
  });
  const hash = await walletClient.writeContract(simulation.request);
  const receipt = await publicClient.waitForTransactionReceipt({ hash, confirmations: 2 });
  if (receipt.status !== "success") throw new Error("Payment void reverted");
  return receipt;
}

Both void and reclaim set capturableAmount to zero while leaving any previously captured refundableAmount unchanged.

Verify PaymentVoided or PaymentReclaimed, and match its amount to the capturable balance immediately before the return.

After authorization expiry, the operator and payer can race to return the same remainder through void or reclaim. One succeeds and the other reverts with ZeroAuthorization; process either event idempotently as the terminal authorization return.

Authorize a Payment

Configure the authorization and recovery windows.

Refund a Payment

Return value that was already captured.

Overview

Integrate DeFi

Tokenize Assets

Issue Stablecoins

Accept Payments

Demo

Void the Remaining Authorization

See Also

Authorize a Payment

Refund a Payment

​Demo

​Void the Remaining Authorization

​See Also

Authorize a Payment

Refund a Payment

Demo

Void the Remaining Authorization

See Also