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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (24) hide show
  1. package/LICENSE +201 -0
  2. package/README.md +57 -23
  3. package/dist/challenge-detection.d.ts +7 -5
  4. package/dist/challenge-detection.js +54 -102
  5. package/dist/challenge-detection.js.map +1 -1
  6. package/dist/contracts.d.ts +479 -328
  7. package/dist/contracts.js +44 -13
  8. package/dist/contracts.js.map +1 -1
  9. package/dist/index.d.ts +42 -8
  10. package/dist/index.js +165 -22
  11. package/dist/index.js.map +1 -1
  12. package/dist/version.d.ts +2 -0
  13. package/dist/version.js +4 -0
  14. package/dist/version.js.map +1 -0
  15. package/package.json +19 -7
  16. package/dist/challenge-types.d.ts +0 -57
  17. package/dist/challenge-types.js +0 -111
  18. package/dist/challenge-types.js.map +0 -1
  19. package/dist/x402-v1.d.ts +0 -4
  20. package/dist/x402-v1.js +0 -53
  21. package/dist/x402-v1.js.map +0 -1
  22. package/dist/x402-v2.d.ts +0 -4
  23. package/dist/x402-v2.js +0 -52
  24. package/dist/x402-v2.js.map +0 -1
package/dist/contracts.d.ts CHANGED
@@ -5,13 +5,25 @@ export declare const settlementEvidenceClassSchema: z.ZodEnum<["none", "inconclu
5
5
  export type SettlementEvidenceClass = z.infer<typeof settlementEvidenceClassSchema>;
6
6
  export declare const fulfillmentStatusSchema: z.ZodEnum<["succeeded", "failed", "inconclusive"]>;
7
7
  export type FulfillmentStatus = z.infer<typeof fulfillmentStatusSchema>;
8
+ export declare const receiptStatusSchema: z.ZodEnum<["confirmed", "provisional", "expired_unconfirmed", "refunded", "void"]>;
9
+ export type ReceiptStatus = z.infer<typeof receiptStatusSchema>;
10
+ export declare const receiptReconciliationStatusSchema: z.ZodEnum<["none", "required", "in_progress", "resolved", "refunded"]>;
11
+ export type ReceiptReconciliationStatus = z.infer<typeof receiptReconciliationStatusSchema>;
8
12
  export declare const paymentProofSourceSchema: z.ZodEnum<["merchant", "local_simulation"]>;
9
13
  export type PaymentProofSource = z.infer<typeof paymentProofSourceSchema>;
14
+ export declare const chainAttributionStrengthSchema: z.ZodEnum<["strong_request_scoped", "constrained_unique"]>;
15
+ export type ChainAttributionStrength = z.infer<typeof chainAttributionStrengthSchema>;
16
+ export declare const chainConfirmationSourceSchema: z.ZodEnum<["chain_observer"]>;
17
+ export type ChainConfirmationSource = z.infer<typeof chainConfirmationSourceSchema>;
18
+ export declare const chainFinalityLevelSchema: z.ZodEnum<["evm_block_confirmations_12"]>;
19
+ export type ChainFinalityLevel = z.infer<typeof chainFinalityLevelSchema>;
20
+ export declare const chainAttributionBasisSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
21
+ export type ChainAttributionBasis = z.infer<typeof chainAttributionBasisSchema>;
10
22
  export declare const paidRequestProtocolSchema: z.ZodEnum<["x402", "l402"]>;
11
23
  export type PaidRequestProtocol = z.infer<typeof paidRequestProtocolSchema>;
12
24
  export declare const paidRequestHttpMethodSchema: z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]>;
13
25
  export type PaidRequestHttpMethod = z.infer<typeof paidRequestHttpMethodSchema>;
14
- 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"]>;
26
+ 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"]>;
15
27
  export type PaidRequestReasonCode = z.infer<typeof paidRequestReasonCodeSchema>;
16
28
  export declare const defaultMoneyPrecision = 6;
17
29
  export declare const externalIdSchema: z.ZodString;
@@ -54,31 +66,20 @@ export type NormalizedMoney = z.infer<typeof normalizedMoneySchema>;
54
66
  export declare const paidRequestContextSchema: z.ZodObject<{
55
67
  organization: z.ZodString;
56
68
  agent: z.ZodString;
57
- purpose: z.ZodOptional<z.ZodString>;
69
+ description: z.ZodOptional<z.ZodString>;
58
70
  metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
59
71
  }, "strip", z.ZodTypeAny, {
60
72
  organization: string;
61
73
  agent: string;
62
- purpose?: string | undefined;
74
+ description?: string | undefined;
63
75
  metadata?: Record<string, unknown> | undefined;
64
76
  }, {
65
77
  organization: string;
66
78
  agent: string;
67
- purpose?: string | undefined;
79
+ description?: string | undefined;
68
80
  metadata?: Record<string, unknown> | undefined;
69
81
  }>;
70
82
  export type PaidRequestContext = z.infer<typeof paidRequestContextSchema>;
71
- export declare const paidRequestTargetSchema: z.ZodObject<{
72
- merchant: z.ZodString;
73
- paymentRail: z.ZodString;
74
- }, "strip", z.ZodTypeAny, {
75
- merchant: string;
76
- paymentRail: string;
77
- }, {
78
- merchant: string;
79
- paymentRail: string;
80
- }>;
81
- export type PaidRequestTarget = z.infer<typeof paidRequestTargetSchema>;
82
83
  export declare const paidRequestHttpRequestSchema: z.ZodObject<{
83
84
  url: z.ZodString;
84
85
  method: z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]>;
@@ -101,93 +102,35 @@ export declare const paidRequestHttpRequestSchema: z.ZodObject<{
101
102
  export type PaidRequestHttpRequest = z.infer<typeof paidRequestHttpRequestSchema>;
102
103
  export declare const paidRequestChallengeSchema: z.ZodObject<{
103
104
  protocol: z.ZodEnum<["x402", "l402"]>;
104
- money: z.ZodEffects<z.ZodObject<{
105
- asset: z.ZodString;
106
- amount: z.ZodString;
107
- amountMinor: z.ZodString;
108
- precision: z.ZodNumber;
109
- unit: z.ZodLiteral<"minor">;
110
- }, "strip", z.ZodTypeAny, {
111
- asset: string;
112
- amount: string;
113
- amountMinor: string;
114
- precision: number;
115
- unit: "minor";
116
- }, {
117
- asset: string;
118
- amount: string;
119
- amountMinor: string;
120
- precision: number;
121
- unit: "minor";
122
- }>, {
123
- asset: string;
124
- amount: string;
125
- amountMinor: string;
126
- precision: number;
127
- unit: "minor";
128
- }, {
129
- asset: string;
130
- amount: string;
131
- amountMinor: string;
132
- precision: number;
133
- unit: "minor";
134
- }>;
135
- payee: z.ZodOptional<z.ZodString>;
136
- memo: z.ZodOptional<z.ZodString>;
137
- raw: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
105
+ headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
106
+ body: z.ZodOptional<z.ZodUnknown>;
138
107
  }, "strip", z.ZodTypeAny, {
108
+ headers: Record<string, string>;
139
109
  protocol: "x402" | "l402";
140
- money: {
141
- asset: string;
142
- amount: string;
143
- amountMinor: string;
144
- precision: number;
145
- unit: "minor";
146
- };
147
- raw: Record<string, unknown>;
148
- payee?: string | undefined;
149
- memo?: string | undefined;
110
+ body?: unknown;
150
111
  }, {
151
112
  protocol: "x402" | "l402";
152
- money: {
153
- asset: string;
154
- amount: string;
155
- amountMinor: string;
156
- precision: number;
157
- unit: "minor";
158
- };
159
- payee?: string | undefined;
160
- memo?: string | undefined;
161
- raw?: Record<string, unknown> | undefined;
113
+ headers?: Record<string, string> | undefined;
114
+ body?: unknown;
162
115
  }>;
163
116
  export type PaidRequestChallenge = z.infer<typeof paidRequestChallengeSchema>;
164
117
  export declare const sdkPaymentDecisionRequestSchema: z.ZodObject<{
165
118
  context: z.ZodObject<{
166
119
  organization: z.ZodString;
167
120
  agent: z.ZodString;
168
- purpose: z.ZodOptional<z.ZodString>;
121
+ description: z.ZodOptional<z.ZodString>;
169
122
  metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
170
123
  }, "strip", z.ZodTypeAny, {
171
124
  organization: string;
172
125
  agent: string;
173
- purpose?: string | undefined;
126
+ description?: string | undefined;
174
127
  metadata?: Record<string, unknown> | undefined;
175
128
  }, {
176
129
  organization: string;
177
130
  agent: string;
178
- purpose?: string | undefined;
131
+ description?: string | undefined;
179
132
  metadata?: Record<string, unknown> | undefined;
180
133
  }>;
181
- target: z.ZodObject<{
182
- merchant: z.ZodString;
183
- paymentRail: z.ZodString;
184
- }, "strip", z.ZodTypeAny, {
185
- merchant: string;
186
- paymentRail: string;
187
- }, {
188
- merchant: string;
189
- paymentRail: string;
190
- }>;
191
134
  request: z.ZodObject<{
192
135
  url: z.ZodString;
193
136
  method: z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]>;
@@ -209,77 +152,25 @@ export declare const sdkPaymentDecisionRequestSchema: z.ZodObject<{
209
152
  }>;
210
153
  challenge: z.ZodObject<{
211
154
  protocol: z.ZodEnum<["x402", "l402"]>;
212
- money: z.ZodEffects<z.ZodObject<{
213
- asset: z.ZodString;
214
- amount: z.ZodString;
215
- amountMinor: z.ZodString;
216
- precision: z.ZodNumber;
217
- unit: z.ZodLiteral<"minor">;
218
- }, "strip", z.ZodTypeAny, {
219
- asset: string;
220
- amount: string;
221
- amountMinor: string;
222
- precision: number;
223
- unit: "minor";
224
- }, {
225
- asset: string;
226
- amount: string;
227
- amountMinor: string;
228
- precision: number;
229
- unit: "minor";
230
- }>, {
231
- asset: string;
232
- amount: string;
233
- amountMinor: string;
234
- precision: number;
235
- unit: "minor";
236
- }, {
237
- asset: string;
238
- amount: string;
239
- amountMinor: string;
240
- precision: number;
241
- unit: "minor";
242
- }>;
243
- payee: z.ZodOptional<z.ZodString>;
244
- memo: z.ZodOptional<z.ZodString>;
245
- raw: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
155
+ headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
156
+ body: z.ZodOptional<z.ZodUnknown>;
246
157
  }, "strip", z.ZodTypeAny, {
158
+ headers: Record<string, string>;
247
159
  protocol: "x402" | "l402";
248
- money: {
249
- asset: string;
250
- amount: string;
251
- amountMinor: string;
252
- precision: number;
253
- unit: "minor";
254
- };
255
- raw: Record<string, unknown>;
256
- payee?: string | undefined;
257
- memo?: string | undefined;
160
+ body?: unknown;
258
161
  }, {
259
162
  protocol: "x402" | "l402";
260
- money: {
261
- asset: string;
262
- amount: string;
263
- amountMinor: string;
264
- precision: number;
265
- unit: "minor";
266
- };
267
- payee?: string | undefined;
268
- memo?: string | undefined;
269
- raw?: Record<string, unknown> | undefined;
163
+ headers?: Record<string, string> | undefined;
164
+ body?: unknown;
270
165
  }>;
271
166
  idempotencyKey: z.ZodOptional<z.ZodString>;
272
167
  }, "strip", z.ZodTypeAny, {
273
168
  context: {
274
169
  organization: string;
275
170
  agent: string;
276
- purpose?: string | undefined;
171
+ description?: string | undefined;
277
172
  metadata?: Record<string, unknown> | undefined;
278
173
  };
279
- target: {
280
- merchant: string;
281
- paymentRail: string;
282
- };
283
174
  request: {
284
175
  url: string;
285
176
  method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
@@ -288,30 +179,18 @@ export declare const sdkPaymentDecisionRequestSchema: z.ZodObject<{
288
179
  bodyHash?: string | undefined;
289
180
  };
290
181
  challenge: {
182
+ headers: Record<string, string>;
291
183
  protocol: "x402" | "l402";
292
- money: {
293
- asset: string;
294
- amount: string;
295
- amountMinor: string;
296
- precision: number;
297
- unit: "minor";
298
- };
299
- raw: Record<string, unknown>;
300
- payee?: string | undefined;
301
- memo?: string | undefined;
184
+ body?: unknown;
302
185
  };
303
186
  idempotencyKey?: string | undefined;
304
187
  }, {
305
188
  context: {
306
189
  organization: string;
307
190
  agent: string;
308
- purpose?: string | undefined;
191
+ description?: string | undefined;
309
192
  metadata?: Record<string, unknown> | undefined;
310
193
  };
311
- target: {
312
- merchant: string;
313
- paymentRail: string;
314
- };
315
194
  request: {
316
195
  url: string;
317
196
  method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
@@ -321,16 +200,8 @@ export declare const sdkPaymentDecisionRequestSchema: z.ZodObject<{
321
200
  };
322
201
  challenge: {
323
202
  protocol: "x402" | "l402";
324
- money: {
325
- asset: string;
326
- amount: string;
327
- amountMinor: string;
328
- precision: number;
329
- unit: "minor";
330
- };
331
- payee?: string | undefined;
332
- memo?: string | undefined;
333
- raw?: Record<string, unknown> | undefined;
203
+ headers?: Record<string, string> | undefined;
204
+ body?: unknown;
334
205
  };
335
206
  idempotencyKey?: string | undefined;
336
207
  }>;
@@ -341,7 +212,7 @@ export declare const sdkReceiptSchema: z.ZodObject<{
341
212
  paymentAttemptId: z.ZodString;
342
213
  organizationId: z.ZodString;
343
214
  agentId: z.ZodString;
344
- merchantId: z.ZodString;
215
+ merchantId: z.ZodOptional<z.ZodString>;
345
216
  protocol: z.ZodEnum<["x402", "l402"]>;
346
217
  money: z.ZodEffects<z.ZodObject<{
347
218
  asset: z.ZodString;
@@ -375,17 +246,33 @@ export declare const sdkReceiptSchema: z.ZodObject<{
375
246
  unit: "minor";
376
247
  }>;
377
248
  authorizationOutcome: z.ZodEnum<["allowed"]>;
249
+ status: z.ZodEnum<["confirmed", "provisional", "expired_unconfirmed", "refunded", "void"]>;
250
+ reconciliationStatus: z.ZodEnum<["none", "required", "in_progress", "resolved", "refunded"]>;
251
+ confirmationSource: z.ZodOptional<z.ZodEnum<["chain_observer"]>>;
252
+ attributionStrength: z.ZodOptional<z.ZodEnum<["strong_request_scoped", "constrained_unique"]>>;
253
+ attributionBasis: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
254
+ attributionRuleVersion: z.ZodOptional<z.ZodString>;
255
+ confirmedAt: z.ZodOptional<z.ZodString>;
256
+ finalityLevelUsed: z.ZodOptional<z.ZodEnum<["evm_block_confirmations_12"]>>;
378
257
  requestUrl: z.ZodString;
379
258
  requestMethod: z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]>;
259
+ canonicalSettlementKey: z.ZodOptional<z.ZodString>;
380
260
  paymentReference: z.ZodOptional<z.ZodString>;
381
261
  evidenceSource: z.ZodOptional<z.ZodEnum<["merchant", "local_simulation"]>>;
382
262
  settlementEvidenceClass: z.ZodOptional<z.ZodEnum<["none", "inconclusive", "merchant_verifiable_success", "settled"]>>;
383
263
  settlementIdentifier: z.ZodOptional<z.ZodString>;
264
+ supersededByReceiptId: z.ZodOptional<z.ZodString>;
384
265
  fulfillmentStatus: z.ZodOptional<z.ZodEnum<["succeeded", "failed", "inconclusive"]>>;
385
266
  createdAt: z.ZodString;
386
267
  completedAt: z.ZodOptional<z.ZodString>;
387
268
  }, "strip", z.ZodTypeAny, {
269
+ status: "confirmed" | "provisional" | "expired_unconfirmed" | "refunded" | "void";
388
270
  protocol: "x402" | "l402";
271
+ receiptId: string;
272
+ paidRequestId: string;
273
+ paymentAttemptId: string;
274
+ organizationId: string;
275
+ agentId: string;
389
276
  money: {
390
277
  asset: string;
391
278
  amount: string;
@@ -393,24 +280,34 @@ export declare const sdkReceiptSchema: z.ZodObject<{
393
280
  precision: number;
394
281
  unit: "minor";
395
282
  };
396
- receiptId: string;
397
- paidRequestId: string;
398
- paymentAttemptId: string;
399
- organizationId: string;
400
- agentId: string;
401
- merchantId: string;
402
283
  authorizationOutcome: "allowed";
284
+ reconciliationStatus: "none" | "refunded" | "required" | "in_progress" | "resolved";
403
285
  requestUrl: string;
404
286
  requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
405
287
  createdAt: string;
288
+ merchantId?: string | undefined;
289
+ confirmationSource?: "chain_observer" | undefined;
290
+ attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
291
+ attributionBasis?: Record<string, unknown> | undefined;
292
+ attributionRuleVersion?: string | undefined;
293
+ confirmedAt?: string | undefined;
294
+ finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
295
+ canonicalSettlementKey?: string | undefined;
406
296
  paymentReference?: string | undefined;
407
297
  evidenceSource?: "merchant" | "local_simulation" | undefined;
408
298
  settlementEvidenceClass?: "none" | "inconclusive" | "merchant_verifiable_success" | "settled" | undefined;
409
299
  settlementIdentifier?: string | undefined;
300
+ supersededByReceiptId?: string | undefined;
410
301
  fulfillmentStatus?: "inconclusive" | "succeeded" | "failed" | undefined;
411
302
  completedAt?: string | undefined;
412
303
  }, {
304
+ status: "confirmed" | "provisional" | "expired_unconfirmed" | "refunded" | "void";
413
305
  protocol: "x402" | "l402";
306
+ receiptId: string;
307
+ paidRequestId: string;
308
+ paymentAttemptId: string;
309
+ organizationId: string;
310
+ agentId: string;
414
311
  money: {
415
312
  asset: string;
416
313
  amount: string;
@@ -418,20 +315,24 @@ export declare const sdkReceiptSchema: z.ZodObject<{
418
315
  precision: number;
419
316
  unit: "minor";
420
317
  };
421
- receiptId: string;
422
- paidRequestId: string;
423
- paymentAttemptId: string;
424
- organizationId: string;
425
- agentId: string;
426
- merchantId: string;
427
318
  authorizationOutcome: "allowed";
319
+ reconciliationStatus: "none" | "refunded" | "required" | "in_progress" | "resolved";
428
320
  requestUrl: string;
429
321
  requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
430
322
  createdAt: string;
323
+ merchantId?: string | undefined;
324
+ confirmationSource?: "chain_observer" | undefined;
325
+ attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
326
+ attributionBasis?: Record<string, unknown> | undefined;
327
+ attributionRuleVersion?: string | undefined;
328
+ confirmedAt?: string | undefined;
329
+ finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
330
+ canonicalSettlementKey?: string | undefined;
431
331
  paymentReference?: string | undefined;
432
332
  evidenceSource?: "merchant" | "local_simulation" | undefined;
433
333
  settlementEvidenceClass?: "none" | "inconclusive" | "merchant_verifiable_success" | "settled" | undefined;
434
334
  settlementIdentifier?: string | undefined;
335
+ supersededByReceiptId?: string | undefined;
435
336
  fulfillmentStatus?: "inconclusive" | "succeeded" | "failed" | undefined;
436
337
  completedAt?: string | undefined;
437
338
  }>;
@@ -454,7 +355,7 @@ export declare const sdkPaymentDecisionAllowResponseSchema: z.ZodObject<{
454
355
  outcome: z.ZodLiteral<"allow">;
455
356
  paidRequestId: z.ZodString;
456
357
  paymentAttemptId: z.ZodString;
457
- 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"]>;
358
+ 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"]>;
458
359
  reason: z.ZodString;
459
360
  merchantResponse: z.ZodObject<{
460
361
  status: z.ZodNumber;
@@ -475,7 +376,7 @@ export declare const sdkPaymentDecisionAllowResponseSchema: z.ZodObject<{
475
376
  paymentAttemptId: z.ZodString;
476
377
  organizationId: z.ZodString;
477
378
  agentId: z.ZodString;
478
- merchantId: z.ZodString;
379
+ merchantId: z.ZodOptional<z.ZodString>;
479
380
  protocol: z.ZodEnum<["x402", "l402"]>;
480
381
  money: z.ZodEffects<z.ZodObject<{
481
382
  asset: z.ZodString;
@@ -509,17 +410,33 @@ export declare const sdkPaymentDecisionAllowResponseSchema: z.ZodObject<{
509
410
  unit: "minor";
510
411
  }>;
511
412
  authorizationOutcome: z.ZodEnum<["allowed"]>;
413
+ status: z.ZodEnum<["confirmed", "provisional", "expired_unconfirmed", "refunded", "void"]>;
414
+ reconciliationStatus: z.ZodEnum<["none", "required", "in_progress", "resolved", "refunded"]>;
415
+ confirmationSource: z.ZodOptional<z.ZodEnum<["chain_observer"]>>;
416
+ attributionStrength: z.ZodOptional<z.ZodEnum<["strong_request_scoped", "constrained_unique"]>>;
417
+ attributionBasis: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
418
+ attributionRuleVersion: z.ZodOptional<z.ZodString>;
419
+ confirmedAt: z.ZodOptional<z.ZodString>;
420
+ finalityLevelUsed: z.ZodOptional<z.ZodEnum<["evm_block_confirmations_12"]>>;
512
421
  requestUrl: z.ZodString;
513
422
  requestMethod: z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]>;
423
+ canonicalSettlementKey: z.ZodOptional<z.ZodString>;
514
424
  paymentReference: z.ZodOptional<z.ZodString>;
515
425
  evidenceSource: z.ZodOptional<z.ZodEnum<["merchant", "local_simulation"]>>;
516
426
  settlementEvidenceClass: z.ZodOptional<z.ZodEnum<["none", "inconclusive", "merchant_verifiable_success", "settled"]>>;
517
427
  settlementIdentifier: z.ZodOptional<z.ZodString>;
428
+ supersededByReceiptId: z.ZodOptional<z.ZodString>;
518
429
  fulfillmentStatus: z.ZodOptional<z.ZodEnum<["succeeded", "failed", "inconclusive"]>>;
519
430
  createdAt: z.ZodString;
520
431
  completedAt: z.ZodOptional<z.ZodString>;
521
432
  }, "strip", z.ZodTypeAny, {
433
+ status: "confirmed" | "provisional" | "expired_unconfirmed" | "refunded" | "void";
522
434
  protocol: "x402" | "l402";
435
+ receiptId: string;
436
+ paidRequestId: string;
437
+ paymentAttemptId: string;
438
+ organizationId: string;
439
+ agentId: string;
523
440
  money: {
524
441
  asset: string;
525
442
  amount: string;
@@ -527,24 +444,34 @@ export declare const sdkPaymentDecisionAllowResponseSchema: z.ZodObject<{
527
444
  precision: number;
528
445
  unit: "minor";
529
446
  };
530
- receiptId: string;
531
- paidRequestId: string;
532
- paymentAttemptId: string;
533
- organizationId: string;
534
- agentId: string;
535
- merchantId: string;
536
447
  authorizationOutcome: "allowed";
448
+ reconciliationStatus: "none" | "refunded" | "required" | "in_progress" | "resolved";
537
449
  requestUrl: string;
538
450
  requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
539
451
  createdAt: string;
452
+ merchantId?: string | undefined;
453
+ confirmationSource?: "chain_observer" | undefined;
454
+ attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
455
+ attributionBasis?: Record<string, unknown> | undefined;
456
+ attributionRuleVersion?: string | undefined;
457
+ confirmedAt?: string | undefined;
458
+ finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
459
+ canonicalSettlementKey?: string | undefined;
540
460
  paymentReference?: string | undefined;
541
461
  evidenceSource?: "merchant" | "local_simulation" | undefined;
542
462
  settlementEvidenceClass?: "none" | "inconclusive" | "merchant_verifiable_success" | "settled" | undefined;
543
463
  settlementIdentifier?: string | undefined;
464
+ supersededByReceiptId?: string | undefined;
544
465
  fulfillmentStatus?: "inconclusive" | "succeeded" | "failed" | undefined;
545
466
  completedAt?: string | undefined;
546
467
  }, {
468
+ status: "confirmed" | "provisional" | "expired_unconfirmed" | "refunded" | "void";
547
469
  protocol: "x402" | "l402";
470
+ receiptId: string;
471
+ paidRequestId: string;
472
+ paymentAttemptId: string;
473
+ organizationId: string;
474
+ agentId: string;
548
475
  money: {
549
476
  asset: string;
550
477
  amount: string;
@@ -552,20 +479,24 @@ export declare const sdkPaymentDecisionAllowResponseSchema: z.ZodObject<{
552
479
  precision: number;
553
480
  unit: "minor";
554
481
  };
555
- receiptId: string;
556
- paidRequestId: string;
557
- paymentAttemptId: string;
558
- organizationId: string;
559
- agentId: string;
560
- merchantId: string;
561
482
  authorizationOutcome: "allowed";
483
+ reconciliationStatus: "none" | "refunded" | "required" | "in_progress" | "resolved";
562
484
  requestUrl: string;
563
485
  requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
564
486
  createdAt: string;
487
+ merchantId?: string | undefined;
488
+ confirmationSource?: "chain_observer" | undefined;
489
+ attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
490
+ attributionBasis?: Record<string, unknown> | undefined;
491
+ attributionRuleVersion?: string | undefined;
492
+ confirmedAt?: string | undefined;
493
+ finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
494
+ canonicalSettlementKey?: string | undefined;
565
495
  paymentReference?: string | undefined;
566
496
  evidenceSource?: "merchant" | "local_simulation" | undefined;
567
497
  settlementEvidenceClass?: "none" | "inconclusive" | "merchant_verifiable_success" | "settled" | undefined;
568
498
  settlementIdentifier?: string | undefined;
499
+ supersededByReceiptId?: string | undefined;
569
500
  fulfillmentStatus?: "inconclusive" | "succeeded" | "failed" | undefined;
570
501
  completedAt?: string | undefined;
571
502
  }>;
@@ -573,7 +504,7 @@ export declare const sdkPaymentDecisionAllowResponseSchema: z.ZodObject<{
573
504
  paidRequestId: string;
574
505
  paymentAttemptId: string;
575
506
  outcome: "allow";
576
- 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";
507
+ 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";
577
508
  reason: string;
578
509
  merchantResponse: {
579
510
  status: number;
@@ -581,7 +512,13 @@ export declare const sdkPaymentDecisionAllowResponseSchema: z.ZodObject<{
581
512
  body: string;
582
513
  };
583
514
  receipt: {
515
+ status: "confirmed" | "provisional" | "expired_unconfirmed" | "refunded" | "void";
584
516
  protocol: "x402" | "l402";
517
+ receiptId: string;
518
+ paidRequestId: string;
519
+ paymentAttemptId: string;
520
+ organizationId: string;
521
+ agentId: string;
585
522
  money: {
586
523
  asset: string;
587
524
  amount: string;
@@ -589,20 +526,24 @@ export declare const sdkPaymentDecisionAllowResponseSchema: z.ZodObject<{
589
526
  precision: number;
590
527
  unit: "minor";
591
528
  };
592
- receiptId: string;
593
- paidRequestId: string;
594
- paymentAttemptId: string;
595
- organizationId: string;
596
- agentId: string;
597
- merchantId: string;
598
529
  authorizationOutcome: "allowed";
530
+ reconciliationStatus: "none" | "refunded" | "required" | "in_progress" | "resolved";
599
531
  requestUrl: string;
600
532
  requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
601
533
  createdAt: string;
534
+ merchantId?: string | undefined;
535
+ confirmationSource?: "chain_observer" | undefined;
536
+ attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
537
+ attributionBasis?: Record<string, unknown> | undefined;
538
+ attributionRuleVersion?: string | undefined;
539
+ confirmedAt?: string | undefined;
540
+ finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
541
+ canonicalSettlementKey?: string | undefined;
602
542
  paymentReference?: string | undefined;
603
543
  evidenceSource?: "merchant" | "local_simulation" | undefined;
604
544
  settlementEvidenceClass?: "none" | "inconclusive" | "merchant_verifiable_success" | "settled" | undefined;
605
545
  settlementIdentifier?: string | undefined;
546
+ supersededByReceiptId?: string | undefined;
606
547
  fulfillmentStatus?: "inconclusive" | "succeeded" | "failed" | undefined;
607
548
  completedAt?: string | undefined;
608
549
  };
@@ -610,7 +551,7 @@ export declare const sdkPaymentDecisionAllowResponseSchema: z.ZodObject<{
610
551
  paidRequestId: string;
611
552
  paymentAttemptId: string;
612
553
  outcome: "allow";
613
- 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";
554
+ 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";
614
555
  reason: string;
615
556
  merchantResponse: {
616
557
  status: number;
@@ -618,7 +559,13 @@ export declare const sdkPaymentDecisionAllowResponseSchema: z.ZodObject<{
618
559
  body?: string | undefined;
619
560
  };
620
561
  receipt: {
562
+ status: "confirmed" | "provisional" | "expired_unconfirmed" | "refunded" | "void";
621
563
  protocol: "x402" | "l402";
564
+ receiptId: string;
565
+ paidRequestId: string;
566
+ paymentAttemptId: string;
567
+ organizationId: string;
568
+ agentId: string;
622
569
  money: {
623
570
  asset: string;
624
571
  amount: string;
@@ -626,20 +573,24 @@ export declare const sdkPaymentDecisionAllowResponseSchema: z.ZodObject<{
626
573
  precision: number;
627
574
  unit: "minor";
628
575
  };
629
- receiptId: string;
630
- paidRequestId: string;
631
- paymentAttemptId: string;
632
- organizationId: string;
633
- agentId: string;
634
- merchantId: string;
635
576
  authorizationOutcome: "allowed";
577
+ reconciliationStatus: "none" | "refunded" | "required" | "in_progress" | "resolved";
636
578
  requestUrl: string;
637
579
  requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
638
580
  createdAt: string;
581
+ merchantId?: string | undefined;
582
+ confirmationSource?: "chain_observer" | undefined;
583
+ attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
584
+ attributionBasis?: Record<string, unknown> | undefined;
585
+ attributionRuleVersion?: string | undefined;
586
+ confirmedAt?: string | undefined;
587
+ finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
588
+ canonicalSettlementKey?: string | undefined;
639
589
  paymentReference?: string | undefined;
640
590
  evidenceSource?: "merchant" | "local_simulation" | undefined;
641
591
  settlementEvidenceClass?: "none" | "inconclusive" | "merchant_verifiable_success" | "settled" | undefined;
642
592
  settlementIdentifier?: string | undefined;
593
+ supersededByReceiptId?: string | undefined;
643
594
  fulfillmentStatus?: "inconclusive" | "succeeded" | "failed" | undefined;
644
595
  completedAt?: string | undefined;
645
596
  };
@@ -648,7 +599,7 @@ export declare const sdkPaymentDecisionPaidFulfillmentFailedResponseSchema: z.Zo
648
599
  outcome: z.ZodLiteral<"paid_fulfillment_failed">;
649
600
  paidRequestId: z.ZodString;
650
601
  paymentAttemptId: z.ZodString;
651
- reasonCode: z.ZodLiteral<"merchant_rejected">;
602
+ reasonCode: z.ZodEnum<["merchant_rejected", "merchant_execution_failed"]>;
652
603
  reason: z.ZodString;
653
604
  merchantResponse: z.ZodObject<{
654
605
  status: z.ZodNumber;
@@ -671,7 +622,7 @@ export declare const sdkPaymentDecisionPaidFulfillmentFailedResponseSchema: z.Zo
671
622
  paymentAttemptId: z.ZodString;
672
623
  organizationId: z.ZodString;
673
624
  agentId: z.ZodString;
674
- merchantId: z.ZodString;
625
+ merchantId: z.ZodOptional<z.ZodString>;
675
626
  protocol: z.ZodEnum<["x402", "l402"]>;
676
627
  money: z.ZodEffects<z.ZodObject<{
677
628
  asset: z.ZodString;
@@ -705,17 +656,33 @@ export declare const sdkPaymentDecisionPaidFulfillmentFailedResponseSchema: z.Zo
705
656
  unit: "minor";
706
657
  }>;
707
658
  authorizationOutcome: z.ZodEnum<["allowed"]>;
659
+ status: z.ZodEnum<["confirmed", "provisional", "expired_unconfirmed", "refunded", "void"]>;
660
+ reconciliationStatus: z.ZodEnum<["none", "required", "in_progress", "resolved", "refunded"]>;
661
+ confirmationSource: z.ZodOptional<z.ZodEnum<["chain_observer"]>>;
662
+ attributionStrength: z.ZodOptional<z.ZodEnum<["strong_request_scoped", "constrained_unique"]>>;
663
+ attributionBasis: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
664
+ attributionRuleVersion: z.ZodOptional<z.ZodString>;
665
+ confirmedAt: z.ZodOptional<z.ZodString>;
666
+ finalityLevelUsed: z.ZodOptional<z.ZodEnum<["evm_block_confirmations_12"]>>;
708
667
  requestUrl: z.ZodString;
709
668
  requestMethod: z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]>;
669
+ canonicalSettlementKey: z.ZodOptional<z.ZodString>;
710
670
  paymentReference: z.ZodOptional<z.ZodString>;
711
671
  evidenceSource: z.ZodOptional<z.ZodEnum<["merchant", "local_simulation"]>>;
712
672
  settlementEvidenceClass: z.ZodOptional<z.ZodEnum<["none", "inconclusive", "merchant_verifiable_success", "settled"]>>;
713
673
  settlementIdentifier: z.ZodOptional<z.ZodString>;
674
+ supersededByReceiptId: z.ZodOptional<z.ZodString>;
714
675
  fulfillmentStatus: z.ZodOptional<z.ZodEnum<["succeeded", "failed", "inconclusive"]>>;
715
676
  createdAt: z.ZodString;
716
677
  completedAt: z.ZodOptional<z.ZodString>;
717
678
  }, "strip", z.ZodTypeAny, {
679
+ status: "confirmed" | "provisional" | "expired_unconfirmed" | "refunded" | "void";
718
680
  protocol: "x402" | "l402";
681
+ receiptId: string;
682
+ paidRequestId: string;
683
+ paymentAttemptId: string;
684
+ organizationId: string;
685
+ agentId: string;
719
686
  money: {
720
687
  asset: string;
721
688
  amount: string;
@@ -723,24 +690,34 @@ export declare const sdkPaymentDecisionPaidFulfillmentFailedResponseSchema: z.Zo
723
690
  precision: number;
724
691
  unit: "minor";
725
692
  };
726
- receiptId: string;
727
- paidRequestId: string;
728
- paymentAttemptId: string;
729
- organizationId: string;
730
- agentId: string;
731
- merchantId: string;
732
693
  authorizationOutcome: "allowed";
694
+ reconciliationStatus: "none" | "refunded" | "required" | "in_progress" | "resolved";
733
695
  requestUrl: string;
734
696
  requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
735
697
  createdAt: string;
698
+ merchantId?: string | undefined;
699
+ confirmationSource?: "chain_observer" | undefined;
700
+ attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
701
+ attributionBasis?: Record<string, unknown> | undefined;
702
+ attributionRuleVersion?: string | undefined;
703
+ confirmedAt?: string | undefined;
704
+ finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
705
+ canonicalSettlementKey?: string | undefined;
736
706
  paymentReference?: string | undefined;
737
707
  evidenceSource?: "merchant" | "local_simulation" | undefined;
738
708
  settlementEvidenceClass?: "none" | "inconclusive" | "merchant_verifiable_success" | "settled" | undefined;
739
709
  settlementIdentifier?: string | undefined;
710
+ supersededByReceiptId?: string | undefined;
740
711
  fulfillmentStatus?: "inconclusive" | "succeeded" | "failed" | undefined;
741
712
  completedAt?: string | undefined;
742
713
  }, {
714
+ status: "confirmed" | "provisional" | "expired_unconfirmed" | "refunded" | "void";
743
715
  protocol: "x402" | "l402";
716
+ receiptId: string;
717
+ paidRequestId: string;
718
+ paymentAttemptId: string;
719
+ organizationId: string;
720
+ agentId: string;
744
721
  money: {
745
722
  asset: string;
746
723
  amount: string;
@@ -748,20 +725,24 @@ export declare const sdkPaymentDecisionPaidFulfillmentFailedResponseSchema: z.Zo
748
725
  precision: number;
749
726
  unit: "minor";
750
727
  };
751
- receiptId: string;
752
- paidRequestId: string;
753
- paymentAttemptId: string;
754
- organizationId: string;
755
- agentId: string;
756
- merchantId: string;
757
728
  authorizationOutcome: "allowed";
729
+ reconciliationStatus: "none" | "refunded" | "required" | "in_progress" | "resolved";
758
730
  requestUrl: string;
759
731
  requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
760
732
  createdAt: string;
733
+ merchantId?: string | undefined;
734
+ confirmationSource?: "chain_observer" | undefined;
735
+ attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
736
+ attributionBasis?: Record<string, unknown> | undefined;
737
+ attributionRuleVersion?: string | undefined;
738
+ confirmedAt?: string | undefined;
739
+ finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
740
+ canonicalSettlementKey?: string | undefined;
761
741
  paymentReference?: string | undefined;
762
742
  evidenceSource?: "merchant" | "local_simulation" | undefined;
763
743
  settlementEvidenceClass?: "none" | "inconclusive" | "merchant_verifiable_success" | "settled" | undefined;
764
744
  settlementIdentifier?: string | undefined;
745
+ supersededByReceiptId?: string | undefined;
765
746
  fulfillmentStatus?: "inconclusive" | "succeeded" | "failed" | undefined;
766
747
  completedAt?: string | undefined;
767
748
  }>;
@@ -772,7 +753,7 @@ export declare const sdkPaymentDecisionPaidFulfillmentFailedResponseSchema: z.Zo
772
753
  settlementEvidenceClass: "none" | "inconclusive" | "merchant_verifiable_success" | "settled";
773
754
  fulfillmentStatus: "failed";
774
755
  outcome: "paid_fulfillment_failed";
775
- reasonCode: "merchant_rejected";
756
+ reasonCode: "merchant_rejected" | "merchant_execution_failed";
776
757
  reason: string;
777
758
  merchantResponse: {
778
759
  status: number;
@@ -780,7 +761,13 @@ export declare const sdkPaymentDecisionPaidFulfillmentFailedResponseSchema: z.Zo
780
761
  body: string;
781
762
  };
782
763
  receipt: {
764
+ status: "confirmed" | "provisional" | "expired_unconfirmed" | "refunded" | "void";
783
765
  protocol: "x402" | "l402";
766
+ receiptId: string;
767
+ paidRequestId: string;
768
+ paymentAttemptId: string;
769
+ organizationId: string;
770
+ agentId: string;
784
771
  money: {
785
772
  asset: string;
786
773
  amount: string;
@@ -788,20 +775,24 @@ export declare const sdkPaymentDecisionPaidFulfillmentFailedResponseSchema: z.Zo
788
775
  precision: number;
789
776
  unit: "minor";
790
777
  };
791
- receiptId: string;
792
- paidRequestId: string;
793
- paymentAttemptId: string;
794
- organizationId: string;
795
- agentId: string;
796
- merchantId: string;
797
778
  authorizationOutcome: "allowed";
779
+ reconciliationStatus: "none" | "refunded" | "required" | "in_progress" | "resolved";
798
780
  requestUrl: string;
799
781
  requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
800
782
  createdAt: string;
783
+ merchantId?: string | undefined;
784
+ confirmationSource?: "chain_observer" | undefined;
785
+ attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
786
+ attributionBasis?: Record<string, unknown> | undefined;
787
+ attributionRuleVersion?: string | undefined;
788
+ confirmedAt?: string | undefined;
789
+ finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
790
+ canonicalSettlementKey?: string | undefined;
801
791
  paymentReference?: string | undefined;
802
792
  evidenceSource?: "merchant" | "local_simulation" | undefined;
803
793
  settlementEvidenceClass?: "none" | "inconclusive" | "merchant_verifiable_success" | "settled" | undefined;
804
794
  settlementIdentifier?: string | undefined;
795
+ supersededByReceiptId?: string | undefined;
805
796
  fulfillmentStatus?: "inconclusive" | "succeeded" | "failed" | undefined;
806
797
  completedAt?: string | undefined;
807
798
  };
@@ -812,7 +803,7 @@ export declare const sdkPaymentDecisionPaidFulfillmentFailedResponseSchema: z.Zo
812
803
  settlementEvidenceClass: "none" | "inconclusive" | "merchant_verifiable_success" | "settled";
813
804
  fulfillmentStatus: "failed";
814
805
  outcome: "paid_fulfillment_failed";
815
- reasonCode: "merchant_rejected";
806
+ reasonCode: "merchant_rejected" | "merchant_execution_failed";
816
807
  reason: string;
817
808
  merchantResponse: {
818
809
  status: number;
@@ -820,7 +811,13 @@ export declare const sdkPaymentDecisionPaidFulfillmentFailedResponseSchema: z.Zo
820
811
  body?: string | undefined;
821
812
  };
822
813
  receipt: {
814
+ status: "confirmed" | "provisional" | "expired_unconfirmed" | "refunded" | "void";
823
815
  protocol: "x402" | "l402";
816
+ receiptId: string;
817
+ paidRequestId: string;
818
+ paymentAttemptId: string;
819
+ organizationId: string;
820
+ agentId: string;
824
821
  money: {
825
822
  asset: string;
826
823
  amount: string;
@@ -828,20 +825,24 @@ export declare const sdkPaymentDecisionPaidFulfillmentFailedResponseSchema: z.Zo
828
825
  precision: number;
829
826
  unit: "minor";
830
827
  };
831
- receiptId: string;
832
- paidRequestId: string;
833
- paymentAttemptId: string;
834
- organizationId: string;
835
- agentId: string;
836
- merchantId: string;
837
828
  authorizationOutcome: "allowed";
829
+ reconciliationStatus: "none" | "refunded" | "required" | "in_progress" | "resolved";
838
830
  requestUrl: string;
839
831
  requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
840
832
  createdAt: string;
833
+ merchantId?: string | undefined;
834
+ confirmationSource?: "chain_observer" | undefined;
835
+ attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
836
+ attributionBasis?: Record<string, unknown> | undefined;
837
+ attributionRuleVersion?: string | undefined;
838
+ confirmedAt?: string | undefined;
839
+ finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
840
+ canonicalSettlementKey?: string | undefined;
841
841
  paymentReference?: string | undefined;
842
842
  evidenceSource?: "merchant" | "local_simulation" | undefined;
843
843
  settlementEvidenceClass?: "none" | "inconclusive" | "merchant_verifiable_success" | "settled" | undefined;
844
844
  settlementIdentifier?: string | undefined;
845
+ supersededByReceiptId?: string | undefined;
845
846
  fulfillmentStatus?: "inconclusive" | "succeeded" | "failed" | undefined;
846
847
  completedAt?: string | undefined;
847
848
  };
@@ -851,7 +852,7 @@ export declare const sdkPaymentDecisionExecutionFailedResponseSchema: z.ZodObjec
851
852
  outcome: z.ZodLiteral<"execution_failed">;
852
853
  paidRequestId: z.ZodString;
853
854
  paymentAttemptId: z.ZodString;
854
- reasonCode: z.ZodEnum<["merchant_rejected", "settlement_proof_conflict"]>;
855
+ reasonCode: z.ZodEnum<["merchant_rejected", "merchant_execution_failed"]>;
855
856
  reason: z.ZodString;
856
857
  merchantResponse: z.ZodObject<{
857
858
  status: z.ZodNumber;
@@ -871,7 +872,7 @@ export declare const sdkPaymentDecisionExecutionFailedResponseSchema: z.ZodObjec
871
872
  paidRequestId: string;
872
873
  paymentAttemptId: string;
873
874
  outcome: "execution_failed";
874
- reasonCode: "merchant_rejected" | "settlement_proof_conflict";
875
+ reasonCode: "merchant_rejected" | "merchant_execution_failed";
875
876
  reason: string;
876
877
  merchantResponse: {
877
878
  status: number;
@@ -883,7 +884,7 @@ export declare const sdkPaymentDecisionExecutionFailedResponseSchema: z.ZodObjec
883
884
  paidRequestId: string;
884
885
  paymentAttemptId: string;
885
886
  outcome: "execution_failed";
886
- reasonCode: "merchant_rejected" | "settlement_proof_conflict";
887
+ reasonCode: "merchant_rejected" | "merchant_execution_failed";
887
888
  reason: string;
888
889
  merchantResponse: {
889
890
  status: number;
@@ -958,18 +959,18 @@ export declare const sdkPaymentDecisionInconclusiveResponseSchema: z.ZodObject<{
958
959
  export declare const sdkPaymentDecisionDenyResponseSchema: z.ZodObject<{
959
960
  outcome: z.ZodLiteral<"deny">;
960
961
  paidRequestId: z.ZodOptional<z.ZodString>;
961
- 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"]>;
962
+ 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"]>;
962
963
  reason: z.ZodString;
963
964
  policyReviewEventId: z.ZodOptional<z.ZodString>;
964
965
  }, "strip", z.ZodTypeAny, {
965
966
  outcome: "deny";
966
- 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";
967
+ 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";
967
968
  reason: string;
968
969
  paidRequestId?: string | undefined;
969
970
  policyReviewEventId?: string | undefined;
970
971
  }, {
971
972
  outcome: "deny";
972
- 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";
973
+ 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";
973
974
  reason: string;
974
975
  paidRequestId?: string | undefined;
975
976
  policyReviewEventId?: string | undefined;
@@ -978,7 +979,7 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
978
979
  outcome: z.ZodLiteral<"allow">;
979
980
  paidRequestId: z.ZodString;
980
981
  paymentAttemptId: z.ZodString;
981
- 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"]>;
982
+ 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"]>;
982
983
  reason: z.ZodString;
983
984
  merchantResponse: z.ZodObject<{
984
985
  status: z.ZodNumber;
@@ -999,7 +1000,7 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
999
1000
  paymentAttemptId: z.ZodString;
1000
1001
  organizationId: z.ZodString;
1001
1002
  agentId: z.ZodString;
1002
- merchantId: z.ZodString;
1003
+ merchantId: z.ZodOptional<z.ZodString>;
1003
1004
  protocol: z.ZodEnum<["x402", "l402"]>;
1004
1005
  money: z.ZodEffects<z.ZodObject<{
1005
1006
  asset: z.ZodString;
@@ -1033,17 +1034,33 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
1033
1034
  unit: "minor";
1034
1035
  }>;
1035
1036
  authorizationOutcome: z.ZodEnum<["allowed"]>;
1037
+ status: z.ZodEnum<["confirmed", "provisional", "expired_unconfirmed", "refunded", "void"]>;
1038
+ reconciliationStatus: z.ZodEnum<["none", "required", "in_progress", "resolved", "refunded"]>;
1039
+ confirmationSource: z.ZodOptional<z.ZodEnum<["chain_observer"]>>;
1040
+ attributionStrength: z.ZodOptional<z.ZodEnum<["strong_request_scoped", "constrained_unique"]>>;
1041
+ attributionBasis: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
1042
+ attributionRuleVersion: z.ZodOptional<z.ZodString>;
1043
+ confirmedAt: z.ZodOptional<z.ZodString>;
1044
+ finalityLevelUsed: z.ZodOptional<z.ZodEnum<["evm_block_confirmations_12"]>>;
1036
1045
  requestUrl: z.ZodString;
1037
1046
  requestMethod: z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]>;
1047
+ canonicalSettlementKey: z.ZodOptional<z.ZodString>;
1038
1048
  paymentReference: z.ZodOptional<z.ZodString>;
1039
1049
  evidenceSource: z.ZodOptional<z.ZodEnum<["merchant", "local_simulation"]>>;
1040
1050
  settlementEvidenceClass: z.ZodOptional<z.ZodEnum<["none", "inconclusive", "merchant_verifiable_success", "settled"]>>;
1041
1051
  settlementIdentifier: z.ZodOptional<z.ZodString>;
1052
+ supersededByReceiptId: z.ZodOptional<z.ZodString>;
1042
1053
  fulfillmentStatus: z.ZodOptional<z.ZodEnum<["succeeded", "failed", "inconclusive"]>>;
1043
1054
  createdAt: z.ZodString;
1044
1055
  completedAt: z.ZodOptional<z.ZodString>;
1045
1056
  }, "strip", z.ZodTypeAny, {
1057
+ status: "confirmed" | "provisional" | "expired_unconfirmed" | "refunded" | "void";
1046
1058
  protocol: "x402" | "l402";
1059
+ receiptId: string;
1060
+ paidRequestId: string;
1061
+ paymentAttemptId: string;
1062
+ organizationId: string;
1063
+ agentId: string;
1047
1064
  money: {
1048
1065
  asset: string;
1049
1066
  amount: string;
@@ -1051,24 +1068,34 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
1051
1068
  precision: number;
1052
1069
  unit: "minor";
1053
1070
  };
1054
- receiptId: string;
1055
- paidRequestId: string;
1056
- paymentAttemptId: string;
1057
- organizationId: string;
1058
- agentId: string;
1059
- merchantId: string;
1060
1071
  authorizationOutcome: "allowed";
1072
+ reconciliationStatus: "none" | "refunded" | "required" | "in_progress" | "resolved";
1061
1073
  requestUrl: string;
1062
1074
  requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
1063
1075
  createdAt: string;
1076
+ merchantId?: string | undefined;
1077
+ confirmationSource?: "chain_observer" | undefined;
1078
+ attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
1079
+ attributionBasis?: Record<string, unknown> | undefined;
1080
+ attributionRuleVersion?: string | undefined;
1081
+ confirmedAt?: string | undefined;
1082
+ finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
1083
+ canonicalSettlementKey?: string | undefined;
1064
1084
  paymentReference?: string | undefined;
1065
1085
  evidenceSource?: "merchant" | "local_simulation" | undefined;
1066
1086
  settlementEvidenceClass?: "none" | "inconclusive" | "merchant_verifiable_success" | "settled" | undefined;
1067
1087
  settlementIdentifier?: string | undefined;
1088
+ supersededByReceiptId?: string | undefined;
1068
1089
  fulfillmentStatus?: "inconclusive" | "succeeded" | "failed" | undefined;
1069
1090
  completedAt?: string | undefined;
1070
1091
  }, {
1092
+ status: "confirmed" | "provisional" | "expired_unconfirmed" | "refunded" | "void";
1071
1093
  protocol: "x402" | "l402";
1094
+ receiptId: string;
1095
+ paidRequestId: string;
1096
+ paymentAttemptId: string;
1097
+ organizationId: string;
1098
+ agentId: string;
1072
1099
  money: {
1073
1100
  asset: string;
1074
1101
  amount: string;
@@ -1076,20 +1103,24 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
1076
1103
  precision: number;
1077
1104
  unit: "minor";
1078
1105
  };
1079
- receiptId: string;
1080
- paidRequestId: string;
1081
- paymentAttemptId: string;
1082
- organizationId: string;
1083
- agentId: string;
1084
- merchantId: string;
1085
1106
  authorizationOutcome: "allowed";
1107
+ reconciliationStatus: "none" | "refunded" | "required" | "in_progress" | "resolved";
1086
1108
  requestUrl: string;
1087
1109
  requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
1088
1110
  createdAt: string;
1111
+ merchantId?: string | undefined;
1112
+ confirmationSource?: "chain_observer" | undefined;
1113
+ attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
1114
+ attributionBasis?: Record<string, unknown> | undefined;
1115
+ attributionRuleVersion?: string | undefined;
1116
+ confirmedAt?: string | undefined;
1117
+ finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
1118
+ canonicalSettlementKey?: string | undefined;
1089
1119
  paymentReference?: string | undefined;
1090
1120
  evidenceSource?: "merchant" | "local_simulation" | undefined;
1091
1121
  settlementEvidenceClass?: "none" | "inconclusive" | "merchant_verifiable_success" | "settled" | undefined;
1092
1122
  settlementIdentifier?: string | undefined;
1123
+ supersededByReceiptId?: string | undefined;
1093
1124
  fulfillmentStatus?: "inconclusive" | "succeeded" | "failed" | undefined;
1094
1125
  completedAt?: string | undefined;
1095
1126
  }>;
@@ -1097,7 +1128,7 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
1097
1128
  paidRequestId: string;
1098
1129
  paymentAttemptId: string;
1099
1130
  outcome: "allow";
1100
- 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";
1131
+ 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";
1101
1132
  reason: string;
1102
1133
  merchantResponse: {
1103
1134
  status: number;
@@ -1105,7 +1136,13 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
1105
1136
  body: string;
1106
1137
  };
1107
1138
  receipt: {
1139
+ status: "confirmed" | "provisional" | "expired_unconfirmed" | "refunded" | "void";
1108
1140
  protocol: "x402" | "l402";
1141
+ receiptId: string;
1142
+ paidRequestId: string;
1143
+ paymentAttemptId: string;
1144
+ organizationId: string;
1145
+ agentId: string;
1109
1146
  money: {
1110
1147
  asset: string;
1111
1148
  amount: string;
@@ -1113,20 +1150,24 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
1113
1150
  precision: number;
1114
1151
  unit: "minor";
1115
1152
  };
1116
- receiptId: string;
1117
- paidRequestId: string;
1118
- paymentAttemptId: string;
1119
- organizationId: string;
1120
- agentId: string;
1121
- merchantId: string;
1122
1153
  authorizationOutcome: "allowed";
1154
+ reconciliationStatus: "none" | "refunded" | "required" | "in_progress" | "resolved";
1123
1155
  requestUrl: string;
1124
1156
  requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
1125
1157
  createdAt: string;
1158
+ merchantId?: string | undefined;
1159
+ confirmationSource?: "chain_observer" | undefined;
1160
+ attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
1161
+ attributionBasis?: Record<string, unknown> | undefined;
1162
+ attributionRuleVersion?: string | undefined;
1163
+ confirmedAt?: string | undefined;
1164
+ finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
1165
+ canonicalSettlementKey?: string | undefined;
1126
1166
  paymentReference?: string | undefined;
1127
1167
  evidenceSource?: "merchant" | "local_simulation" | undefined;
1128
1168
  settlementEvidenceClass?: "none" | "inconclusive" | "merchant_verifiable_success" | "settled" | undefined;
1129
1169
  settlementIdentifier?: string | undefined;
1170
+ supersededByReceiptId?: string | undefined;
1130
1171
  fulfillmentStatus?: "inconclusive" | "succeeded" | "failed" | undefined;
1131
1172
  completedAt?: string | undefined;
1132
1173
  };
@@ -1134,7 +1175,7 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
1134
1175
  paidRequestId: string;
1135
1176
  paymentAttemptId: string;
1136
1177
  outcome: "allow";
1137
- 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";
1178
+ 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";
1138
1179
  reason: string;
1139
1180
  merchantResponse: {
1140
1181
  status: number;
@@ -1142,7 +1183,13 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
1142
1183
  body?: string | undefined;
1143
1184
  };
1144
1185
  receipt: {
1186
+ status: "confirmed" | "provisional" | "expired_unconfirmed" | "refunded" | "void";
1145
1187
  protocol: "x402" | "l402";
1188
+ receiptId: string;
1189
+ paidRequestId: string;
1190
+ paymentAttemptId: string;
1191
+ organizationId: string;
1192
+ agentId: string;
1146
1193
  money: {
1147
1194
  asset: string;
1148
1195
  amount: string;
@@ -1150,20 +1197,24 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
1150
1197
  precision: number;
1151
1198
  unit: "minor";
1152
1199
  };
1153
- receiptId: string;
1154
- paidRequestId: string;
1155
- paymentAttemptId: string;
1156
- organizationId: string;
1157
- agentId: string;
1158
- merchantId: string;
1159
1200
  authorizationOutcome: "allowed";
1201
+ reconciliationStatus: "none" | "refunded" | "required" | "in_progress" | "resolved";
1160
1202
  requestUrl: string;
1161
1203
  requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
1162
1204
  createdAt: string;
1205
+ merchantId?: string | undefined;
1206
+ confirmationSource?: "chain_observer" | undefined;
1207
+ attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
1208
+ attributionBasis?: Record<string, unknown> | undefined;
1209
+ attributionRuleVersion?: string | undefined;
1210
+ confirmedAt?: string | undefined;
1211
+ finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
1212
+ canonicalSettlementKey?: string | undefined;
1163
1213
  paymentReference?: string | undefined;
1164
1214
  evidenceSource?: "merchant" | "local_simulation" | undefined;
1165
1215
  settlementEvidenceClass?: "none" | "inconclusive" | "merchant_verifiable_success" | "settled" | undefined;
1166
1216
  settlementIdentifier?: string | undefined;
1217
+ supersededByReceiptId?: string | undefined;
1167
1218
  fulfillmentStatus?: "inconclusive" | "succeeded" | "failed" | undefined;
1168
1219
  completedAt?: string | undefined;
1169
1220
  };
@@ -1171,7 +1222,7 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
1171
1222
  outcome: z.ZodLiteral<"paid_fulfillment_failed">;
1172
1223
  paidRequestId: z.ZodString;
1173
1224
  paymentAttemptId: z.ZodString;
1174
- reasonCode: z.ZodLiteral<"merchant_rejected">;
1225
+ reasonCode: z.ZodEnum<["merchant_rejected", "merchant_execution_failed"]>;
1175
1226
  reason: z.ZodString;
1176
1227
  merchantResponse: z.ZodObject<{
1177
1228
  status: z.ZodNumber;
@@ -1194,7 +1245,7 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
1194
1245
  paymentAttemptId: z.ZodString;
1195
1246
  organizationId: z.ZodString;
1196
1247
  agentId: z.ZodString;
1197
- merchantId: z.ZodString;
1248
+ merchantId: z.ZodOptional<z.ZodString>;
1198
1249
  protocol: z.ZodEnum<["x402", "l402"]>;
1199
1250
  money: z.ZodEffects<z.ZodObject<{
1200
1251
  asset: z.ZodString;
@@ -1228,17 +1279,33 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
1228
1279
  unit: "minor";
1229
1280
  }>;
1230
1281
  authorizationOutcome: z.ZodEnum<["allowed"]>;
1282
+ status: z.ZodEnum<["confirmed", "provisional", "expired_unconfirmed", "refunded", "void"]>;
1283
+ reconciliationStatus: z.ZodEnum<["none", "required", "in_progress", "resolved", "refunded"]>;
1284
+ confirmationSource: z.ZodOptional<z.ZodEnum<["chain_observer"]>>;
1285
+ attributionStrength: z.ZodOptional<z.ZodEnum<["strong_request_scoped", "constrained_unique"]>>;
1286
+ attributionBasis: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
1287
+ attributionRuleVersion: z.ZodOptional<z.ZodString>;
1288
+ confirmedAt: z.ZodOptional<z.ZodString>;
1289
+ finalityLevelUsed: z.ZodOptional<z.ZodEnum<["evm_block_confirmations_12"]>>;
1231
1290
  requestUrl: z.ZodString;
1232
1291
  requestMethod: z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]>;
1292
+ canonicalSettlementKey: z.ZodOptional<z.ZodString>;
1233
1293
  paymentReference: z.ZodOptional<z.ZodString>;
1234
1294
  evidenceSource: z.ZodOptional<z.ZodEnum<["merchant", "local_simulation"]>>;
1235
1295
  settlementEvidenceClass: z.ZodOptional<z.ZodEnum<["none", "inconclusive", "merchant_verifiable_success", "settled"]>>;
1236
1296
  settlementIdentifier: z.ZodOptional<z.ZodString>;
1297
+ supersededByReceiptId: z.ZodOptional<z.ZodString>;
1237
1298
  fulfillmentStatus: z.ZodOptional<z.ZodEnum<["succeeded", "failed", "inconclusive"]>>;
1238
1299
  createdAt: z.ZodString;
1239
1300
  completedAt: z.ZodOptional<z.ZodString>;
1240
1301
  }, "strip", z.ZodTypeAny, {
1302
+ status: "confirmed" | "provisional" | "expired_unconfirmed" | "refunded" | "void";
1241
1303
  protocol: "x402" | "l402";
1304
+ receiptId: string;
1305
+ paidRequestId: string;
1306
+ paymentAttemptId: string;
1307
+ organizationId: string;
1308
+ agentId: string;
1242
1309
  money: {
1243
1310
  asset: string;
1244
1311
  amount: string;
@@ -1246,24 +1313,34 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
1246
1313
  precision: number;
1247
1314
  unit: "minor";
1248
1315
  };
1249
- receiptId: string;
1250
- paidRequestId: string;
1251
- paymentAttemptId: string;
1252
- organizationId: string;
1253
- agentId: string;
1254
- merchantId: string;
1255
1316
  authorizationOutcome: "allowed";
1317
+ reconciliationStatus: "none" | "refunded" | "required" | "in_progress" | "resolved";
1256
1318
  requestUrl: string;
1257
1319
  requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
1258
1320
  createdAt: string;
1321
+ merchantId?: string | undefined;
1322
+ confirmationSource?: "chain_observer" | undefined;
1323
+ attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
1324
+ attributionBasis?: Record<string, unknown> | undefined;
1325
+ attributionRuleVersion?: string | undefined;
1326
+ confirmedAt?: string | undefined;
1327
+ finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
1328
+ canonicalSettlementKey?: string | undefined;
1259
1329
  paymentReference?: string | undefined;
1260
1330
  evidenceSource?: "merchant" | "local_simulation" | undefined;
1261
1331
  settlementEvidenceClass?: "none" | "inconclusive" | "merchant_verifiable_success" | "settled" | undefined;
1262
1332
  settlementIdentifier?: string | undefined;
1333
+ supersededByReceiptId?: string | undefined;
1263
1334
  fulfillmentStatus?: "inconclusive" | "succeeded" | "failed" | undefined;
1264
1335
  completedAt?: string | undefined;
1265
1336
  }, {
1337
+ status: "confirmed" | "provisional" | "expired_unconfirmed" | "refunded" | "void";
1266
1338
  protocol: "x402" | "l402";
1339
+ receiptId: string;
1340
+ paidRequestId: string;
1341
+ paymentAttemptId: string;
1342
+ organizationId: string;
1343
+ agentId: string;
1267
1344
  money: {
1268
1345
  asset: string;
1269
1346
  amount: string;
@@ -1271,20 +1348,24 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
1271
1348
  precision: number;
1272
1349
  unit: "minor";
1273
1350
  };
1274
- receiptId: string;
1275
- paidRequestId: string;
1276
- paymentAttemptId: string;
1277
- organizationId: string;
1278
- agentId: string;
1279
- merchantId: string;
1280
1351
  authorizationOutcome: "allowed";
1352
+ reconciliationStatus: "none" | "refunded" | "required" | "in_progress" | "resolved";
1281
1353
  requestUrl: string;
1282
1354
  requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
1283
1355
  createdAt: string;
1356
+ merchantId?: string | undefined;
1357
+ confirmationSource?: "chain_observer" | undefined;
1358
+ attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
1359
+ attributionBasis?: Record<string, unknown> | undefined;
1360
+ attributionRuleVersion?: string | undefined;
1361
+ confirmedAt?: string | undefined;
1362
+ finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
1363
+ canonicalSettlementKey?: string | undefined;
1284
1364
  paymentReference?: string | undefined;
1285
1365
  evidenceSource?: "merchant" | "local_simulation" | undefined;
1286
1366
  settlementEvidenceClass?: "none" | "inconclusive" | "merchant_verifiable_success" | "settled" | undefined;
1287
1367
  settlementIdentifier?: string | undefined;
1368
+ supersededByReceiptId?: string | undefined;
1288
1369
  fulfillmentStatus?: "inconclusive" | "succeeded" | "failed" | undefined;
1289
1370
  completedAt?: string | undefined;
1290
1371
  }>;
@@ -1295,7 +1376,7 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
1295
1376
  settlementEvidenceClass: "none" | "inconclusive" | "merchant_verifiable_success" | "settled";
1296
1377
  fulfillmentStatus: "failed";
1297
1378
  outcome: "paid_fulfillment_failed";
1298
- reasonCode: "merchant_rejected";
1379
+ reasonCode: "merchant_rejected" | "merchant_execution_failed";
1299
1380
  reason: string;
1300
1381
  merchantResponse: {
1301
1382
  status: number;
@@ -1303,7 +1384,13 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
1303
1384
  body: string;
1304
1385
  };
1305
1386
  receipt: {
1387
+ status: "confirmed" | "provisional" | "expired_unconfirmed" | "refunded" | "void";
1306
1388
  protocol: "x402" | "l402";
1389
+ receiptId: string;
1390
+ paidRequestId: string;
1391
+ paymentAttemptId: string;
1392
+ organizationId: string;
1393
+ agentId: string;
1307
1394
  money: {
1308
1395
  asset: string;
1309
1396
  amount: string;
@@ -1311,20 +1398,24 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
1311
1398
  precision: number;
1312
1399
  unit: "minor";
1313
1400
  };
1314
- receiptId: string;
1315
- paidRequestId: string;
1316
- paymentAttemptId: string;
1317
- organizationId: string;
1318
- agentId: string;
1319
- merchantId: string;
1320
1401
  authorizationOutcome: "allowed";
1402
+ reconciliationStatus: "none" | "refunded" | "required" | "in_progress" | "resolved";
1321
1403
  requestUrl: string;
1322
1404
  requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
1323
1405
  createdAt: string;
1406
+ merchantId?: string | undefined;
1407
+ confirmationSource?: "chain_observer" | undefined;
1408
+ attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
1409
+ attributionBasis?: Record<string, unknown> | undefined;
1410
+ attributionRuleVersion?: string | undefined;
1411
+ confirmedAt?: string | undefined;
1412
+ finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
1413
+ canonicalSettlementKey?: string | undefined;
1324
1414
  paymentReference?: string | undefined;
1325
1415
  evidenceSource?: "merchant" | "local_simulation" | undefined;
1326
1416
  settlementEvidenceClass?: "none" | "inconclusive" | "merchant_verifiable_success" | "settled" | undefined;
1327
1417
  settlementIdentifier?: string | undefined;
1418
+ supersededByReceiptId?: string | undefined;
1328
1419
  fulfillmentStatus?: "inconclusive" | "succeeded" | "failed" | undefined;
1329
1420
  completedAt?: string | undefined;
1330
1421
  };
@@ -1335,7 +1426,7 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
1335
1426
  settlementEvidenceClass: "none" | "inconclusive" | "merchant_verifiable_success" | "settled";
1336
1427
  fulfillmentStatus: "failed";
1337
1428
  outcome: "paid_fulfillment_failed";
1338
- reasonCode: "merchant_rejected";
1429
+ reasonCode: "merchant_rejected" | "merchant_execution_failed";
1339
1430
  reason: string;
1340
1431
  merchantResponse: {
1341
1432
  status: number;
@@ -1343,7 +1434,13 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
1343
1434
  body?: string | undefined;
1344
1435
  };
1345
1436
  receipt: {
1437
+ status: "confirmed" | "provisional" | "expired_unconfirmed" | "refunded" | "void";
1346
1438
  protocol: "x402" | "l402";
1439
+ receiptId: string;
1440
+ paidRequestId: string;
1441
+ paymentAttemptId: string;
1442
+ organizationId: string;
1443
+ agentId: string;
1347
1444
  money: {
1348
1445
  asset: string;
1349
1446
  amount: string;
@@ -1351,20 +1448,24 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
1351
1448
  precision: number;
1352
1449
  unit: "minor";
1353
1450
  };
1354
- receiptId: string;
1355
- paidRequestId: string;
1356
- paymentAttemptId: string;
1357
- organizationId: string;
1358
- agentId: string;
1359
- merchantId: string;
1360
1451
  authorizationOutcome: "allowed";
1452
+ reconciliationStatus: "none" | "refunded" | "required" | "in_progress" | "resolved";
1361
1453
  requestUrl: string;
1362
1454
  requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
1363
1455
  createdAt: string;
1456
+ merchantId?: string | undefined;
1457
+ confirmationSource?: "chain_observer" | undefined;
1458
+ attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
1459
+ attributionBasis?: Record<string, unknown> | undefined;
1460
+ attributionRuleVersion?: string | undefined;
1461
+ confirmedAt?: string | undefined;
1462
+ finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
1463
+ canonicalSettlementKey?: string | undefined;
1364
1464
  paymentReference?: string | undefined;
1365
1465
  evidenceSource?: "merchant" | "local_simulation" | undefined;
1366
1466
  settlementEvidenceClass?: "none" | "inconclusive" | "merchant_verifiable_success" | "settled" | undefined;
1367
1467
  settlementIdentifier?: string | undefined;
1468
+ supersededByReceiptId?: string | undefined;
1368
1469
  fulfillmentStatus?: "inconclusive" | "succeeded" | "failed" | undefined;
1369
1470
  completedAt?: string | undefined;
1370
1471
  };
@@ -1412,7 +1513,7 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
1412
1513
  outcome: z.ZodLiteral<"execution_failed">;
1413
1514
  paidRequestId: z.ZodString;
1414
1515
  paymentAttemptId: z.ZodString;
1415
- reasonCode: z.ZodEnum<["merchant_rejected", "settlement_proof_conflict"]>;
1516
+ reasonCode: z.ZodEnum<["merchant_rejected", "merchant_execution_failed"]>;
1416
1517
  reason: z.ZodString;
1417
1518
  merchantResponse: z.ZodObject<{
1418
1519
  status: z.ZodNumber;
@@ -1432,7 +1533,7 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
1432
1533
  paidRequestId: string;
1433
1534
  paymentAttemptId: string;
1434
1535
  outcome: "execution_failed";
1435
- reasonCode: "merchant_rejected" | "settlement_proof_conflict";
1536
+ reasonCode: "merchant_rejected" | "merchant_execution_failed";
1436
1537
  reason: string;
1437
1538
  merchantResponse: {
1438
1539
  status: number;
@@ -1444,7 +1545,7 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
1444
1545
  paidRequestId: string;
1445
1546
  paymentAttemptId: string;
1446
1547
  outcome: "execution_failed";
1447
- reasonCode: "merchant_rejected" | "settlement_proof_conflict";
1548
+ reasonCode: "merchant_rejected" | "merchant_execution_failed";
1448
1549
  reason: string;
1449
1550
  merchantResponse: {
1450
1551
  status: number;
@@ -1476,18 +1577,18 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
1476
1577
  }>, z.ZodObject<{
1477
1578
  outcome: z.ZodLiteral<"deny">;
1478
1579
  paidRequestId: z.ZodOptional<z.ZodString>;
1479
- 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"]>;
1580
+ 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"]>;
1480
1581
  reason: z.ZodString;
1481
1582
  policyReviewEventId: z.ZodOptional<z.ZodString>;
1482
1583
  }, "strip", z.ZodTypeAny, {
1483
1584
  outcome: "deny";
1484
- 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";
1585
+ 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";
1485
1586
  reason: string;
1486
1587
  paidRequestId?: string | undefined;
1487
1588
  policyReviewEventId?: string | undefined;
1488
1589
  }, {
1489
1590
  outcome: "deny";
1490
- 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";
1591
+ 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";
1491
1592
  reason: string;
1492
1593
  paidRequestId?: string | undefined;
1493
1594
  policyReviewEventId?: string | undefined;
@@ -1500,7 +1601,7 @@ export declare const sdkReceiptResponseSchema: z.ZodObject<{
1500
1601
  paymentAttemptId: z.ZodString;
1501
1602
  organizationId: z.ZodString;
1502
1603
  agentId: z.ZodString;
1503
- merchantId: z.ZodString;
1604
+ merchantId: z.ZodOptional<z.ZodString>;
1504
1605
  protocol: z.ZodEnum<["x402", "l402"]>;
1505
1606
  money: z.ZodEffects<z.ZodObject<{
1506
1607
  asset: z.ZodString;
@@ -1534,17 +1635,33 @@ export declare const sdkReceiptResponseSchema: z.ZodObject<{
1534
1635
  unit: "minor";
1535
1636
  }>;
1536
1637
  authorizationOutcome: z.ZodEnum<["allowed"]>;
1638
+ status: z.ZodEnum<["confirmed", "provisional", "expired_unconfirmed", "refunded", "void"]>;
1639
+ reconciliationStatus: z.ZodEnum<["none", "required", "in_progress", "resolved", "refunded"]>;
1640
+ confirmationSource: z.ZodOptional<z.ZodEnum<["chain_observer"]>>;
1641
+ attributionStrength: z.ZodOptional<z.ZodEnum<["strong_request_scoped", "constrained_unique"]>>;
1642
+ attributionBasis: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
1643
+ attributionRuleVersion: z.ZodOptional<z.ZodString>;
1644
+ confirmedAt: z.ZodOptional<z.ZodString>;
1645
+ finalityLevelUsed: z.ZodOptional<z.ZodEnum<["evm_block_confirmations_12"]>>;
1537
1646
  requestUrl: z.ZodString;
1538
1647
  requestMethod: z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]>;
1648
+ canonicalSettlementKey: z.ZodOptional<z.ZodString>;
1539
1649
  paymentReference: z.ZodOptional<z.ZodString>;
1540
1650
  evidenceSource: z.ZodOptional<z.ZodEnum<["merchant", "local_simulation"]>>;
1541
1651
  settlementEvidenceClass: z.ZodOptional<z.ZodEnum<["none", "inconclusive", "merchant_verifiable_success", "settled"]>>;
1542
1652
  settlementIdentifier: z.ZodOptional<z.ZodString>;
1653
+ supersededByReceiptId: z.ZodOptional<z.ZodString>;
1543
1654
  fulfillmentStatus: z.ZodOptional<z.ZodEnum<["succeeded", "failed", "inconclusive"]>>;
1544
1655
  createdAt: z.ZodString;
1545
1656
  completedAt: z.ZodOptional<z.ZodString>;
1546
1657
  }, "strip", z.ZodTypeAny, {
1658
+ status: "confirmed" | "provisional" | "expired_unconfirmed" | "refunded" | "void";
1547
1659
  protocol: "x402" | "l402";
1660
+ receiptId: string;
1661
+ paidRequestId: string;
1662
+ paymentAttemptId: string;
1663
+ organizationId: string;
1664
+ agentId: string;
1548
1665
  money: {
1549
1666
  asset: string;
1550
1667
  amount: string;
@@ -1552,24 +1669,34 @@ export declare const sdkReceiptResponseSchema: z.ZodObject<{
1552
1669
  precision: number;
1553
1670
  unit: "minor";
1554
1671
  };
1555
- receiptId: string;
1556
- paidRequestId: string;
1557
- paymentAttemptId: string;
1558
- organizationId: string;
1559
- agentId: string;
1560
- merchantId: string;
1561
1672
  authorizationOutcome: "allowed";
1673
+ reconciliationStatus: "none" | "refunded" | "required" | "in_progress" | "resolved";
1562
1674
  requestUrl: string;
1563
1675
  requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
1564
1676
  createdAt: string;
1677
+ merchantId?: string | undefined;
1678
+ confirmationSource?: "chain_observer" | undefined;
1679
+ attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
1680
+ attributionBasis?: Record<string, unknown> | undefined;
1681
+ attributionRuleVersion?: string | undefined;
1682
+ confirmedAt?: string | undefined;
1683
+ finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
1684
+ canonicalSettlementKey?: string | undefined;
1565
1685
  paymentReference?: string | undefined;
1566
1686
  evidenceSource?: "merchant" | "local_simulation" | undefined;
1567
1687
  settlementEvidenceClass?: "none" | "inconclusive" | "merchant_verifiable_success" | "settled" | undefined;
1568
1688
  settlementIdentifier?: string | undefined;
1689
+ supersededByReceiptId?: string | undefined;
1569
1690
  fulfillmentStatus?: "inconclusive" | "succeeded" | "failed" | undefined;
1570
1691
  completedAt?: string | undefined;
1571
1692
  }, {
1693
+ status: "confirmed" | "provisional" | "expired_unconfirmed" | "refunded" | "void";
1572
1694
  protocol: "x402" | "l402";
1695
+ receiptId: string;
1696
+ paidRequestId: string;
1697
+ paymentAttemptId: string;
1698
+ organizationId: string;
1699
+ agentId: string;
1573
1700
  money: {
1574
1701
  asset: string;
1575
1702
  amount: string;
@@ -1577,26 +1704,36 @@ export declare const sdkReceiptResponseSchema: z.ZodObject<{
1577
1704
  precision: number;
1578
1705
  unit: "minor";
1579
1706
  };
1580
- receiptId: string;
1581
- paidRequestId: string;
1582
- paymentAttemptId: string;
1583
- organizationId: string;
1584
- agentId: string;
1585
- merchantId: string;
1586
1707
  authorizationOutcome: "allowed";
1708
+ reconciliationStatus: "none" | "refunded" | "required" | "in_progress" | "resolved";
1587
1709
  requestUrl: string;
1588
1710
  requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
1589
1711
  createdAt: string;
1712
+ merchantId?: string | undefined;
1713
+ confirmationSource?: "chain_observer" | undefined;
1714
+ attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
1715
+ attributionBasis?: Record<string, unknown> | undefined;
1716
+ attributionRuleVersion?: string | undefined;
1717
+ confirmedAt?: string | undefined;
1718
+ finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
1719
+ canonicalSettlementKey?: string | undefined;
1590
1720
  paymentReference?: string | undefined;
1591
1721
  evidenceSource?: "merchant" | "local_simulation" | undefined;
1592
1722
  settlementEvidenceClass?: "none" | "inconclusive" | "merchant_verifiable_success" | "settled" | undefined;
1593
1723
  settlementIdentifier?: string | undefined;
1724
+ supersededByReceiptId?: string | undefined;
1594
1725
  fulfillmentStatus?: "inconclusive" | "succeeded" | "failed" | undefined;
1595
1726
  completedAt?: string | undefined;
1596
1727
  }>;
1597
1728
  }, "strip", z.ZodTypeAny, {
1598
1729
  receipt: {
1730
+ status: "confirmed" | "provisional" | "expired_unconfirmed" | "refunded" | "void";
1599
1731
  protocol: "x402" | "l402";
1732
+ receiptId: string;
1733
+ paidRequestId: string;
1734
+ paymentAttemptId: string;
1735
+ organizationId: string;
1736
+ agentId: string;
1600
1737
  money: {
1601
1738
  asset: string;
1602
1739
  amount: string;
@@ -1604,26 +1741,36 @@ export declare const sdkReceiptResponseSchema: z.ZodObject<{
1604
1741
  precision: number;
1605
1742
  unit: "minor";
1606
1743
  };
1607
- receiptId: string;
1608
- paidRequestId: string;
1609
- paymentAttemptId: string;
1610
- organizationId: string;
1611
- agentId: string;
1612
- merchantId: string;
1613
1744
  authorizationOutcome: "allowed";
1745
+ reconciliationStatus: "none" | "refunded" | "required" | "in_progress" | "resolved";
1614
1746
  requestUrl: string;
1615
1747
  requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
1616
1748
  createdAt: string;
1749
+ merchantId?: string | undefined;
1750
+ confirmationSource?: "chain_observer" | undefined;
1751
+ attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
1752
+ attributionBasis?: Record<string, unknown> | undefined;
1753
+ attributionRuleVersion?: string | undefined;
1754
+ confirmedAt?: string | undefined;
1755
+ finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
1756
+ canonicalSettlementKey?: string | undefined;
1617
1757
  paymentReference?: string | undefined;
1618
1758
  evidenceSource?: "merchant" | "local_simulation" | undefined;
1619
1759
  settlementEvidenceClass?: "none" | "inconclusive" | "merchant_verifiable_success" | "settled" | undefined;
1620
1760
  settlementIdentifier?: string | undefined;
1761
+ supersededByReceiptId?: string | undefined;
1621
1762
  fulfillmentStatus?: "inconclusive" | "succeeded" | "failed" | undefined;
1622
1763
  completedAt?: string | undefined;
1623
1764
  };
1624
1765
  }, {
1625
1766
  receipt: {
1767
+ status: "confirmed" | "provisional" | "expired_unconfirmed" | "refunded" | "void";
1626
1768
  protocol: "x402" | "l402";
1769
+ receiptId: string;
1770
+ paidRequestId: string;
1771
+ paymentAttemptId: string;
1772
+ organizationId: string;
1773
+ agentId: string;
1627
1774
  money: {
1628
1775
  asset: string;
1629
1776
  amount: string;
@@ -1631,20 +1778,24 @@ export declare const sdkReceiptResponseSchema: z.ZodObject<{
1631
1778
  precision: number;
1632
1779
  unit: "minor";
1633
1780
  };
1634
- receiptId: string;
1635
- paidRequestId: string;
1636
- paymentAttemptId: string;
1637
- organizationId: string;
1638
- agentId: string;
1639
- merchantId: string;
1640
1781
  authorizationOutcome: "allowed";
1782
+ reconciliationStatus: "none" | "refunded" | "required" | "in_progress" | "resolved";
1641
1783
  requestUrl: string;
1642
1784
  requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
1643
1785
  createdAt: string;
1786
+ merchantId?: string | undefined;
1787
+ confirmationSource?: "chain_observer" | undefined;
1788
+ attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
1789
+ attributionBasis?: Record<string, unknown> | undefined;
1790
+ attributionRuleVersion?: string | undefined;
1791
+ confirmedAt?: string | undefined;
1792
+ finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
1793
+ canonicalSettlementKey?: string | undefined;
1644
1794
  paymentReference?: string | undefined;
1645
1795
  evidenceSource?: "merchant" | "local_simulation" | undefined;
1646
1796
  settlementEvidenceClass?: "none" | "inconclusive" | "merchant_verifiable_success" | "settled" | undefined;
1647
1797
  settlementIdentifier?: string | undefined;
1798
+ supersededByReceiptId?: string | undefined;
1648
1799
  fulfillmentStatus?: "inconclusive" | "succeeded" | "failed" | undefined;
1649
1800
  completedAt?: string | undefined;
1650
1801
  };