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.

This guide’s payment flow is based on the Commerce Payments Protocol.

Demo

The demo above sends real transactions on Base Vibenet, an ephemeral devnet, each time you press a step. It mints Vibenet’s existing USDV test token, not USDC, and authorizes its own payment before voiding it; your browser’s Vibenet demo account acts as both payer and operator. If Vibenet is unavailable, the demo runs as a labeled offline mock and sends nothing.

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

Private Transactions

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