@402flow/sdk 0.1.0-alpha.1 → 0.1.0-alpha.10

package/dist/contracts.d.ts

@@ -5,13 +5,25 @@ export declare const settlementEvidenceClassSchema: z.ZodEnum<["none", "inconclu
 export type SettlementEvidenceClass = z.infer<typeof settlementEvidenceClassSchema>;
 export declare const fulfillmentStatusSchema: z.ZodEnum<["succeeded", "failed", "inconclusive"]>;
 export type FulfillmentStatus = z.infer<typeof fulfillmentStatusSchema>;
+export declare const receiptStatusSchema: z.ZodEnum<["confirmed", "provisional", "expired_unconfirmed", "refunded", "void"]>;
+export type ReceiptStatus = z.infer<typeof receiptStatusSchema>;
+export declare const receiptReconciliationStatusSchema: z.ZodEnum<["none", "required", "in_progress", "resolved", "refunded"]>;
+export type ReceiptReconciliationStatus = z.infer<typeof receiptReconciliationStatusSchema>;
 export declare const paymentProofSourceSchema: z.ZodEnum<["merchant", "local_simulation"]>;
 export type PaymentProofSource = z.infer<typeof paymentProofSourceSchema>;
+export declare const chainAttributionStrengthSchema: z.ZodEnum<["strong_request_scoped", "constrained_unique"]>;
+export type ChainAttributionStrength = z.infer<typeof chainAttributionStrengthSchema>;
+export declare const chainConfirmationSourceSchema: z.ZodEnum<["chain_observer"]>;
+export type ChainConfirmationSource = z.infer<typeof chainConfirmationSourceSchema>;
+export declare const chainFinalityLevelSchema: z.ZodEnum<["evm_block_confirmations_12"]>;
+export type ChainFinalityLevel = z.infer<typeof chainFinalityLevelSchema>;
+export declare const chainAttributionBasisSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+export type ChainAttributionBasis = z.infer<typeof chainAttributionBasisSchema>;
 export declare const paidRequestProtocolSchema: z.ZodEnum<["x402", "l402"]>;
 export type PaidRequestProtocol = z.infer<typeof paidRequestProtocolSchema>;
 export declare const paidRequestHttpMethodSchema: z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]>;
 export type PaidRequestHttpMethod = z.infer<typeof paidRequestHttpMethodSchema>;
-export declare const paidRequestReasonCodeSchema: z.ZodEnum<["policy_allow", "policy_denied", "policy_review_required", "payment_execution_in_progress", "preflight_incompatible", "merchant_rejected", "settlement_proof_conflict", "merchant_transport_lost", "payment_rail_missing", "payment_rail_wrong_organization", "payment_rail_disabled", "payment_rail_incompatible"]>;
+export declare const paidRequestReasonCodeSchema: z.ZodEnum<["policy_allow", "policy_denied", "policy_review_required", "payment_execution_in_progress", "preflight_incompatible", "merchant_rejected", "merchant_execution_failed", "settlement_proof_conflict", "merchant_transport_lost", "payment_rail_missing", "payment_rail_wrong_organization", "payment_rail_disabled", "payment_rail_incompatible"]>;
 export type PaidRequestReasonCode = z.infer<typeof paidRequestReasonCodeSchema>;
 export declare const defaultMoneyPrecision = 6;
 export declare const externalIdSchema: z.ZodString;
@@ -54,31 +66,22 @@ export type NormalizedMoney = z.infer<typeof normalizedMoneySchema>;
 export declare const paidRequestContextSchema: z.ZodObject<{
     organization: z.ZodString;
     agent: z.ZodString;
-    purpose: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, "strip", z.ZodTypeAny, {
     organization: string;
     agent: string;
-    purpose?: string | undefined;
+    description?: string | undefined;
     metadata?: Record<string, unknown> | undefined;
 }, {
     organization: string;
     agent: string;
-    purpose?: string | undefined;
+    description?: string | undefined;
     metadata?: Record<string, unknown> | undefined;
 }>;
 export type PaidRequestContext = z.infer<typeof paidRequestContextSchema>;
-export declare const paidRequestTargetSchema: z.ZodObject<{
-    merchant: z.ZodString;
-    paymentRail: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    merchant: string;
-    paymentRail: string;
-}, {
-    merchant: string;
-    paymentRail: string;
-}>;
-export type PaidRequestTarget = z.infer<typeof paidRequestTargetSchema>;
+export declare const paidRequestPaymentRailSchema: z.ZodString;
+export type PaidRequestPaymentRail = z.infer<typeof paidRequestPaymentRailSchema>;
 export declare const paidRequestHttpRequestSchema: z.ZodObject<{
     url: z.ZodString;
     method: z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]>;
@@ -101,93 +104,35 @@ export declare const paidRequestHttpRequestSchema: z.ZodObject<{
 export type PaidRequestHttpRequest = z.infer<typeof paidRequestHttpRequestSchema>;
 export declare const paidRequestChallengeSchema: z.ZodObject<{
     protocol: z.ZodEnum<["x402", "l402"]>;
-    money: z.ZodEffects<z.ZodObject<{
-        asset: z.ZodString;
-        amount: z.ZodString;
-        amountMinor: z.ZodString;
-        precision: z.ZodNumber;
-        unit: z.ZodLiteral<"minor">;
-    }, "strip", z.ZodTypeAny, {
-        asset: string;
-        amount: string;
-        amountMinor: string;
-        precision: number;
-        unit: "minor";
-    }, {
-        asset: string;
-        amount: string;
-        amountMinor: string;
-        precision: number;
-        unit: "minor";
-    }>, {
-        asset: string;
-        amount: string;
-        amountMinor: string;
-        precision: number;
-        unit: "minor";
-    }, {
-        asset: string;
-        amount: string;
-        amountMinor: string;
-        precision: number;
-        unit: "minor";
-    }>;
-    payee: z.ZodOptional<z.ZodString>;
-    memo: z.ZodOptional<z.ZodString>;
-    raw: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    body: z.ZodOptional<z.ZodUnknown>;
 }, "strip", z.ZodTypeAny, {
+    headers: Record<string, string>;
     protocol: "x402" | "l402";
-    money: {
-        asset: string;
-        amount: string;
-        amountMinor: string;
-        precision: number;
-        unit: "minor";
-    };
-    raw: Record<string, unknown>;
-    payee?: string | undefined;
-    memo?: string | undefined;
+    body?: unknown;
 }, {
     protocol: "x402" | "l402";
-    money: {
-        asset: string;
-        amount: string;
-        amountMinor: string;
-        precision: number;
-        unit: "minor";
-    };
-    payee?: string | undefined;
-    memo?: string | undefined;
-    raw?: Record<string, unknown> | undefined;
+    headers?: Record<string, string> | undefined;
+    body?: unknown;
 }>;
 export type PaidRequestChallenge = z.infer<typeof paidRequestChallengeSchema>;
 export declare const sdkPaymentDecisionRequestSchema: z.ZodObject<{
     context: z.ZodObject<{
         organization: z.ZodString;
         agent: z.ZodString;
-        purpose: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
         metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, "strip", z.ZodTypeAny, {
         organization: string;
         agent: string;
-        purpose?: string | undefined;
+        description?: string | undefined;
         metadata?: Record<string, unknown> | undefined;
     }, {
         organization: string;
         agent: string;
-        purpose?: string | undefined;
+        description?: string | undefined;
         metadata?: Record<string, unknown> | undefined;
     }>;
-    target: z.ZodObject<{
-        merchant: z.ZodString;
-        paymentRail: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        merchant: string;
-        paymentRail: string;
-    }, {
-        merchant: string;
-        paymentRail: string;
-    }>;
     request: z.ZodObject<{
         url: z.ZodString;
         method: z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]>;
@@ -209,77 +154,26 @@ export declare const sdkPaymentDecisionRequestSchema: z.ZodObject<{
     }>;
     challenge: z.ZodObject<{
         protocol: z.ZodEnum<["x402", "l402"]>;
-        money: z.ZodEffects<z.ZodObject<{
-            asset: z.ZodString;
-            amount: z.ZodString;
-            amountMinor: z.ZodString;
-            precision: z.ZodNumber;
-            unit: z.ZodLiteral<"minor">;
-        }, "strip", z.ZodTypeAny, {
-            asset: string;
-            amount: string;
-            amountMinor: string;
-            precision: number;
-            unit: "minor";
-        }, {
-            asset: string;
-            amount: string;
-            amountMinor: string;
-            precision: number;
-            unit: "minor";
-        }>, {
-            asset: string;
-            amount: string;
-            amountMinor: string;
-            precision: number;
-            unit: "minor";
-        }, {
-            asset: string;
-            amount: string;
-            amountMinor: string;
-            precision: number;
-            unit: "minor";
-        }>;
-        payee: z.ZodOptional<z.ZodString>;
-        memo: z.ZodOptional<z.ZodString>;
-        raw: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+        body: z.ZodOptional<z.ZodUnknown>;
     }, "strip", z.ZodTypeAny, {
+        headers: Record<string, string>;
         protocol: "x402" | "l402";
-        money: {
-            asset: string;
-            amount: string;
-            amountMinor: string;
-            precision: number;
-            unit: "minor";
-        };
-        raw: Record<string, unknown>;
-        payee?: string | undefined;
-        memo?: string | undefined;
+        body?: unknown;
     }, {
         protocol: "x402" | "l402";
-        money: {
-            asset: string;
-            amount: string;
-            amountMinor: string;
-            precision: number;
-            unit: "minor";
-        };
-        payee?: string | undefined;
-        memo?: string | undefined;
-        raw?: Record<string, unknown> | undefined;
+        headers?: Record<string, string> | undefined;
+        body?: unknown;
     }>;
+    paymentRail: z.ZodOptional<z.ZodString>;
     idempotencyKey: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     context: {
         organization: string;
         agent: string;
-        purpose?: string | undefined;
+        description?: string | undefined;
         metadata?: Record<string, unknown> | undefined;
     };
-    target: {
-        merchant: string;
-        paymentRail: string;
-    };
     request: {
         url: string;
         method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
@@ -288,30 +182,19 @@ export declare const sdkPaymentDecisionRequestSchema: z.ZodObject<{
         bodyHash?: string | undefined;
     };
     challenge: {
+        headers: Record<string, string>;
         protocol: "x402" | "l402";
-        money: {
-            asset: string;
-            amount: string;
-            amountMinor: string;
-            precision: number;
-            unit: "minor";
-        };
-        raw: Record<string, unknown>;
-        payee?: string | undefined;
-        memo?: string | undefined;
+        body?: unknown;
     };
+    paymentRail?: string | undefined;
     idempotencyKey?: string | undefined;
 }, {
     context: {
         organization: string;
         agent: string;
-        purpose?: string | undefined;
+        description?: string | undefined;
         metadata?: Record<string, unknown> | undefined;
     };
-    target: {
-        merchant: string;
-        paymentRail: string;
-    };
     request: {
         url: string;
         method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
@@ -321,17 +204,10 @@ export declare const sdkPaymentDecisionRequestSchema: z.ZodObject<{
     };
     challenge: {
         protocol: "x402" | "l402";
-        money: {
-            asset: string;
-            amount: string;
-            amountMinor: string;
-            precision: number;
-            unit: "minor";
-        };
-        payee?: string | undefined;
-        memo?: string | undefined;
-        raw?: Record<string, unknown> | undefined;
+        headers?: Record<string, string> | undefined;
+        body?: unknown;
     };
+    paymentRail?: string | undefined;
     idempotencyKey?: string | undefined;
 }>;
 export type SdkPaymentDecisionRequest = z.infer<typeof sdkPaymentDecisionRequestSchema>;
@@ -341,7 +217,7 @@ export declare const sdkReceiptSchema: z.ZodObject<{
     paymentAttemptId: z.ZodString;
     organizationId: z.ZodString;
     agentId: z.ZodString;
-    merchantId: z.ZodString;
+    merchantId: z.ZodOptional<z.ZodString>;
     protocol: z.ZodEnum<["x402", "l402"]>;
     money: z.ZodEffects<z.ZodObject<{
         asset: z.ZodString;
@@ -375,17 +251,33 @@ export declare const sdkReceiptSchema: z.ZodObject<{
         unit: "minor";
     }>;
     authorizationOutcome: z.ZodEnum<["allowed"]>;
+    status: z.ZodEnum<["confirmed", "provisional", "expired_unconfirmed", "refunded", "void"]>;
+    reconciliationStatus: z.ZodEnum<["none", "required", "in_progress", "resolved", "refunded"]>;
+    confirmationSource: z.ZodOptional<z.ZodEnum<["chain_observer"]>>;
+    attributionStrength: z.ZodOptional<z.ZodEnum<["strong_request_scoped", "constrained_unique"]>>;
+    attributionBasis: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    attributionRuleVersion: z.ZodOptional<z.ZodString>;
+    confirmedAt: z.ZodOptional<z.ZodString>;
+    finalityLevelUsed: z.ZodOptional<z.ZodEnum<["evm_block_confirmations_12"]>>;
     requestUrl: z.ZodString;
     requestMethod: z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]>;
+    canonicalSettlementKey: z.ZodOptional<z.ZodString>;
     paymentReference: z.ZodOptional<z.ZodString>;
     evidenceSource: z.ZodOptional<z.ZodEnum<["merchant", "local_simulation"]>>;
     settlementEvidenceClass: z.ZodOptional<z.ZodEnum<["none", "inconclusive", "merchant_verifiable_success", "settled"]>>;
     settlementIdentifier: z.ZodOptional<z.ZodString>;
+    supersededByReceiptId: z.ZodOptional<z.ZodString>;
     fulfillmentStatus: z.ZodOptional<z.ZodEnum<["succeeded", "failed", "inconclusive"]>>;
     createdAt: z.ZodString;
     completedAt: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
+    status: "confirmed" | "provisional" | "expired_unconfirmed" | "refunded" | "void";
     protocol: "x402" | "l402";
+    receiptId: string;
+    paidRequestId: string;
+    paymentAttemptId: string;
+    organizationId: string;
+    agentId: string;
     money: {
         asset: string;
         amount: string;
@@ -393,24 +285,34 @@ export declare const sdkReceiptSchema: z.ZodObject<{
         precision: number;
         unit: "minor";
     };
-    receiptId: string;
-    paidRequestId: string;
-    paymentAttemptId: string;
-    organizationId: string;
-    agentId: string;
-    merchantId: string;
     authorizationOutcome: "allowed";
+    reconciliationStatus: "none" | "refunded" | "required" | "in_progress" | "resolved";
     requestUrl: string;
     requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
     createdAt: string;
+    merchantId?: string | undefined;
+    confirmationSource?: "chain_observer" | undefined;
+    attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
+    attributionBasis?: Record<string, unknown> | undefined;
+    attributionRuleVersion?: string | undefined;
+    confirmedAt?: string | undefined;
+    finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
+    canonicalSettlementKey?: string | undefined;
     paymentReference?: string | undefined;
     evidenceSource?: "merchant" | "local_simulation" | undefined;
     settlementEvidenceClass?: "none" | "inconclusive" | "merchant_verifiable_success" | "settled" | undefined;
     settlementIdentifier?: string | undefined;
+    supersededByReceiptId?: string | undefined;
     fulfillmentStatus?: "inconclusive" | "succeeded" | "failed" | undefined;
     completedAt?: string | undefined;
 }, {
+    status: "confirmed" | "provisional" | "expired_unconfirmed" | "refunded" | "void";
     protocol: "x402" | "l402";
+    receiptId: string;
+    paidRequestId: string;
+    paymentAttemptId: string;
+    organizationId: string;
+    agentId: string;
     money: {
         asset: string;
         amount: string;
@@ -418,20 +320,24 @@ export declare const sdkReceiptSchema: z.ZodObject<{
         precision: number;
         unit: "minor";
     };
-    receiptId: string;
-    paidRequestId: string;
-    paymentAttemptId: string;
-    organizationId: string;
-    agentId: string;
-    merchantId: string;
     authorizationOutcome: "allowed";
+    reconciliationStatus: "none" | "refunded" | "required" | "in_progress" | "resolved";
     requestUrl: string;
     requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
     createdAt: string;
+    merchantId?: string | undefined;
+    confirmationSource?: "chain_observer" | undefined;
+    attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
+    attributionBasis?: Record<string, unknown> | undefined;
+    attributionRuleVersion?: string | undefined;
+    confirmedAt?: string | undefined;
+    finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
+    canonicalSettlementKey?: string | undefined;
     paymentReference?: string | undefined;
     evidenceSource?: "merchant" | "local_simulation" | undefined;
     settlementEvidenceClass?: "none" | "inconclusive" | "merchant_verifiable_success" | "settled" | undefined;
     settlementIdentifier?: string | undefined;
+    supersededByReceiptId?: string | undefined;
     fulfillmentStatus?: "inconclusive" | "succeeded" | "failed" | undefined;
     completedAt?: string | undefined;
 }>;
@@ -454,7 +360,7 @@ export declare const sdkPaymentDecisionAllowResponseSchema: z.ZodObject<{
     outcome: z.ZodLiteral<"allow">;
     paidRequestId: z.ZodString;
     paymentAttemptId: z.ZodString;
-    reasonCode: z.ZodEnum<["policy_allow", "policy_denied", "policy_review_required", "payment_execution_in_progress", "preflight_incompatible", "merchant_rejected", "settlement_proof_conflict", "merchant_transport_lost", "payment_rail_missing", "payment_rail_wrong_organization", "payment_rail_disabled", "payment_rail_incompatible"]>;
+    reasonCode: z.ZodEnum<["policy_allow", "policy_denied", "policy_review_required", "payment_execution_in_progress", "preflight_incompatible", "merchant_rejected", "merchant_execution_failed", "settlement_proof_conflict", "merchant_transport_lost", "payment_rail_missing", "payment_rail_wrong_organization", "payment_rail_disabled", "payment_rail_incompatible"]>;
     reason: z.ZodString;
     merchantResponse: z.ZodObject<{
         status: z.ZodNumber;
@@ -475,7 +381,7 @@ export declare const sdkPaymentDecisionAllowResponseSchema: z.ZodObject<{
         paymentAttemptId: z.ZodString;
         organizationId: z.ZodString;
         agentId: z.ZodString;
-        merchantId: z.ZodString;
+        merchantId: z.ZodOptional<z.ZodString>;
         protocol: z.ZodEnum<["x402", "l402"]>;
         money: z.ZodEffects<z.ZodObject<{
             asset: z.ZodString;
@@ -509,17 +415,33 @@ export declare const sdkPaymentDecisionAllowResponseSchema: z.ZodObject<{
             unit: "minor";
         }>;
         authorizationOutcome: z.ZodEnum<["allowed"]>;
+        status: z.ZodEnum<["confirmed", "provisional", "expired_unconfirmed", "refunded", "void"]>;
+        reconciliationStatus: z.ZodEnum<["none", "required", "in_progress", "resolved", "refunded"]>;
+        confirmationSource: z.ZodOptional<z.ZodEnum<["chain_observer"]>>;
+        attributionStrength: z.ZodOptional<z.ZodEnum<["strong_request_scoped", "constrained_unique"]>>;
+        attributionBasis: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        attributionRuleVersion: z.ZodOptional<z.ZodString>;
+        confirmedAt: z.ZodOptional<z.ZodString>;
+        finalityLevelUsed: z.ZodOptional<z.ZodEnum<["evm_block_confirmations_12"]>>;
         requestUrl: z.ZodString;
         requestMethod: z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]>;
+        canonicalSettlementKey: z.ZodOptional<z.ZodString>;
         paymentReference: z.ZodOptional<z.ZodString>;
         evidenceSource: z.ZodOptional<z.ZodEnum<["merchant", "local_simulation"]>>;
         settlementEvidenceClass: z.ZodOptional<z.ZodEnum<["none", "inconclusive", "merchant_verifiable_success", "settled"]>>;
         settlementIdentifier: z.ZodOptional<z.ZodString>;
+        supersededByReceiptId: z.ZodOptional<z.ZodString>;
         fulfillmentStatus: z.ZodOptional<z.ZodEnum<["succeeded", "failed", "inconclusive"]>>;
         createdAt: z.ZodString;
         completedAt: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
+        status: "confirmed" | "provisional" | "expired_unconfirmed" | "refunded" | "void";
         protocol: "x402" | "l402";
+        receiptId: string;
+        paidRequestId: string;
+        paymentAttemptId: string;
+        organizationId: string;
+        agentId: string;
         money: {
             asset: string;
             amount: string;
@@ -527,24 +449,34 @@ export declare const sdkPaymentDecisionAllowResponseSchema: z.ZodObject<{
             precision: number;
             unit: "minor";
         };
-        receiptId: string;
-        paidRequestId: string;
-        paymentAttemptId: string;
-        organizationId: string;
-        agentId: string;
-        merchantId: string;
         authorizationOutcome: "allowed";
+        reconciliationStatus: "none" | "refunded" | "required" | "in_progress" | "resolved";
         requestUrl: string;
         requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
         createdAt: string;
+        merchantId?: string | undefined;
+        confirmationSource?: "chain_observer" | undefined;
+        attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
+        attributionBasis?: Record<string, unknown> | undefined;
+        attributionRuleVersion?: string | undefined;
+        confirmedAt?: string | undefined;
+        finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
+        canonicalSettlementKey?: string | undefined;
         paymentReference?: string | undefined;
         evidenceSource?: "merchant" | "local_simulation" | undefined;
         settlementEvidenceClass?: "none" | "inconclusive" | "merchant_verifiable_success" | "settled" | undefined;
         settlementIdentifier?: string | undefined;
+        supersededByReceiptId?: string | undefined;
         fulfillmentStatus?: "inconclusive" | "succeeded" | "failed" | undefined;
         completedAt?: string | undefined;
     }, {
+        status: "confirmed" | "provisional" | "expired_unconfirmed" | "refunded" | "void";
         protocol: "x402" | "l402";
+        receiptId: string;
+        paidRequestId: string;
+        paymentAttemptId: string;
+        organizationId: string;
+        agentId: string;
         money: {
             asset: string;
             amount: string;
@@ -552,20 +484,24 @@ export declare const sdkPaymentDecisionAllowResponseSchema: z.ZodObject<{
             precision: number;
             unit: "minor";
         };
-        receiptId: string;
-        paidRequestId: string;
-        paymentAttemptId: string;
-        organizationId: string;
-        agentId: string;
-        merchantId: string;
         authorizationOutcome: "allowed";
+        reconciliationStatus: "none" | "refunded" | "required" | "in_progress" | "resolved";
         requestUrl: string;
         requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
         createdAt: string;
+        merchantId?: string | undefined;
+        confirmationSource?: "chain_observer" | undefined;
+        attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
+        attributionBasis?: Record<string, unknown> | undefined;
+        attributionRuleVersion?: string | undefined;
+        confirmedAt?: string | undefined;
+        finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
+        canonicalSettlementKey?: string | undefined;
         paymentReference?: string | undefined;
         evidenceSource?: "merchant" | "local_simulation" | undefined;
         settlementEvidenceClass?: "none" | "inconclusive" | "merchant_verifiable_success" | "settled" | undefined;
         settlementIdentifier?: string | undefined;
+        supersededByReceiptId?: string | undefined;
         fulfillmentStatus?: "inconclusive" | "succeeded" | "failed" | undefined;
         completedAt?: string | undefined;
     }>;
@@ -573,7 +509,7 @@ export declare const sdkPaymentDecisionAllowResponseSchema: z.ZodObject<{
     paidRequestId: string;
     paymentAttemptId: string;
     outcome: "allow";
-    reasonCode: "policy_allow" | "policy_denied" | "policy_review_required" | "payment_execution_in_progress" | "preflight_incompatible" | "merchant_rejected" | "settlement_proof_conflict" | "merchant_transport_lost" | "payment_rail_missing" | "payment_rail_wrong_organization" | "payment_rail_disabled" | "payment_rail_incompatible";
+    reasonCode: "policy_allow" | "policy_denied" | "policy_review_required" | "payment_execution_in_progress" | "preflight_incompatible" | "merchant_rejected" | "merchant_execution_failed" | "settlement_proof_conflict" | "merchant_transport_lost" | "payment_rail_missing" | "payment_rail_wrong_organization" | "payment_rail_disabled" | "payment_rail_incompatible";
     reason: string;
     merchantResponse: {
         status: number;
@@ -581,7 +517,13 @@ export declare const sdkPaymentDecisionAllowResponseSchema: z.ZodObject<{
         body: string;
     };
     receipt: {
+        status: "confirmed" | "provisional" | "expired_unconfirmed" | "refunded" | "void";
         protocol: "x402" | "l402";
+        receiptId: string;
+        paidRequestId: string;
+        paymentAttemptId: string;
+        organizationId: string;
+        agentId: string;
         money: {
             asset: string;
             amount: string;
@@ -589,20 +531,24 @@ export declare const sdkPaymentDecisionAllowResponseSchema: z.ZodObject<{
             precision: number;
             unit: "minor";
         };
-        receiptId: string;
-        paidRequestId: string;
-        paymentAttemptId: string;
-        organizationId: string;
-        agentId: string;
-        merchantId: string;
         authorizationOutcome: "allowed";
+        reconciliationStatus: "none" | "refunded" | "required" | "in_progress" | "resolved";
         requestUrl: string;
         requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
         createdAt: string;
+        merchantId?: string | undefined;
+        confirmationSource?: "chain_observer" | undefined;
+        attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
+        attributionBasis?: Record<string, unknown> | undefined;
+        attributionRuleVersion?: string | undefined;
+        confirmedAt?: string | undefined;
+        finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
+        canonicalSettlementKey?: string | undefined;
         paymentReference?: string | undefined;
         evidenceSource?: "merchant" | "local_simulation" | undefined;
         settlementEvidenceClass?: "none" | "inconclusive" | "merchant_verifiable_success" | "settled" | undefined;
         settlementIdentifier?: string | undefined;
+        supersededByReceiptId?: string | undefined;
         fulfillmentStatus?: "inconclusive" | "succeeded" | "failed" | undefined;
         completedAt?: string | undefined;
     };
@@ -610,7 +556,7 @@ export declare const sdkPaymentDecisionAllowResponseSchema: z.ZodObject<{
     paidRequestId: string;
     paymentAttemptId: string;
     outcome: "allow";
-    reasonCode: "policy_allow" | "policy_denied" | "policy_review_required" | "payment_execution_in_progress" | "preflight_incompatible" | "merchant_rejected" | "settlement_proof_conflict" | "merchant_transport_lost" | "payment_rail_missing" | "payment_rail_wrong_organization" | "payment_rail_disabled" | "payment_rail_incompatible";
+    reasonCode: "policy_allow" | "policy_denied" | "policy_review_required" | "payment_execution_in_progress" | "preflight_incompatible" | "merchant_rejected" | "merchant_execution_failed" | "settlement_proof_conflict" | "merchant_transport_lost" | "payment_rail_missing" | "payment_rail_wrong_organization" | "payment_rail_disabled" | "payment_rail_incompatible";
     reason: string;
     merchantResponse: {
         status: number;
@@ -618,7 +564,13 @@ export declare const sdkPaymentDecisionAllowResponseSchema: z.ZodObject<{
         body?: string | undefined;
     };
     receipt: {
+        status: "confirmed" | "provisional" | "expired_unconfirmed" | "refunded" | "void";
         protocol: "x402" | "l402";
+        receiptId: string;
+        paidRequestId: string;
+        paymentAttemptId: string;
+        organizationId: string;
+        agentId: string;
         money: {
             asset: string;
             amount: string;
@@ -626,20 +578,24 @@ export declare const sdkPaymentDecisionAllowResponseSchema: z.ZodObject<{
             precision: number;
             unit: "minor";
         };
-        receiptId: string;
-        paidRequestId: string;
-        paymentAttemptId: string;
-        organizationId: string;
-        agentId: string;
-        merchantId: string;
         authorizationOutcome: "allowed";
+        reconciliationStatus: "none" | "refunded" | "required" | "in_progress" | "resolved";
         requestUrl: string;
         requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
         createdAt: string;
+        merchantId?: string | undefined;
+        confirmationSource?: "chain_observer" | undefined;
+        attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
+        attributionBasis?: Record<string, unknown> | undefined;
+        attributionRuleVersion?: string | undefined;
+        confirmedAt?: string | undefined;
+        finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
+        canonicalSettlementKey?: string | undefined;
         paymentReference?: string | undefined;
         evidenceSource?: "merchant" | "local_simulation" | undefined;
         settlementEvidenceClass?: "none" | "inconclusive" | "merchant_verifiable_success" | "settled" | undefined;
         settlementIdentifier?: string | undefined;
+        supersededByReceiptId?: string | undefined;
         fulfillmentStatus?: "inconclusive" | "succeeded" | "failed" | undefined;
         completedAt?: string | undefined;
     };
@@ -648,7 +604,7 @@ export declare const sdkPaymentDecisionPaidFulfillmentFailedResponseSchema: z.Zo
     outcome: z.ZodLiteral<"paid_fulfillment_failed">;
     paidRequestId: z.ZodString;
     paymentAttemptId: z.ZodString;
-    reasonCode: z.ZodLiteral<"merchant_rejected">;
+    reasonCode: z.ZodEnum<["merchant_rejected", "merchant_execution_failed"]>;
     reason: z.ZodString;
     merchantResponse: z.ZodObject<{
         status: z.ZodNumber;
@@ -671,7 +627,7 @@ export declare const sdkPaymentDecisionPaidFulfillmentFailedResponseSchema: z.Zo
         paymentAttemptId: z.ZodString;
         organizationId: z.ZodString;
         agentId: z.ZodString;
-        merchantId: z.ZodString;
+        merchantId: z.ZodOptional<z.ZodString>;
         protocol: z.ZodEnum<["x402", "l402"]>;
         money: z.ZodEffects<z.ZodObject<{
             asset: z.ZodString;
@@ -705,17 +661,33 @@ export declare const sdkPaymentDecisionPaidFulfillmentFailedResponseSchema: z.Zo
             unit: "minor";
         }>;
         authorizationOutcome: z.ZodEnum<["allowed"]>;
+        status: z.ZodEnum<["confirmed", "provisional", "expired_unconfirmed", "refunded", "void"]>;
+        reconciliationStatus: z.ZodEnum<["none", "required", "in_progress", "resolved", "refunded"]>;
+        confirmationSource: z.ZodOptional<z.ZodEnum<["chain_observer"]>>;
+        attributionStrength: z.ZodOptional<z.ZodEnum<["strong_request_scoped", "constrained_unique"]>>;
+        attributionBasis: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        attributionRuleVersion: z.ZodOptional<z.ZodString>;
+        confirmedAt: z.ZodOptional<z.ZodString>;
+        finalityLevelUsed: z.ZodOptional<z.ZodEnum<["evm_block_confirmations_12"]>>;
         requestUrl: z.ZodString;
         requestMethod: z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]>;
+        canonicalSettlementKey: z.ZodOptional<z.ZodString>;
         paymentReference: z.ZodOptional<z.ZodString>;
         evidenceSource: z.ZodOptional<z.ZodEnum<["merchant", "local_simulation"]>>;
         settlementEvidenceClass: z.ZodOptional<z.ZodEnum<["none", "inconclusive", "merchant_verifiable_success", "settled"]>>;
         settlementIdentifier: z.ZodOptional<z.ZodString>;
+        supersededByReceiptId: z.ZodOptional<z.ZodString>;
         fulfillmentStatus: z.ZodOptional<z.ZodEnum<["succeeded", "failed", "inconclusive"]>>;
         createdAt: z.ZodString;
         completedAt: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
+        status: "confirmed" | "provisional" | "expired_unconfirmed" | "refunded" | "void";
         protocol: "x402" | "l402";
+        receiptId: string;
+        paidRequestId: string;
+        paymentAttemptId: string;
+        organizationId: string;
+        agentId: string;
         money: {
             asset: string;
             amount: string;
@@ -723,24 +695,34 @@ export declare const sdkPaymentDecisionPaidFulfillmentFailedResponseSchema: z.Zo
             precision: number;
             unit: "minor";
         };
-        receiptId: string;
-        paidRequestId: string;
-        paymentAttemptId: string;
-        organizationId: string;
-        agentId: string;
-        merchantId: string;
         authorizationOutcome: "allowed";
+        reconciliationStatus: "none" | "refunded" | "required" | "in_progress" | "resolved";
         requestUrl: string;
         requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
         createdAt: string;
+        merchantId?: string | undefined;
+        confirmationSource?: "chain_observer" | undefined;
+        attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
+        attributionBasis?: Record<string, unknown> | undefined;
+        attributionRuleVersion?: string | undefined;
+        confirmedAt?: string | undefined;
+        finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
+        canonicalSettlementKey?: string | undefined;
         paymentReference?: string | undefined;
         evidenceSource?: "merchant" | "local_simulation" | undefined;
         settlementEvidenceClass?: "none" | "inconclusive" | "merchant_verifiable_success" | "settled" | undefined;
         settlementIdentifier?: string | undefined;
+        supersededByReceiptId?: string | undefined;
         fulfillmentStatus?: "inconclusive" | "succeeded" | "failed" | undefined;
         completedAt?: string | undefined;
     }, {
+        status: "confirmed" | "provisional" | "expired_unconfirmed" | "refunded" | "void";
         protocol: "x402" | "l402";
+        receiptId: string;
+        paidRequestId: string;
+        paymentAttemptId: string;
+        organizationId: string;
+        agentId: string;
         money: {
             asset: string;
             amount: string;
@@ -748,20 +730,24 @@ export declare const sdkPaymentDecisionPaidFulfillmentFailedResponseSchema: z.Zo
             precision: number;
             unit: "minor";
         };
-        receiptId: string;
-        paidRequestId: string;
-        paymentAttemptId: string;
-        organizationId: string;
-        agentId: string;
-        merchantId: string;
         authorizationOutcome: "allowed";
+        reconciliationStatus: "none" | "refunded" | "required" | "in_progress" | "resolved";
         requestUrl: string;
         requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
         createdAt: string;
+        merchantId?: string | undefined;
+        confirmationSource?: "chain_observer" | undefined;
+        attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
+        attributionBasis?: Record<string, unknown> | undefined;
+        attributionRuleVersion?: string | undefined;
+        confirmedAt?: string | undefined;
+        finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
+        canonicalSettlementKey?: string | undefined;
         paymentReference?: string | undefined;
         evidenceSource?: "merchant" | "local_simulation" | undefined;
         settlementEvidenceClass?: "none" | "inconclusive" | "merchant_verifiable_success" | "settled" | undefined;
         settlementIdentifier?: string | undefined;
+        supersededByReceiptId?: string | undefined;
         fulfillmentStatus?: "inconclusive" | "succeeded" | "failed" | undefined;
         completedAt?: string | undefined;
     }>;
@@ -772,7 +758,7 @@ export declare const sdkPaymentDecisionPaidFulfillmentFailedResponseSchema: z.Zo
     settlementEvidenceClass: "none" | "inconclusive" | "merchant_verifiable_success" | "settled";
     fulfillmentStatus: "failed";
     outcome: "paid_fulfillment_failed";
-    reasonCode: "merchant_rejected";
+    reasonCode: "merchant_rejected" | "merchant_execution_failed";
     reason: string;
     merchantResponse: {
         status: number;
@@ -780,7 +766,13 @@ export declare const sdkPaymentDecisionPaidFulfillmentFailedResponseSchema: z.Zo
         body: string;
     };
     receipt: {
+        status: "confirmed" | "provisional" | "expired_unconfirmed" | "refunded" | "void";
         protocol: "x402" | "l402";
+        receiptId: string;
+        paidRequestId: string;
+        paymentAttemptId: string;
+        organizationId: string;
+        agentId: string;
         money: {
             asset: string;
             amount: string;
@@ -788,20 +780,24 @@ export declare const sdkPaymentDecisionPaidFulfillmentFailedResponseSchema: z.Zo
             precision: number;
             unit: "minor";
         };
-        receiptId: string;
-        paidRequestId: string;
-        paymentAttemptId: string;
-        organizationId: string;
-        agentId: string;
-        merchantId: string;
         authorizationOutcome: "allowed";
+        reconciliationStatus: "none" | "refunded" | "required" | "in_progress" | "resolved";
         requestUrl: string;
         requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
         createdAt: string;
+        merchantId?: string | undefined;
+        confirmationSource?: "chain_observer" | undefined;
+        attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
+        attributionBasis?: Record<string, unknown> | undefined;
+        attributionRuleVersion?: string | undefined;
+        confirmedAt?: string | undefined;
+        finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
+        canonicalSettlementKey?: string | undefined;
         paymentReference?: string | undefined;
         evidenceSource?: "merchant" | "local_simulation" | undefined;
         settlementEvidenceClass?: "none" | "inconclusive" | "merchant_verifiable_success" | "settled" | undefined;
         settlementIdentifier?: string | undefined;
+        supersededByReceiptId?: string | undefined;
         fulfillmentStatus?: "inconclusive" | "succeeded" | "failed" | undefined;
         completedAt?: string | undefined;
     };
@@ -812,7 +808,7 @@ export declare const sdkPaymentDecisionPaidFulfillmentFailedResponseSchema: z.Zo
     settlementEvidenceClass: "none" | "inconclusive" | "merchant_verifiable_success" | "settled";
     fulfillmentStatus: "failed";
     outcome: "paid_fulfillment_failed";
-    reasonCode: "merchant_rejected";
+    reasonCode: "merchant_rejected" | "merchant_execution_failed";
     reason: string;
     merchantResponse: {
         status: number;
@@ -820,7 +816,13 @@ export declare const sdkPaymentDecisionPaidFulfillmentFailedResponseSchema: z.Zo
         body?: string | undefined;
     };
     receipt: {
+        status: "confirmed" | "provisional" | "expired_unconfirmed" | "refunded" | "void";
         protocol: "x402" | "l402";
+        receiptId: string;
+        paidRequestId: string;
+        paymentAttemptId: string;
+        organizationId: string;
+        agentId: string;
         money: {
             asset: string;
             amount: string;
@@ -828,20 +830,24 @@ export declare const sdkPaymentDecisionPaidFulfillmentFailedResponseSchema: z.Zo
             precision: number;
             unit: "minor";
         };
-        receiptId: string;
-        paidRequestId: string;
-        paymentAttemptId: string;
-        organizationId: string;
-        agentId: string;
-        merchantId: string;
         authorizationOutcome: "allowed";
+        reconciliationStatus: "none" | "refunded" | "required" | "in_progress" | "resolved";
         requestUrl: string;
         requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
         createdAt: string;
+        merchantId?: string | undefined;
+        confirmationSource?: "chain_observer" | undefined;
+        attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
+        attributionBasis?: Record<string, unknown> | undefined;
+        attributionRuleVersion?: string | undefined;
+        confirmedAt?: string | undefined;
+        finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
+        canonicalSettlementKey?: string | undefined;
         paymentReference?: string | undefined;
         evidenceSource?: "merchant" | "local_simulation" | undefined;
         settlementEvidenceClass?: "none" | "inconclusive" | "merchant_verifiable_success" | "settled" | undefined;
         settlementIdentifier?: string | undefined;
+        supersededByReceiptId?: string | undefined;
         fulfillmentStatus?: "inconclusive" | "succeeded" | "failed" | undefined;
         completedAt?: string | undefined;
     };
@@ -851,7 +857,7 @@ export declare const sdkPaymentDecisionExecutionFailedResponseSchema: z.ZodObjec
     outcome: z.ZodLiteral<"execution_failed">;
     paidRequestId: z.ZodString;
     paymentAttemptId: z.ZodString;
-    reasonCode: z.ZodEnum<["merchant_rejected", "settlement_proof_conflict"]>;
+    reasonCode: z.ZodEnum<["merchant_rejected", "merchant_execution_failed"]>;
     reason: z.ZodString;
     merchantResponse: z.ZodObject<{
         status: z.ZodNumber;
@@ -871,7 +877,7 @@ export declare const sdkPaymentDecisionExecutionFailedResponseSchema: z.ZodObjec
     paidRequestId: string;
     paymentAttemptId: string;
     outcome: "execution_failed";
-    reasonCode: "merchant_rejected" | "settlement_proof_conflict";
+    reasonCode: "merchant_rejected" | "merchant_execution_failed";
     reason: string;
     merchantResponse: {
         status: number;
@@ -883,7 +889,7 @@ export declare const sdkPaymentDecisionExecutionFailedResponseSchema: z.ZodObjec
     paidRequestId: string;
     paymentAttemptId: string;
     outcome: "execution_failed";
-    reasonCode: "merchant_rejected" | "settlement_proof_conflict";
+    reasonCode: "merchant_rejected" | "merchant_execution_failed";
     reason: string;
     merchantResponse: {
         status: number;
@@ -958,18 +964,18 @@ export declare const sdkPaymentDecisionInconclusiveResponseSchema: z.ZodObject<{
 export declare const sdkPaymentDecisionDenyResponseSchema: z.ZodObject<{
     outcome: z.ZodLiteral<"deny">;
     paidRequestId: z.ZodOptional<z.ZodString>;
-    reasonCode: z.ZodEnum<["policy_allow", "policy_denied", "policy_review_required", "payment_execution_in_progress", "preflight_incompatible", "merchant_rejected", "settlement_proof_conflict", "merchant_transport_lost", "payment_rail_missing", "payment_rail_wrong_organization", "payment_rail_disabled", "payment_rail_incompatible"]>;
+    reasonCode: z.ZodEnum<["policy_allow", "policy_denied", "policy_review_required", "payment_execution_in_progress", "preflight_incompatible", "merchant_rejected", "merchant_execution_failed", "settlement_proof_conflict", "merchant_transport_lost", "payment_rail_missing", "payment_rail_wrong_organization", "payment_rail_disabled", "payment_rail_incompatible"]>;
     reason: z.ZodString;
     policyReviewEventId: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     outcome: "deny";
-    reasonCode: "policy_allow" | "policy_denied" | "policy_review_required" | "payment_execution_in_progress" | "preflight_incompatible" | "merchant_rejected" | "settlement_proof_conflict" | "merchant_transport_lost" | "payment_rail_missing" | "payment_rail_wrong_organization" | "payment_rail_disabled" | "payment_rail_incompatible";
+    reasonCode: "policy_allow" | "policy_denied" | "policy_review_required" | "payment_execution_in_progress" | "preflight_incompatible" | "merchant_rejected" | "merchant_execution_failed" | "settlement_proof_conflict" | "merchant_transport_lost" | "payment_rail_missing" | "payment_rail_wrong_organization" | "payment_rail_disabled" | "payment_rail_incompatible";
     reason: string;
     paidRequestId?: string | undefined;
     policyReviewEventId?: string | undefined;
 }, {
     outcome: "deny";
-    reasonCode: "policy_allow" | "policy_denied" | "policy_review_required" | "payment_execution_in_progress" | "preflight_incompatible" | "merchant_rejected" | "settlement_proof_conflict" | "merchant_transport_lost" | "payment_rail_missing" | "payment_rail_wrong_organization" | "payment_rail_disabled" | "payment_rail_incompatible";
+    reasonCode: "policy_allow" | "policy_denied" | "policy_review_required" | "payment_execution_in_progress" | "preflight_incompatible" | "merchant_rejected" | "merchant_execution_failed" | "settlement_proof_conflict" | "merchant_transport_lost" | "payment_rail_missing" | "payment_rail_wrong_organization" | "payment_rail_disabled" | "payment_rail_incompatible";
     reason: string;
     paidRequestId?: string | undefined;
     policyReviewEventId?: string | undefined;
@@ -978,7 +984,7 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
     outcome: z.ZodLiteral<"allow">;
     paidRequestId: z.ZodString;
     paymentAttemptId: z.ZodString;
-    reasonCode: z.ZodEnum<["policy_allow", "policy_denied", "policy_review_required", "payment_execution_in_progress", "preflight_incompatible", "merchant_rejected", "settlement_proof_conflict", "merchant_transport_lost", "payment_rail_missing", "payment_rail_wrong_organization", "payment_rail_disabled", "payment_rail_incompatible"]>;
+    reasonCode: z.ZodEnum<["policy_allow", "policy_denied", "policy_review_required", "payment_execution_in_progress", "preflight_incompatible", "merchant_rejected", "merchant_execution_failed", "settlement_proof_conflict", "merchant_transport_lost", "payment_rail_missing", "payment_rail_wrong_organization", "payment_rail_disabled", "payment_rail_incompatible"]>;
     reason: z.ZodString;
     merchantResponse: z.ZodObject<{
         status: z.ZodNumber;
@@ -999,7 +1005,7 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
         paymentAttemptId: z.ZodString;
         organizationId: z.ZodString;
         agentId: z.ZodString;
-        merchantId: z.ZodString;
+        merchantId: z.ZodOptional<z.ZodString>;
         protocol: z.ZodEnum<["x402", "l402"]>;
         money: z.ZodEffects<z.ZodObject<{
             asset: z.ZodString;
@@ -1033,17 +1039,33 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
             unit: "minor";
         }>;
         authorizationOutcome: z.ZodEnum<["allowed"]>;
+        status: z.ZodEnum<["confirmed", "provisional", "expired_unconfirmed", "refunded", "void"]>;
+        reconciliationStatus: z.ZodEnum<["none", "required", "in_progress", "resolved", "refunded"]>;
+        confirmationSource: z.ZodOptional<z.ZodEnum<["chain_observer"]>>;
+        attributionStrength: z.ZodOptional<z.ZodEnum<["strong_request_scoped", "constrained_unique"]>>;
+        attributionBasis: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        attributionRuleVersion: z.ZodOptional<z.ZodString>;
+        confirmedAt: z.ZodOptional<z.ZodString>;
+        finalityLevelUsed: z.ZodOptional<z.ZodEnum<["evm_block_confirmations_12"]>>;
         requestUrl: z.ZodString;
         requestMethod: z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]>;
+        canonicalSettlementKey: z.ZodOptional<z.ZodString>;
         paymentReference: z.ZodOptional<z.ZodString>;
         evidenceSource: z.ZodOptional<z.ZodEnum<["merchant", "local_simulation"]>>;
         settlementEvidenceClass: z.ZodOptional<z.ZodEnum<["none", "inconclusive", "merchant_verifiable_success", "settled"]>>;
         settlementIdentifier: z.ZodOptional<z.ZodString>;
+        supersededByReceiptId: z.ZodOptional<z.ZodString>;
         fulfillmentStatus: z.ZodOptional<z.ZodEnum<["succeeded", "failed", "inconclusive"]>>;
         createdAt: z.ZodString;
         completedAt: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
+        status: "confirmed" | "provisional" | "expired_unconfirmed" | "refunded" | "void";
         protocol: "x402" | "l402";
+        receiptId: string;
+        paidRequestId: string;
+        paymentAttemptId: string;
+        organizationId: string;
+        agentId: string;
         money: {
             asset: string;
             amount: string;
@@ -1051,24 +1073,34 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
             precision: number;
             unit: "minor";
         };
-        receiptId: string;
-        paidRequestId: string;
-        paymentAttemptId: string;
-        organizationId: string;
-        agentId: string;
-        merchantId: string;
         authorizationOutcome: "allowed";
+        reconciliationStatus: "none" | "refunded" | "required" | "in_progress" | "resolved";
         requestUrl: string;
         requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
         createdAt: string;
+        merchantId?: string | undefined;
+        confirmationSource?: "chain_observer" | undefined;
+        attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
+        attributionBasis?: Record<string, unknown> | undefined;
+        attributionRuleVersion?: string | undefined;
+        confirmedAt?: string | undefined;
+        finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
+        canonicalSettlementKey?: string | undefined;
         paymentReference?: string | undefined;
         evidenceSource?: "merchant" | "local_simulation" | undefined;
         settlementEvidenceClass?: "none" | "inconclusive" | "merchant_verifiable_success" | "settled" | undefined;
         settlementIdentifier?: string | undefined;
+        supersededByReceiptId?: string | undefined;
         fulfillmentStatus?: "inconclusive" | "succeeded" | "failed" | undefined;
         completedAt?: string | undefined;
     }, {
+        status: "confirmed" | "provisional" | "expired_unconfirmed" | "refunded" | "void";
         protocol: "x402" | "l402";
+        receiptId: string;
+        paidRequestId: string;
+        paymentAttemptId: string;
+        organizationId: string;
+        agentId: string;
         money: {
             asset: string;
             amount: string;
@@ -1076,20 +1108,24 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
             precision: number;
             unit: "minor";
         };
-        receiptId: string;
-        paidRequestId: string;
-        paymentAttemptId: string;
-        organizationId: string;
-        agentId: string;
-        merchantId: string;
         authorizationOutcome: "allowed";
+        reconciliationStatus: "none" | "refunded" | "required" | "in_progress" | "resolved";
         requestUrl: string;
         requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
         createdAt: string;
+        merchantId?: string | undefined;
+        confirmationSource?: "chain_observer" | undefined;
+        attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
+        attributionBasis?: Record<string, unknown> | undefined;
+        attributionRuleVersion?: string | undefined;
+        confirmedAt?: string | undefined;
+        finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
+        canonicalSettlementKey?: string | undefined;
         paymentReference?: string | undefined;
         evidenceSource?: "merchant" | "local_simulation" | undefined;
         settlementEvidenceClass?: "none" | "inconclusive" | "merchant_verifiable_success" | "settled" | undefined;
         settlementIdentifier?: string | undefined;
+        supersededByReceiptId?: string | undefined;
         fulfillmentStatus?: "inconclusive" | "succeeded" | "failed" | undefined;
         completedAt?: string | undefined;
     }>;
@@ -1097,7 +1133,7 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
     paidRequestId: string;
     paymentAttemptId: string;
     outcome: "allow";
-    reasonCode: "policy_allow" | "policy_denied" | "policy_review_required" | "payment_execution_in_progress" | "preflight_incompatible" | "merchant_rejected" | "settlement_proof_conflict" | "merchant_transport_lost" | "payment_rail_missing" | "payment_rail_wrong_organization" | "payment_rail_disabled" | "payment_rail_incompatible";
+    reasonCode: "policy_allow" | "policy_denied" | "policy_review_required" | "payment_execution_in_progress" | "preflight_incompatible" | "merchant_rejected" | "merchant_execution_failed" | "settlement_proof_conflict" | "merchant_transport_lost" | "payment_rail_missing" | "payment_rail_wrong_organization" | "payment_rail_disabled" | "payment_rail_incompatible";
     reason: string;
     merchantResponse: {
         status: number;
@@ -1105,7 +1141,13 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
         body: string;
     };
     receipt: {
+        status: "confirmed" | "provisional" | "expired_unconfirmed" | "refunded" | "void";
         protocol: "x402" | "l402";
+        receiptId: string;
+        paidRequestId: string;
+        paymentAttemptId: string;
+        organizationId: string;
+        agentId: string;
         money: {
             asset: string;
             amount: string;
@@ -1113,20 +1155,24 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
             precision: number;
             unit: "minor";
         };
-        receiptId: string;
-        paidRequestId: string;
-        paymentAttemptId: string;
-        organizationId: string;
-        agentId: string;
-        merchantId: string;
         authorizationOutcome: "allowed";
+        reconciliationStatus: "none" | "refunded" | "required" | "in_progress" | "resolved";
         requestUrl: string;
         requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
         createdAt: string;
+        merchantId?: string | undefined;
+        confirmationSource?: "chain_observer" | undefined;
+        attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
+        attributionBasis?: Record<string, unknown> | undefined;
+        attributionRuleVersion?: string | undefined;
+        confirmedAt?: string | undefined;
+        finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
+        canonicalSettlementKey?: string | undefined;
         paymentReference?: string | undefined;
         evidenceSource?: "merchant" | "local_simulation" | undefined;
         settlementEvidenceClass?: "none" | "inconclusive" | "merchant_verifiable_success" | "settled" | undefined;
         settlementIdentifier?: string | undefined;
+        supersededByReceiptId?: string | undefined;
         fulfillmentStatus?: "inconclusive" | "succeeded" | "failed" | undefined;
         completedAt?: string | undefined;
     };
@@ -1134,7 +1180,7 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
     paidRequestId: string;
     paymentAttemptId: string;
     outcome: "allow";
-    reasonCode: "policy_allow" | "policy_denied" | "policy_review_required" | "payment_execution_in_progress" | "preflight_incompatible" | "merchant_rejected" | "settlement_proof_conflict" | "merchant_transport_lost" | "payment_rail_missing" | "payment_rail_wrong_organization" | "payment_rail_disabled" | "payment_rail_incompatible";
+    reasonCode: "policy_allow" | "policy_denied" | "policy_review_required" | "payment_execution_in_progress" | "preflight_incompatible" | "merchant_rejected" | "merchant_execution_failed" | "settlement_proof_conflict" | "merchant_transport_lost" | "payment_rail_missing" | "payment_rail_wrong_organization" | "payment_rail_disabled" | "payment_rail_incompatible";
     reason: string;
     merchantResponse: {
         status: number;
@@ -1142,7 +1188,13 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
         body?: string | undefined;
     };
     receipt: {
+        status: "confirmed" | "provisional" | "expired_unconfirmed" | "refunded" | "void";
         protocol: "x402" | "l402";
+        receiptId: string;
+        paidRequestId: string;
+        paymentAttemptId: string;
+        organizationId: string;
+        agentId: string;
         money: {
             asset: string;
             amount: string;
@@ -1150,20 +1202,24 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
             precision: number;
             unit: "minor";
         };
-        receiptId: string;
-        paidRequestId: string;
-        paymentAttemptId: string;
-        organizationId: string;
-        agentId: string;
-        merchantId: string;
         authorizationOutcome: "allowed";
+        reconciliationStatus: "none" | "refunded" | "required" | "in_progress" | "resolved";
         requestUrl: string;
         requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
         createdAt: string;
+        merchantId?: string | undefined;
+        confirmationSource?: "chain_observer" | undefined;
+        attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
+        attributionBasis?: Record<string, unknown> | undefined;
+        attributionRuleVersion?: string | undefined;
+        confirmedAt?: string | undefined;
+        finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
+        canonicalSettlementKey?: string | undefined;
         paymentReference?: string | undefined;
         evidenceSource?: "merchant" | "local_simulation" | undefined;
         settlementEvidenceClass?: "none" | "inconclusive" | "merchant_verifiable_success" | "settled" | undefined;
         settlementIdentifier?: string | undefined;
+        supersededByReceiptId?: string | undefined;
         fulfillmentStatus?: "inconclusive" | "succeeded" | "failed" | undefined;
         completedAt?: string | undefined;
     };
@@ -1171,7 +1227,7 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
     outcome: z.ZodLiteral<"paid_fulfillment_failed">;
     paidRequestId: z.ZodString;
     paymentAttemptId: z.ZodString;
-    reasonCode: z.ZodLiteral<"merchant_rejected">;
+    reasonCode: z.ZodEnum<["merchant_rejected", "merchant_execution_failed"]>;
     reason: z.ZodString;
     merchantResponse: z.ZodObject<{
         status: z.ZodNumber;
@@ -1194,7 +1250,7 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
         paymentAttemptId: z.ZodString;
         organizationId: z.ZodString;
         agentId: z.ZodString;
-        merchantId: z.ZodString;
+        merchantId: z.ZodOptional<z.ZodString>;
         protocol: z.ZodEnum<["x402", "l402"]>;
         money: z.ZodEffects<z.ZodObject<{
             asset: z.ZodString;
@@ -1228,17 +1284,33 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
             unit: "minor";
         }>;
         authorizationOutcome: z.ZodEnum<["allowed"]>;
+        status: z.ZodEnum<["confirmed", "provisional", "expired_unconfirmed", "refunded", "void"]>;
+        reconciliationStatus: z.ZodEnum<["none", "required", "in_progress", "resolved", "refunded"]>;
+        confirmationSource: z.ZodOptional<z.ZodEnum<["chain_observer"]>>;
+        attributionStrength: z.ZodOptional<z.ZodEnum<["strong_request_scoped", "constrained_unique"]>>;
+        attributionBasis: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        attributionRuleVersion: z.ZodOptional<z.ZodString>;
+        confirmedAt: z.ZodOptional<z.ZodString>;
+        finalityLevelUsed: z.ZodOptional<z.ZodEnum<["evm_block_confirmations_12"]>>;
         requestUrl: z.ZodString;
         requestMethod: z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]>;
+        canonicalSettlementKey: z.ZodOptional<z.ZodString>;
         paymentReference: z.ZodOptional<z.ZodString>;
         evidenceSource: z.ZodOptional<z.ZodEnum<["merchant", "local_simulation"]>>;
         settlementEvidenceClass: z.ZodOptional<z.ZodEnum<["none", "inconclusive", "merchant_verifiable_success", "settled"]>>;
         settlementIdentifier: z.ZodOptional<z.ZodString>;
+        supersededByReceiptId: z.ZodOptional<z.ZodString>;
         fulfillmentStatus: z.ZodOptional<z.ZodEnum<["succeeded", "failed", "inconclusive"]>>;
         createdAt: z.ZodString;
         completedAt: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
+        status: "confirmed" | "provisional" | "expired_unconfirmed" | "refunded" | "void";
         protocol: "x402" | "l402";
+        receiptId: string;
+        paidRequestId: string;
+        paymentAttemptId: string;
+        organizationId: string;
+        agentId: string;
         money: {
             asset: string;
             amount: string;
@@ -1246,24 +1318,34 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
             precision: number;
             unit: "minor";
         };
-        receiptId: string;
-        paidRequestId: string;
-        paymentAttemptId: string;
-        organizationId: string;
-        agentId: string;
-        merchantId: string;
         authorizationOutcome: "allowed";
+        reconciliationStatus: "none" | "refunded" | "required" | "in_progress" | "resolved";
         requestUrl: string;
         requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
         createdAt: string;
+        merchantId?: string | undefined;
+        confirmationSource?: "chain_observer" | undefined;
+        attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
+        attributionBasis?: Record<string, unknown> | undefined;
+        attributionRuleVersion?: string | undefined;
+        confirmedAt?: string | undefined;
+        finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
+        canonicalSettlementKey?: string | undefined;
         paymentReference?: string | undefined;
         evidenceSource?: "merchant" | "local_simulation" | undefined;
         settlementEvidenceClass?: "none" | "inconclusive" | "merchant_verifiable_success" | "settled" | undefined;
         settlementIdentifier?: string | undefined;
+        supersededByReceiptId?: string | undefined;
         fulfillmentStatus?: "inconclusive" | "succeeded" | "failed" | undefined;
         completedAt?: string | undefined;
     }, {
+        status: "confirmed" | "provisional" | "expired_unconfirmed" | "refunded" | "void";
         protocol: "x402" | "l402";
+        receiptId: string;
+        paidRequestId: string;
+        paymentAttemptId: string;
+        organizationId: string;
+        agentId: string;
         money: {
             asset: string;
             amount: string;
@@ -1271,20 +1353,24 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
             precision: number;
             unit: "minor";
         };
-        receiptId: string;
-        paidRequestId: string;
-        paymentAttemptId: string;
-        organizationId: string;
-        agentId: string;
-        merchantId: string;
         authorizationOutcome: "allowed";
+        reconciliationStatus: "none" | "refunded" | "required" | "in_progress" | "resolved";
         requestUrl: string;
         requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
         createdAt: string;
+        merchantId?: string | undefined;
+        confirmationSource?: "chain_observer" | undefined;
+        attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
+        attributionBasis?: Record<string, unknown> | undefined;
+        attributionRuleVersion?: string | undefined;
+        confirmedAt?: string | undefined;
+        finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
+        canonicalSettlementKey?: string | undefined;
         paymentReference?: string | undefined;
         evidenceSource?: "merchant" | "local_simulation" | undefined;
         settlementEvidenceClass?: "none" | "inconclusive" | "merchant_verifiable_success" | "settled" | undefined;
         settlementIdentifier?: string | undefined;
+        supersededByReceiptId?: string | undefined;
         fulfillmentStatus?: "inconclusive" | "succeeded" | "failed" | undefined;
         completedAt?: string | undefined;
     }>;
@@ -1295,7 +1381,7 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
     settlementEvidenceClass: "none" | "inconclusive" | "merchant_verifiable_success" | "settled";
     fulfillmentStatus: "failed";
     outcome: "paid_fulfillment_failed";
-    reasonCode: "merchant_rejected";
+    reasonCode: "merchant_rejected" | "merchant_execution_failed";
     reason: string;
     merchantResponse: {
         status: number;
@@ -1303,7 +1389,13 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
         body: string;
     };
     receipt: {
+        status: "confirmed" | "provisional" | "expired_unconfirmed" | "refunded" | "void";
         protocol: "x402" | "l402";
+        receiptId: string;
+        paidRequestId: string;
+        paymentAttemptId: string;
+        organizationId: string;
+        agentId: string;
         money: {
             asset: string;
             amount: string;
@@ -1311,20 +1403,24 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
             precision: number;
             unit: "minor";
         };
-        receiptId: string;
-        paidRequestId: string;
-        paymentAttemptId: string;
-        organizationId: string;
-        agentId: string;
-        merchantId: string;
         authorizationOutcome: "allowed";
+        reconciliationStatus: "none" | "refunded" | "required" | "in_progress" | "resolved";
         requestUrl: string;
         requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
         createdAt: string;
+        merchantId?: string | undefined;
+        confirmationSource?: "chain_observer" | undefined;
+        attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
+        attributionBasis?: Record<string, unknown> | undefined;
+        attributionRuleVersion?: string | undefined;
+        confirmedAt?: string | undefined;
+        finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
+        canonicalSettlementKey?: string | undefined;
         paymentReference?: string | undefined;
         evidenceSource?: "merchant" | "local_simulation" | undefined;
         settlementEvidenceClass?: "none" | "inconclusive" | "merchant_verifiable_success" | "settled" | undefined;
         settlementIdentifier?: string | undefined;
+        supersededByReceiptId?: string | undefined;
         fulfillmentStatus?: "inconclusive" | "succeeded" | "failed" | undefined;
         completedAt?: string | undefined;
     };
@@ -1335,7 +1431,7 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
     settlementEvidenceClass: "none" | "inconclusive" | "merchant_verifiable_success" | "settled";
     fulfillmentStatus: "failed";
     outcome: "paid_fulfillment_failed";
-    reasonCode: "merchant_rejected";
+    reasonCode: "merchant_rejected" | "merchant_execution_failed";
     reason: string;
     merchantResponse: {
         status: number;
@@ -1343,7 +1439,13 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
         body?: string | undefined;
     };
     receipt: {
+        status: "confirmed" | "provisional" | "expired_unconfirmed" | "refunded" | "void";
         protocol: "x402" | "l402";
+        receiptId: string;
+        paidRequestId: string;
+        paymentAttemptId: string;
+        organizationId: string;
+        agentId: string;
         money: {
             asset: string;
             amount: string;
@@ -1351,20 +1453,24 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
             precision: number;
             unit: "minor";
         };
-        receiptId: string;
-        paidRequestId: string;
-        paymentAttemptId: string;
-        organizationId: string;
-        agentId: string;
-        merchantId: string;
         authorizationOutcome: "allowed";
+        reconciliationStatus: "none" | "refunded" | "required" | "in_progress" | "resolved";
         requestUrl: string;
         requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
         createdAt: string;
+        merchantId?: string | undefined;
+        confirmationSource?: "chain_observer" | undefined;
+        attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
+        attributionBasis?: Record<string, unknown> | undefined;
+        attributionRuleVersion?: string | undefined;
+        confirmedAt?: string | undefined;
+        finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
+        canonicalSettlementKey?: string | undefined;
         paymentReference?: string | undefined;
         evidenceSource?: "merchant" | "local_simulation" | undefined;
         settlementEvidenceClass?: "none" | "inconclusive" | "merchant_verifiable_success" | "settled" | undefined;
         settlementIdentifier?: string | undefined;
+        supersededByReceiptId?: string | undefined;
         fulfillmentStatus?: "inconclusive" | "succeeded" | "failed" | undefined;
         completedAt?: string | undefined;
     };
@@ -1412,7 +1518,7 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
     outcome: z.ZodLiteral<"execution_failed">;
     paidRequestId: z.ZodString;
     paymentAttemptId: z.ZodString;
-    reasonCode: z.ZodEnum<["merchant_rejected", "settlement_proof_conflict"]>;
+    reasonCode: z.ZodEnum<["merchant_rejected", "merchant_execution_failed"]>;
     reason: z.ZodString;
     merchantResponse: z.ZodObject<{
         status: z.ZodNumber;
@@ -1432,7 +1538,7 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
     paidRequestId: string;
     paymentAttemptId: string;
     outcome: "execution_failed";
-    reasonCode: "merchant_rejected" | "settlement_proof_conflict";
+    reasonCode: "merchant_rejected" | "merchant_execution_failed";
     reason: string;
     merchantResponse: {
         status: number;
@@ -1444,7 +1550,7 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
     paidRequestId: string;
     paymentAttemptId: string;
     outcome: "execution_failed";
-    reasonCode: "merchant_rejected" | "settlement_proof_conflict";
+    reasonCode: "merchant_rejected" | "merchant_execution_failed";
     reason: string;
     merchantResponse: {
         status: number;
@@ -1476,18 +1582,18 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
 }>, z.ZodObject<{
     outcome: z.ZodLiteral<"deny">;
     paidRequestId: z.ZodOptional<z.ZodString>;
-    reasonCode: z.ZodEnum<["policy_allow", "policy_denied", "policy_review_required", "payment_execution_in_progress", "preflight_incompatible", "merchant_rejected", "settlement_proof_conflict", "merchant_transport_lost", "payment_rail_missing", "payment_rail_wrong_organization", "payment_rail_disabled", "payment_rail_incompatible"]>;
+    reasonCode: z.ZodEnum<["policy_allow", "policy_denied", "policy_review_required", "payment_execution_in_progress", "preflight_incompatible", "merchant_rejected", "merchant_execution_failed", "settlement_proof_conflict", "merchant_transport_lost", "payment_rail_missing", "payment_rail_wrong_organization", "payment_rail_disabled", "payment_rail_incompatible"]>;
     reason: z.ZodString;
     policyReviewEventId: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     outcome: "deny";
-    reasonCode: "policy_allow" | "policy_denied" | "policy_review_required" | "payment_execution_in_progress" | "preflight_incompatible" | "merchant_rejected" | "settlement_proof_conflict" | "merchant_transport_lost" | "payment_rail_missing" | "payment_rail_wrong_organization" | "payment_rail_disabled" | "payment_rail_incompatible";
+    reasonCode: "policy_allow" | "policy_denied" | "policy_review_required" | "payment_execution_in_progress" | "preflight_incompatible" | "merchant_rejected" | "merchant_execution_failed" | "settlement_proof_conflict" | "merchant_transport_lost" | "payment_rail_missing" | "payment_rail_wrong_organization" | "payment_rail_disabled" | "payment_rail_incompatible";
     reason: string;
     paidRequestId?: string | undefined;
     policyReviewEventId?: string | undefined;
 }, {
     outcome: "deny";
-    reasonCode: "policy_allow" | "policy_denied" | "policy_review_required" | "payment_execution_in_progress" | "preflight_incompatible" | "merchant_rejected" | "settlement_proof_conflict" | "merchant_transport_lost" | "payment_rail_missing" | "payment_rail_wrong_organization" | "payment_rail_disabled" | "payment_rail_incompatible";
+    reasonCode: "policy_allow" | "policy_denied" | "policy_review_required" | "payment_execution_in_progress" | "preflight_incompatible" | "merchant_rejected" | "merchant_execution_failed" | "settlement_proof_conflict" | "merchant_transport_lost" | "payment_rail_missing" | "payment_rail_wrong_organization" | "payment_rail_disabled" | "payment_rail_incompatible";
     reason: string;
     paidRequestId?: string | undefined;
     policyReviewEventId?: string | undefined;
@@ -1500,7 +1606,7 @@ export declare const sdkReceiptResponseSchema: z.ZodObject<{
         paymentAttemptId: z.ZodString;
         organizationId: z.ZodString;
         agentId: z.ZodString;
-        merchantId: z.ZodString;
+        merchantId: z.ZodOptional<z.ZodString>;
         protocol: z.ZodEnum<["x402", "l402"]>;
         money: z.ZodEffects<z.ZodObject<{
             asset: z.ZodString;
@@ -1534,17 +1640,33 @@ export declare const sdkReceiptResponseSchema: z.ZodObject<{
             unit: "minor";
         }>;
         authorizationOutcome: z.ZodEnum<["allowed"]>;
+        status: z.ZodEnum<["confirmed", "provisional", "expired_unconfirmed", "refunded", "void"]>;
+        reconciliationStatus: z.ZodEnum<["none", "required", "in_progress", "resolved", "refunded"]>;
+        confirmationSource: z.ZodOptional<z.ZodEnum<["chain_observer"]>>;
+        attributionStrength: z.ZodOptional<z.ZodEnum<["strong_request_scoped", "constrained_unique"]>>;
+        attributionBasis: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        attributionRuleVersion: z.ZodOptional<z.ZodString>;
+        confirmedAt: z.ZodOptional<z.ZodString>;
+        finalityLevelUsed: z.ZodOptional<z.ZodEnum<["evm_block_confirmations_12"]>>;
         requestUrl: z.ZodString;
         requestMethod: z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]>;
+        canonicalSettlementKey: z.ZodOptional<z.ZodString>;
         paymentReference: z.ZodOptional<z.ZodString>;
         evidenceSource: z.ZodOptional<z.ZodEnum<["merchant", "local_simulation"]>>;
         settlementEvidenceClass: z.ZodOptional<z.ZodEnum<["none", "inconclusive", "merchant_verifiable_success", "settled"]>>;
         settlementIdentifier: z.ZodOptional<z.ZodString>;
+        supersededByReceiptId: z.ZodOptional<z.ZodString>;
         fulfillmentStatus: z.ZodOptional<z.ZodEnum<["succeeded", "failed", "inconclusive"]>>;
         createdAt: z.ZodString;
         completedAt: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
+        status: "confirmed" | "provisional" | "expired_unconfirmed" | "refunded" | "void";
         protocol: "x402" | "l402";
+        receiptId: string;
+        paidRequestId: string;
+        paymentAttemptId: string;
+        organizationId: string;
+        agentId: string;
         money: {
             asset: string;
             amount: string;
@@ -1552,24 +1674,34 @@ export declare const sdkReceiptResponseSchema: z.ZodObject<{
             precision: number;
             unit: "minor";
         };
-        receiptId: string;
-        paidRequestId: string;
-        paymentAttemptId: string;
-        organizationId: string;
-        agentId: string;
-        merchantId: string;
         authorizationOutcome: "allowed";
+        reconciliationStatus: "none" | "refunded" | "required" | "in_progress" | "resolved";
         requestUrl: string;
         requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
         createdAt: string;
+        merchantId?: string | undefined;
+        confirmationSource?: "chain_observer" | undefined;
+        attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
+        attributionBasis?: Record<string, unknown> | undefined;
+        attributionRuleVersion?: string | undefined;
+        confirmedAt?: string | undefined;
+        finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
+        canonicalSettlementKey?: string | undefined;
         paymentReference?: string | undefined;
         evidenceSource?: "merchant" | "local_simulation" | undefined;
         settlementEvidenceClass?: "none" | "inconclusive" | "merchant_verifiable_success" | "settled" | undefined;
         settlementIdentifier?: string | undefined;
+        supersededByReceiptId?: string | undefined;
         fulfillmentStatus?: "inconclusive" | "succeeded" | "failed" | undefined;
         completedAt?: string | undefined;
     }, {
+        status: "confirmed" | "provisional" | "expired_unconfirmed" | "refunded" | "void";
         protocol: "x402" | "l402";
+        receiptId: string;
+        paidRequestId: string;
+        paymentAttemptId: string;
+        organizationId: string;
+        agentId: string;
         money: {
             asset: string;
             amount: string;
@@ -1577,26 +1709,36 @@ export declare const sdkReceiptResponseSchema: z.ZodObject<{
             precision: number;
             unit: "minor";
         };
-        receiptId: string;
-        paidRequestId: string;
-        paymentAttemptId: string;
-        organizationId: string;
-        agentId: string;
-        merchantId: string;
         authorizationOutcome: "allowed";
+        reconciliationStatus: "none" | "refunded" | "required" | "in_progress" | "resolved";
         requestUrl: string;
         requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
         createdAt: string;
+        merchantId?: string | undefined;
+        confirmationSource?: "chain_observer" | undefined;
+        attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
+        attributionBasis?: Record<string, unknown> | undefined;
+        attributionRuleVersion?: string | undefined;
+        confirmedAt?: string | undefined;
+        finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
+        canonicalSettlementKey?: string | undefined;
         paymentReference?: string | undefined;
         evidenceSource?: "merchant" | "local_simulation" | undefined;
         settlementEvidenceClass?: "none" | "inconclusive" | "merchant_verifiable_success" | "settled" | undefined;
         settlementIdentifier?: string | undefined;
+        supersededByReceiptId?: string | undefined;
         fulfillmentStatus?: "inconclusive" | "succeeded" | "failed" | undefined;
         completedAt?: string | undefined;
     }>;
 }, "strip", z.ZodTypeAny, {
     receipt: {
+        status: "confirmed" | "provisional" | "expired_unconfirmed" | "refunded" | "void";
         protocol: "x402" | "l402";
+        receiptId: string;
+        paidRequestId: string;
+        paymentAttemptId: string;
+        organizationId: string;
+        agentId: string;
         money: {
             asset: string;
             amount: string;
@@ -1604,26 +1746,36 @@ export declare const sdkReceiptResponseSchema: z.ZodObject<{
             precision: number;
             unit: "minor";
         };
-        receiptId: string;
-        paidRequestId: string;
-        paymentAttemptId: string;
-        organizationId: string;
-        agentId: string;
-        merchantId: string;
         authorizationOutcome: "allowed";
+        reconciliationStatus: "none" | "refunded" | "required" | "in_progress" | "resolved";
         requestUrl: string;
         requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
         createdAt: string;
+        merchantId?: string | undefined;
+        confirmationSource?: "chain_observer" | undefined;
+        attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
+        attributionBasis?: Record<string, unknown> | undefined;
+        attributionRuleVersion?: string | undefined;
+        confirmedAt?: string | undefined;
+        finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
+        canonicalSettlementKey?: string | undefined;
         paymentReference?: string | undefined;
         evidenceSource?: "merchant" | "local_simulation" | undefined;
         settlementEvidenceClass?: "none" | "inconclusive" | "merchant_verifiable_success" | "settled" | undefined;
         settlementIdentifier?: string | undefined;
+        supersededByReceiptId?: string | undefined;
         fulfillmentStatus?: "inconclusive" | "succeeded" | "failed" | undefined;
         completedAt?: string | undefined;
     };
 }, {
     receipt: {
+        status: "confirmed" | "provisional" | "expired_unconfirmed" | "refunded" | "void";
         protocol: "x402" | "l402";
+        receiptId: string;
+        paidRequestId: string;
+        paymentAttemptId: string;
+        organizationId: string;
+        agentId: string;
         money: {
             asset: string;
             amount: string;
@@ -1631,20 +1783,24 @@ export declare const sdkReceiptResponseSchema: z.ZodObject<{
             precision: number;
             unit: "minor";
         };
-        receiptId: string;
-        paidRequestId: string;
-        paymentAttemptId: string;
-        organizationId: string;
-        agentId: string;
-        merchantId: string;
         authorizationOutcome: "allowed";
+        reconciliationStatus: "none" | "refunded" | "required" | "in_progress" | "resolved";
         requestUrl: string;
         requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
         createdAt: string;
+        merchantId?: string | undefined;
+        confirmationSource?: "chain_observer" | undefined;
+        attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
+        attributionBasis?: Record<string, unknown> | undefined;
+        attributionRuleVersion?: string | undefined;
+        confirmedAt?: string | undefined;
+        finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
+        canonicalSettlementKey?: string | undefined;
         paymentReference?: string | undefined;
         evidenceSource?: "merchant" | "local_simulation" | undefined;
         settlementEvidenceClass?: "none" | "inconclusive" | "merchant_verifiable_success" | "settled" | undefined;
         settlementIdentifier?: string | undefined;
+        supersededByReceiptId?: string | undefined;
         fulfillmentStatus?: "inconclusive" | "succeeded" | "failed" | undefined;
         completedAt?: string | undefined;
     };