Core Concepts

import { PaymentState } from '@x402r/core';

// PaymentState values:
PaymentState.NonExistent  // 0 - Payment doesn't exist
PaymentState.InEscrow     // 1 - Funds held in escrow
PaymentState.Released     // 2 - Funds released to merchant
PaymentState.Settled      // 3 - Payment fully settled
PaymentState.Expired      // 4 - Payment expired

interface PaymentInfo {
  operator: `0x${string}`;          // PaymentOperator contract address
  payer: `0x${string}`;             // Payer's address
  receiver: `0x${string}`;          // Merchant's address
  token: `0x${string}`;             // Payment token (e.g., USDC)
  maxAmount: bigint;                // Maximum payment amount
  preApprovalExpiry: bigint;        // Pre-approval expiry timestamp (0n if not used)
  authorizationExpiry: bigint;      // When payer can reclaim funds
  refundExpiry: bigint;             // Deadline for refund requests
  minFeeBps: number;                // Minimum fee in basis points
  maxFeeBps: number;                // Maximum fee in basis points
  feeReceiver: `0x${string}`;      // Address that receives fees
  salt: bigint;                     // Unique salt for this payment
}

import { X402rClient } from '@x402r/client';

// Check when payment was authorized
const authTime = await client.getAuthorizationTime(paymentInfo, escrowPeriodAddress);

// Check if still within escrow period
const inEscrow = await client.isDuringEscrowPeriod(paymentInfo, escrowPeriodAddress);
if (!inEscrow) {
  console.log('Escrow period has passed - funds can be released');
}

import { RequestStatus } from '@x402r/core';

// RequestStatus values:
RequestStatus.Pending    // 0 - Awaiting decision
RequestStatus.Approved   // 1 - Approved by merchant/arbiter
RequestStatus.Denied     // 2 - Denied by merchant/arbiter
RequestStatus.Cancelled  // 3 - Cancelled by payer

// Request refund for the first charge
await client.requestRefund(paymentInfo, amount, 0n);

// Check status for the first charge
const status = await client.getRefundStatus(paymentInfo, 0n);

// Payer freezes payment (requires payer authorization)
await client.freezePayment(paymentInfo, freezeAddress);

// Merchant unfreezes payment (requires receiver authorization)
await merchant.unfreezePayment(paymentInfo, freezeAddress);

// Check frozen status
const frozen = await client.isFrozen(paymentInfo, freezeAddress);