@fun-xyz/fiat-contract 0.20.0 → 0.20.2

package/README.md

@@ -112,7 +112,7 @@ offers transitions, and a `terms` entry that is not a unique `CHECKOUT` document
 `{ provider, acceptances: [{ documentId, version, contentDigest, acceptedAt }] }`, each document at
 most once; `FiatTermsResponse` is `{ recorded }`, the recorded document ids. A fault is a
 `FiatTermsErrorBody`: the shared `errorCode`, `errorMsg` and `reqId`, plus `reason` (`STALE_TERMS`,
-`IN_PROGRESS`, `IDEMPOTENCY_KEY_REUSED`, `INVALID_REQUEST`, `RATE_LIMITED`) and `recovery`.
+`IN_PROGRESS`, `IDEMPOTENCY_KEY_REUSED`, `INVALID_REQUEST`, `RATE_LIMITED`, `PROVIDER_UNAVAILABLE`) and `recovery`.
 
 **MoonPay (`./moonpay`).** One route, `MOONPAY_ENDPOINTS.intent`. A `MoonPayIntentRequest` is one of
 three kinds:
@@ -120,24 +120,33 @@ three kinds:
 | `kind` | Carries | `Idempotency-Key` |
 | --- | --- | --- |
 | `observe` | `checkout`, and `credentials` (`customerId`, `accessToken`) once the SDK has them | ignored |
-| `kyc` | `checkout`, `credentials`, `values` keyed by field id (no form id) | required |
+| `kyc` | `checkout`, `credentials`, `values` keyed by `KycFieldId` (no form id) | required |
 | `order` | `orderId`, `transactionId` | required |
 
-A `MoonPayIntentResponse` says what the backend needs next:
+`observe` and `kyc` answer a `MoonPayStepResponse`, which says what the backend needs next:
 
 | `status` | Carries | The client then |
 | --- | --- | --- |
 | `TERMS` | `stage`, `documents` (at least one, all at `stage`) | sends `POST /fiat/terms`, then `observe` |
 | `SDK_AUTH` | `sessionToken`, `quoteInput` | runs the MoonPay connection check, then `observe` with credentials |
 | `KYC` | `fields`, `fieldErrors?` (each naming a field in `fields`) | shows the shared form, then sends `kyc` |
-| `PENDING` | `retryAfterMs` (at most 60 s) | sends the same request again after the delay |
+| `PENDING` | `retryAfterMs` (at most 60 s) | sends `observe` after the delay, never `kyc` again |
 | `READY` | `orderId`, `quoteInput` | mounts Apple Pay, then sends `order` after the charge |
-| `DONE` | `order`, the `GET /fiat/orders/:orderId` response | shows the shared order status |
 | `REFUSED` | `reason` (`NOT_ELIGIBLE`, `DOCUMENTS_REQUIRED`, `FINAL_REJECTION`, `CUSTOMER_MISMATCH`), `recovery: REQUOTE \| NONE` | exits the provider flow |
 
+`order` runs after the charge and answers a `MoonPayOrderResponse`:
+
+| `status` | Carries | The client then |
+| --- | --- | --- |
+| `DONE` | `order`, the `GET /fiat/orders/:orderId` response | shows the shared order status |
+| `PENDING` | `retryAfterMs` (at most 60 s) | sends the same `order`, with the same key, after the delay |
+| `REFUSED` | `reason` (`CUSTOMER_MISMATCH`, `WALLET_MISMATCH`, `UNRECORDABLE`), `recovery: NONE` | exits the provider flow |
+
+`MoonPayIntentResponseFor` maps each `kind` to its union, and `MoonPayIntentResponse` is both.
+
 A fault is a 4xx or 5xx with a `MoonPayErrorBody`: the shared `errorCode`, `errorMsg` and `reqId`,
 plus `reason` (`SESSION_BUDGET_SPENT`, `RATE_LIMITED`, `PROVIDER_UNAVAILABLE`, `IN_PROGRESS`,
-`IDEMPOTENCY_KEY_REUSED`, `INVALID_REQUEST`, `TRANSACTION_MISMATCH`, `WALLET_MISMATCH`) and `recovery`:
+`IDEMPOTENCY_KEY_REUSED`, `INVALID_REQUEST`) and `recovery`:
 `RETRY` (send the same request, with the same key), `REQUOTE`, or `NONE`. A field error is a `KYC`
 response, not a fault. The zod schemas (`MoonPay*Schema`, `TermsDocumentSchema`, `FiatTerms*Schema`)
 are exported from the root only.

package/dist/{chunk-TV6IWKTB.mjs → chunk-CYT2NARF.mjs}

@@ -1,5 +1,5 @@
 // package.json
-var version = "0.20.0";
+var version = "0.20.2";
 
 // src/table.ts
 var TABLE_VERSION = version;
@@ -514,4 +514,4 @@ export {
   tableEntry,
   isTerminal
 };
-//# sourceMappingURL=chunk-TV6IWKTB.mjs.map
+//# sourceMappingURL=chunk-CYT2NARF.mjs.map

package/dist/{chunk-QXJ54JWX.mjs → chunk-WRRCWAY2.mjs}

@@ -4,4 +4,4 @@ var FIAT_TERMS_ENDPOINT = "POST /fiat/terms";
 export {
   FIAT_TERMS_ENDPOINT
 };
-//# sourceMappingURL=chunk-QXJ54JWX.mjs.map
+//# sourceMappingURL=chunk-WRRCWAY2.mjs.map

package/dist/{chunk-UN3WTIMI.mjs → chunk-WW26WEZO.mjs}

@@ -6,4 +6,4 @@ var MOONPAY_ENDPOINTS = {
 export {
   MOONPAY_ENDPOINTS
 };
-//# sourceMappingURL=chunk-UN3WTIMI.mjs.map
+//# sourceMappingURL=chunk-WW26WEZO.mjs.map

package/dist/index.js

@@ -60,6 +60,7 @@ __export(index_exports, {
   KYCProviderSchema: () => KYCProviderSchema,
   KYC_ACKNOWLEDGEMENT_FIELD_IDS: () => KYC_ACKNOWLEDGEMENT_FIELD_IDS,
   KycCaptureStateSchema: () => KycCaptureStateSchema,
+  KycFieldIdSchema: () => KycFieldIdSchema,
   KycInputRequiredStateSchema: () => KycInputRequiredStateSchema,
   KycNoActionRequiredStateSchema: () => KycNoActionRequiredStateSchema,
   KycSdkResultReportSchema: () => KycSdkResultReportSchema,
@@ -69,8 +70,10 @@ __export(index_exports, {
   MoonPayFaultSchema: () => MoonPayFaultSchema,
   MoonPayIntentRequestSchema: () => MoonPayIntentRequestSchema,
   MoonPayIntentResponseSchema: () => MoonPayIntentResponseSchema,
+  MoonPayOrderResponseSchema: () => MoonPayOrderResponseSchema,
   MoonPayQuoteInputSchema: () => MoonPayQuoteInputSchema,
   MoonPaySdkCredentialsSchema: () => MoonPaySdkCredentialsSchema,
+  MoonPayStepResponseSchema: () => MoonPayStepResponseSchema,
   OrderAwaitingConfirmationStateSchema: () => OrderAwaitingConfirmationStateSchema,
   OrderCreatedStateSchema: () => OrderCreatedStateSchema,
   OrderRefSchema: () => OrderRefSchema,
@@ -658,6 +661,7 @@ var $kycFieldId = import_zod.z.union([
   import_zod.z.enum(KYC_ACKNOWLEDGEMENT_FIELD_IDS),
   $questionnaireKycFieldId
 ]);
+var KycFieldIdSchema = $kycFieldId;
 var $clientExecutedDelivery = obj({
   channel: import_zod.z.literal("CLIENT_EXECUTED"),
   source: import_zod.z.literal("CURRENT_SESSION_INPUTS"),
@@ -1001,7 +1005,7 @@ var $termsErrorBody = obj({
   errorCode: $nonBlank,
   errorMsg: import_zod.z.string(),
   reqId: import_zod.z.string().optional(),
-  reason: import_zod.z.enum(["STALE_TERMS", "IN_PROGRESS", "IDEMPOTENCY_KEY_REUSED", "INVALID_REQUEST", "RATE_LIMITED"]),
+  reason: import_zod.z.enum(["STALE_TERMS", "IN_PROGRESS", "IDEMPOTENCY_KEY_REUSED", "INVALID_REQUEST", "RATE_LIMITED", "PROVIDER_UNAVAILABLE"]),
   recovery: import_zod.z.enum(["RETRY", "REQUOTE", "NONE"])
 });
 var FiatTermsErrorBodySchema = $termsErrorBody;
@@ -1064,7 +1068,7 @@ var $stepResponse = import_zod.z.union([$providerBoundStepResponse, $blockedStep
 var FiatStepResponseSchema = $stepResponse;
 
 // package.json
-var version = "0.20.0";
+var version = "0.20.2";
 
 // src/table.ts
 var TABLE_VERSION = version;
@@ -2659,7 +2663,7 @@ var $intentRequest = import_zod2.z.discriminatedUnion("kind", [
     kind: import_zod2.z.literal("kyc"),
     checkout: $checkout,
     credentials: $credentials,
-    values: import_zod2.z.record(import_zod2.z.string(), import_zod2.z.string()).refine((values) => Object.keys(values).length > 0, "values must not be empty")
+    values: import_zod2.z.record(KycFieldIdSchema, import_zod2.z.string()).refine((values) => Object.keys(values).length > 0, "values must not be empty")
   }),
   obj2({ kind: import_zod2.z.literal("order"), orderId: $nonEmpty, transactionId: $nonEmpty })
 ]);
@@ -2672,18 +2676,19 @@ var $quoteInput = obj2({
   feeBehavior: import_zod2.z.literal("inclusive")
 });
 var MoonPayQuoteInputSchema = $quoteInput;
-var $refusal = import_zod2.z.enum(["NOT_ELIGIBLE", "DOCUMENTS_REQUIRED", "FINAL_REJECTION", "CUSTOMER_MISMATCH"]);
+var $stepRefusal = import_zod2.z.enum(["NOT_ELIGIBLE", "DOCUMENTS_REQUIRED", "FINAL_REJECTION", "CUSTOMER_MISMATCH"]);
+var $orderRefusal = import_zod2.z.enum(["CUSTOMER_MISMATCH", "WALLET_MISMATCH", "UNRECORDABLE"]);
 var $fieldError = obj2({ fieldId: $nonEmpty, message: $nonEmpty });
-var $intentStatus = import_zod2.z.discriminatedUnion("status", [
+var $pending = obj2({ status: import_zod2.z.literal("PENDING"), retryAfterMs: import_zod2.z.number().int().positive().max(6e4) });
+var $stepStatus = import_zod2.z.discriminatedUnion("status", [
   obj2({ status: import_zod2.z.literal("TERMS"), stage: import_zod2.z.enum(["CHECKOUT", "KYC"]), documents: import_zod2.z.array(TermsDocumentSchema).min(1) }),
   obj2({ status: import_zod2.z.literal("SDK_AUTH"), sessionToken: $nonEmpty, quoteInput: $quoteInput }),
   obj2({ status: import_zod2.z.literal("KYC"), fields: import_zod2.z.array(FormFieldSchema).min(1), fieldErrors: import_zod2.z.array($fieldError).min(1).optional() }),
-  obj2({ status: import_zod2.z.literal("PENDING"), retryAfterMs: import_zod2.z.number().int().positive().max(6e4) }),
+  $pending,
   obj2({ status: import_zod2.z.literal("READY"), orderId: $nonEmpty, quoteInput: $quoteInput }),
-  obj2({ status: import_zod2.z.literal("DONE"), order: FiatStepResponseSchema }),
-  obj2({ status: import_zod2.z.literal("REFUSED"), reason: $refusal, recovery: import_zod2.z.enum(["REQUOTE", "NONE"]) })
+  obj2({ status: import_zod2.z.literal("REFUSED"), reason: $stepRefusal, recovery: import_zod2.z.enum(["REQUOTE", "NONE"]) })
 ]);
-var $intentResponse = $intentStatus.superRefine((response, context) => {
+var $stepResponse2 = $stepStatus.superRefine((response, context) => {
   if (response.status === "TERMS") {
     if (!hasUniqueIds2(response.documents.map((document) => document.id))) {
       context.addIssue({ code: "custom", path: ["documents"], message: "document ids must be unique" });
@@ -2702,6 +2707,14 @@ var $intentResponse = $intentStatus.superRefine((response, context) => {
     }
   }
 });
+var MoonPayStepResponseSchema = $stepResponse2;
+var $orderResponse = import_zod2.z.discriminatedUnion("status", [
+  obj2({ status: import_zod2.z.literal("DONE"), order: FiatStepResponseSchema }),
+  $pending,
+  obj2({ status: import_zod2.z.literal("REFUSED"), reason: $orderRefusal, recovery: import_zod2.z.literal("NONE") })
+]);
+var MoonPayOrderResponseSchema = $orderResponse;
+var $intentResponse = import_zod2.z.union([$stepResponse2, $orderResponse]);
 var MoonPayIntentResponseSchema = $intentResponse;
 var $faultFields = {
   reason: import_zod2.z.enum([
@@ -2710,9 +2723,7 @@ var $faultFields = {
     "PROVIDER_UNAVAILABLE",
     "IN_PROGRESS",
     "IDEMPOTENCY_KEY_REUSED",
-    "INVALID_REQUEST",
-    "TRANSACTION_MISMATCH",
-    "WALLET_MISMATCH"
+    "INVALID_REQUEST"
   ]),
   recovery: import_zod2.z.enum(["RETRY", "REQUOTE", "NONE"])
 };

package/dist/index.mjs

@@ -12,13 +12,13 @@ import {
   tableEntry,
   unofferedEndpoints,
   unreachableStates
-} from "./chunk-TV6IWKTB.mjs";
+} from "./chunk-CYT2NARF.mjs";
 import {
   MOONPAY_ENDPOINTS
-} from "./chunk-UN3WTIMI.mjs";
+} from "./chunk-WW26WEZO.mjs";
 import {
   FIAT_TERMS_ENDPOINT
-} from "./chunk-QXJ54JWX.mjs";
+} from "./chunk-WRRCWAY2.mjs";
 
 // src/codes.ts
 var US_STATE_CODES = [
@@ -545,6 +545,7 @@ var $kycFieldId = z.union([
   z.enum(KYC_ACKNOWLEDGEMENT_FIELD_IDS),
   $questionnaireKycFieldId
 ]);
+var KycFieldIdSchema = $kycFieldId;
 var $clientExecutedDelivery = obj({
   channel: z.literal("CLIENT_EXECUTED"),
   source: z.literal("CURRENT_SESSION_INPUTS"),
@@ -888,7 +889,7 @@ var $termsErrorBody = obj({
   errorCode: $nonBlank,
   errorMsg: z.string(),
   reqId: z.string().optional(),
-  reason: z.enum(["STALE_TERMS", "IN_PROGRESS", "IDEMPOTENCY_KEY_REUSED", "INVALID_REQUEST", "RATE_LIMITED"]),
+  reason: z.enum(["STALE_TERMS", "IN_PROGRESS", "IDEMPOTENCY_KEY_REUSED", "INVALID_REQUEST", "RATE_LIMITED", "PROVIDER_UNAVAILABLE"]),
   recovery: z.enum(["RETRY", "REQUOTE", "NONE"])
 });
 var FiatTermsErrorBodySchema = $termsErrorBody;
@@ -2036,7 +2037,7 @@ var $intentRequest = z2.discriminatedUnion("kind", [
     kind: z2.literal("kyc"),
     checkout: $checkout,
     credentials: $credentials,
-    values: z2.record(z2.string(), z2.string()).refine((values) => Object.keys(values).length > 0, "values must not be empty")
+    values: z2.record(KycFieldIdSchema, z2.string()).refine((values) => Object.keys(values).length > 0, "values must not be empty")
   }),
   obj2({ kind: z2.literal("order"), orderId: $nonEmpty, transactionId: $nonEmpty })
 ]);
@@ -2049,18 +2050,19 @@ var $quoteInput = obj2({
   feeBehavior: z2.literal("inclusive")
 });
 var MoonPayQuoteInputSchema = $quoteInput;
-var $refusal = z2.enum(["NOT_ELIGIBLE", "DOCUMENTS_REQUIRED", "FINAL_REJECTION", "CUSTOMER_MISMATCH"]);
+var $stepRefusal = z2.enum(["NOT_ELIGIBLE", "DOCUMENTS_REQUIRED", "FINAL_REJECTION", "CUSTOMER_MISMATCH"]);
+var $orderRefusal = z2.enum(["CUSTOMER_MISMATCH", "WALLET_MISMATCH", "UNRECORDABLE"]);
 var $fieldError = obj2({ fieldId: $nonEmpty, message: $nonEmpty });
-var $intentStatus = z2.discriminatedUnion("status", [
+var $pending = obj2({ status: z2.literal("PENDING"), retryAfterMs: z2.number().int().positive().max(6e4) });
+var $stepStatus = z2.discriminatedUnion("status", [
   obj2({ status: z2.literal("TERMS"), stage: z2.enum(["CHECKOUT", "KYC"]), documents: z2.array(TermsDocumentSchema).min(1) }),
   obj2({ status: z2.literal("SDK_AUTH"), sessionToken: $nonEmpty, quoteInput: $quoteInput }),
   obj2({ status: z2.literal("KYC"), fields: z2.array(FormFieldSchema).min(1), fieldErrors: z2.array($fieldError).min(1).optional() }),
-  obj2({ status: z2.literal("PENDING"), retryAfterMs: z2.number().int().positive().max(6e4) }),
+  $pending,
   obj2({ status: z2.literal("READY"), orderId: $nonEmpty, quoteInput: $quoteInput }),
-  obj2({ status: z2.literal("DONE"), order: FiatStepResponseSchema }),
-  obj2({ status: z2.literal("REFUSED"), reason: $refusal, recovery: z2.enum(["REQUOTE", "NONE"]) })
+  obj2({ status: z2.literal("REFUSED"), reason: $stepRefusal, recovery: z2.enum(["REQUOTE", "NONE"]) })
 ]);
-var $intentResponse = $intentStatus.superRefine((response, context) => {
+var $stepResponse2 = $stepStatus.superRefine((response, context) => {
   if (response.status === "TERMS") {
     if (!hasUniqueIds2(response.documents.map((document) => document.id))) {
       context.addIssue({ code: "custom", path: ["documents"], message: "document ids must be unique" });
@@ -2079,6 +2081,14 @@ var $intentResponse = $intentStatus.superRefine((response, context) => {
     }
   }
 });
+var MoonPayStepResponseSchema = $stepResponse2;
+var $orderResponse = z2.discriminatedUnion("status", [
+  obj2({ status: z2.literal("DONE"), order: FiatStepResponseSchema }),
+  $pending,
+  obj2({ status: z2.literal("REFUSED"), reason: $orderRefusal, recovery: z2.literal("NONE") })
+]);
+var MoonPayOrderResponseSchema = $orderResponse;
+var $intentResponse = z2.union([$stepResponse2, $orderResponse]);
 var MoonPayIntentResponseSchema = $intentResponse;
 var $faultFields = {
   reason: z2.enum([
@@ -2087,9 +2097,7 @@ var $faultFields = {
     "PROVIDER_UNAVAILABLE",
     "IN_PROGRESS",
     "IDEMPOTENCY_KEY_REUSED",
-    "INVALID_REQUEST",
-    "TRANSACTION_MISMATCH",
-    "WALLET_MISMATCH"
+    "INVALID_REQUEST"
   ]),
   recovery: z2.enum(["RETRY", "REQUOTE", "NONE"])
 };
@@ -2138,6 +2146,7 @@ export {
   KYCProviderSchema,
   KYC_ACKNOWLEDGEMENT_FIELD_IDS,
   KycCaptureStateSchema,
+  KycFieldIdSchema,
   KycInputRequiredStateSchema,
   KycNoActionRequiredStateSchema,
   KycSdkResultReportSchema,
@@ -2147,8 +2156,10 @@ export {
   MoonPayFaultSchema,
   MoonPayIntentRequestSchema,
   MoonPayIntentResponseSchema,
+  MoonPayOrderResponseSchema,
   MoonPayQuoteInputSchema,
   MoonPaySdkCredentialsSchema,
+  MoonPayStepResponseSchema,
   OrderAwaitingConfirmationStateSchema,
   OrderCreatedStateSchema,
   OrderRefSchema,

package/dist/providers/moonpay.d.ts

@@ -2,7 +2,8 @@
  * The MoonPay provider-owned flow: one route, `POST /fiat/providers/moonpay/intent`.
  *
  * Each request carries evidence or a user action (`kind`), and each response says what the backend
- * needs next (`status`). The client repeats until `DONE` or `REFUSED`. Terms and consents go through
+ * needs next (`status`). `observe` and `kyc` answer a `MoonPayStepResponse`, and `order` answers a
+ * `MoonPayOrderResponse` (`MoonPayIntentResponseFor`). Terms and consents go through
  * the platform `POST /fiat/terms` (`./terms`). Identity and the deposit wallet always come from the
  * verified partner assertion, never from a request body.
  *
@@ -17,7 +18,7 @@
  */
 import type { FiatCurrencyCode } from '../codes';
 import type { TermsDocument, TermsStage } from '../terms';
-import type { FiatAmount, FiatStepResponse, FormField } from '../types';
+import type { FiatAmount, FiatStepResponse, FormField, KycFieldId } from '../types';
 export declare const MOONPAY_ENDPOINTS: {
     readonly intent: "POST /fiat/providers/moonpay/intent";
 };
@@ -49,12 +50,12 @@ export type MoonPayIntentRequest =
     checkout: MoonPayCheckout;
     credentials?: MoonPaySdkCredentials;
 }
-/** Only after a `KYC` response. `values` is keyed by field id; there is no form id. */
+/** Only after a `KYC` response. `values` is keyed by the ids of that response's fields; there is no form id. */
  | {
     kind: 'kyc';
     checkout: MoonPayCheckout;
     credentials: MoonPaySdkCredentials;
-    values: Record<string, string>;
+    values: Partial<Record<KycFieldId, string>>;
 }
 /** After the Apple Pay sheet. `transactionId` is from the Apple Pay completion event. */
  | {
@@ -87,13 +88,21 @@ export interface MoonPayQuoteInput {
     };
     feeBehavior: 'inclusive';
 }
-export type MoonPayRefusal = 'NOT_ELIGIBLE' | 'DOCUMENTS_REQUIRED' | 'FINAL_REJECTION' | 'CUSTOMER_MISMATCH';
+/** `REQUOTE` for `NOT_ELIGIBLE` and `DOCUMENTS_REQUIRED`, `NONE` for the others. */
+export type MoonPayStepRefusal = 'NOT_ELIGIBLE' | 'DOCUMENTS_REQUIRED' | 'FINAL_REJECTION' | 'CUSTOMER_MISMATCH';
+/**
+ * After a charge, always with `recovery: NONE`. `CUSTOMER_MISMATCH`: the transaction's customer is
+ * not bound to this buyer. `WALLET_MISMATCH`: the transaction pays another wallet than the
+ * assertion's. `UNRECORDABLE`: a charge no retry can record, held for refund review.
+ */
+export type MoonPayOrderRefusal = 'CUSTOMER_MISMATCH' | 'WALLET_MISMATCH' | 'UNRECORDABLE';
 /** A reason on one field of a `KYC` response. `fieldId` names a field in that response. */
 export interface MoonPayFieldError {
     fieldId: string;
     message: string;
 }
-export type MoonPayIntentResponse = 
+/** The answer to `observe` and `kyc`. */
+export type MoonPayStepResponse = 
 /** Show `documents` (every one at `stage`), send `POST /fiat/terms`, then `observe`. */
 {
     status: 'TERMS';
@@ -112,7 +121,7 @@ export type MoonPayIntentResponse =
     fields: FormField[];
     fieldErrors?: MoonPayFieldError[];
 }
-/** Send the same request again after the delay. */
+/** Send `observe` after the delay. Never `kyc` again: its write is done. */
  | {
     status: 'PENDING';
     retryAfterMs: number;
@@ -123,29 +132,46 @@ export type MoonPayIntentResponse =
     orderId: string;
     quoteInput: MoonPayQuoteInput;
 }
-/** The `GET /fiat/orders/:orderId` response; the shared order screen renders it. */
+/** Exit the provider flow. `REQUOTE` goes back to `POST /fiat/quote`; `NONE` ends the flow. */
  | {
+    status: 'REFUSED';
+    reason: MoonPayStepRefusal;
+    recovery: 'REQUOTE' | 'NONE';
+};
+/** The answer to `order`, which runs after the charge. */
+export type MoonPayOrderResponse = 
+/** The `GET /fiat/orders/:orderId` response; the shared order screen renders it. */
+{
     status: 'DONE';
     order: FiatStepResponse;
 }
-/** Exit the provider flow. `REQUOTE` goes back to `POST /fiat/quote`; `NONE` ends the flow. */
+/** MoonPay does not show the transaction yet. Send the same `order`, with the same key, after the delay. */
+ | {
+    status: 'PENDING';
+    retryAfterMs: number;
+}
+/** Exit the provider flow. A requote after a charge would start a second payment. */
  | {
     status: 'REFUSED';
-    reason: MoonPayRefusal;
-    recovery: 'REQUOTE' | 'NONE';
+    reason: MoonPayOrderRefusal;
+    recovery: 'NONE';
+};
+export type MoonPayIntentResponseFor = {
+    observe: MoonPayStepResponse;
+    kyc: MoonPayStepResponse;
+    order: MoonPayOrderResponse;
 };
+export type MoonPayIntentResponse = MoonPayStepResponse | MoonPayOrderResponse;
 export type MoonPayIntentStatus = MoonPayIntentResponse['status'];
 /** `RETRY` sends the same request again, with the same key. `REQUOTE` goes back to `POST /fiat/quote`. `NONE` ends the flow. */
 export type MoonPayRecovery = 'RETRY' | 'REQUOTE' | 'NONE';
 /**
  * `SESSION_BUDGET_SPENT`: the per-login SDK session mint budget (429). `RATE_LIMITED`: the kind's
- * request budget (429). `PROVIDER_UNAVAILABLE`: MoonPay or Sumsub is down, or a charge cannot be
- * recorded. `IN_PROGRESS`: the same key is still running (409). `IDEMPOTENCY_KEY_REUSED`: the same
- * key with a different body (422). `INVALID_REQUEST`: a bad body or a missing key (400).
- * `TRANSACTION_MISMATCH`: the transaction is not this buyer's (400). `WALLET_MISMATCH`: the
- * transaction pays another wallet.
+ * request budget (429). `PROVIDER_UNAVAILABLE`: MoonPay or Sumsub is down. `IN_PROGRESS`: the same
+ * key is still running (409). `IDEMPOTENCY_KEY_REUSED`: the same key with a different body (422).
+ * `INVALID_REQUEST`: a bad body or a missing key (400).
  */
-export type MoonPayFaultReason = 'SESSION_BUDGET_SPENT' | 'RATE_LIMITED' | 'PROVIDER_UNAVAILABLE' | 'IN_PROGRESS' | 'IDEMPOTENCY_KEY_REUSED' | 'INVALID_REQUEST' | 'TRANSACTION_MISMATCH' | 'WALLET_MISMATCH';
+export type MoonPayFaultReason = 'SESSION_BUDGET_SPENT' | 'RATE_LIMITED' | 'PROVIDER_UNAVAILABLE' | 'IN_PROGRESS' | 'IDEMPOTENCY_KEY_REUSED' | 'INVALID_REQUEST';
 /** The fields a MoonPay fault adds to the shared error body. */
 export interface MoonPayFault {
     reason: MoonPayFaultReason;

package/dist/providers/moonpay.mjs

@@ -1,6 +1,6 @@
 import {
   MOONPAY_ENDPOINTS
-} from "../chunk-UN3WTIMI.mjs";
+} from "../chunk-WW26WEZO.mjs";
 export {
   MOONPAY_ENDPOINTS
 };

package/dist/providers/moonpay.schemas.d.ts

@@ -3,11 +3,13 @@
  * the package root, never from `./moonpay`, so the production entry stays free of zod.
  */
 import { z } from 'zod';
-import type { MoonPayCheckout, MoonPayErrorBody, MoonPayFault, MoonPayIntentRequest, MoonPayIntentResponse, MoonPayQuoteInput, MoonPaySdkCredentials } from './moonpay';
+import type { MoonPayCheckout, MoonPayErrorBody, MoonPayFault, MoonPayIntentRequest, MoonPayIntentResponse, MoonPayOrderResponse, MoonPayQuoteInput, MoonPaySdkCredentials, MoonPayStepResponse } from './moonpay';
 export declare const MoonPayCheckoutSchema: z.ZodType<MoonPayCheckout>;
 export declare const MoonPaySdkCredentialsSchema: z.ZodType<MoonPaySdkCredentials>;
 export declare const MoonPayIntentRequestSchema: z.ZodType<MoonPayIntentRequest>;
 export declare const MoonPayQuoteInputSchema: z.ZodType<MoonPayQuoteInput>;
+export declare const MoonPayStepResponseSchema: z.ZodType<MoonPayStepResponse>;
+export declare const MoonPayOrderResponseSchema: z.ZodType<MoonPayOrderResponse>;
 export declare const MoonPayIntentResponseSchema: z.ZodType<MoonPayIntentResponse>;
 export declare const MoonPayFaultSchema: z.ZodType<MoonPayFault>;
 export declare const MoonPayErrorBodySchema: z.ZodType<MoonPayErrorBody>;

package/dist/schemas.d.ts

@@ -28,7 +28,7 @@
  */
 import { z } from 'zod';
 import type { UsStateCode } from './codes';
-import type { BlockedReason, CryptoAmount, FailureReason, FeeLine, FiatAmount, FiatEndpoint, FiatProvider, FiatStepResponse, FieldSpec, FlowState, FormDescriptor, FormField, FormFieldType, InstructionField, Instructions, Instrument, JsonValue, KYCProvider, OrderRef, OrderStatus, OrderSummary, PollSpec, PreparedPayment, PaymentSurface, Quote, QuoteLimitRange, QuoteLimits, Recovery, Refund, ReportSpec, SelectOption, StatusHistoryEntry, Surface, PreferredIdentityDocument, ClientExecutedDelivery, KycSdkResultReport, SurfaceKind, SurfaceProvider, TermsAcceptance, Transition, TransitionInputs, TransitionParams, Tx } from './types';
+import type { BlockedReason, CryptoAmount, FailureReason, FeeLine, FiatAmount, FiatEndpoint, FiatProvider, FiatStepResponse, FieldSpec, FlowState, FormDescriptor, FormField, FormFieldType, InstructionField, Instructions, Instrument, JsonValue, KYCProvider, OrderRef, OrderStatus, OrderSummary, PollSpec, PreparedPayment, PaymentSurface, Quote, QuoteLimitRange, QuoteLimits, Recovery, Refund, ReportSpec, SelectOption, StatusHistoryEntry, Surface, PreferredIdentityDocument, KycFieldId, ClientExecutedDelivery, KycSdkResultReport, SurfaceKind, SurfaceProvider, TermsAcceptance, Transition, TransitionInputs, TransitionParams, Tx } from './types';
 import type { FiatTermsErrorBody, FiatTermsRequest, FiatTermsResponse, TermsDocument, TermsDocumentAcceptance } from './terms';
 export declare const JsonSchema: z.ZodType<JsonValue>;
 export declare const HTTP_VERBS: readonly ["GET", "POST"];
@@ -58,6 +58,7 @@ export declare const SurfaceKindSchema: z.ZodType<SurfaceKind>;
 export declare const PreferredIdentityDocumentSchema: z.ZodType<PreferredIdentityDocument>;
 export declare const STANDARD_KYC_FIELD_IDS: readonly ["LEGAL_FIRST_NAME", "LEGAL_MIDDLE_NAME", "LEGAL_LAST_NAME", "DATE_OF_BIRTH", "COUNTRY_OF_BIRTH", "CITY_OF_BIRTH", "NATIONALITY", "EMAIL_ADDRESS", "EMAIL_OWNERSHIP_VERIFICATION", "PHONE_NUMBER", "PHONE_OWNERSHIP_VERIFICATION", "RESIDENTIAL_ADDRESS_LINE_1", "RESIDENTIAL_ADDRESS_LINE_2", "RESIDENTIAL_ADDRESS_CITY", "RESIDENTIAL_ADDRESS_REGION", "RESIDENTIAL_ADDRESS_POSTAL_CODE", "RESIDENTIAL_ADDRESS_COUNTRY", "TAX_IDENTIFIER", "US_SSN_LAST_FOUR", "TAX_RESIDENCE_COUNTRY", "EMPLOYMENT_STATUS", "OCCUPATION_INDUSTRY", "OCCUPATION_TITLE", "SOURCE_OF_FUNDS_DECLARATION", "SOURCE_OF_INCOME_DECLARATION", "SOURCE_OF_WEALTH_DECLARATION", "PURPOSE_OF_SERVICE", "PURPOSE_OF_TRANSACTION", "CUSTOMER_CATEGORY"];
 export declare const KYC_ACKNOWLEDGEMENT_FIELD_IDS: readonly ["RISK_ACKNOWLEDGEMENT", "COOLING_OFF_ACKNOWLEDGEMENT", "TERMS_ACCEPTANCE"];
+export declare const KycFieldIdSchema: z.ZodType<KycFieldId>;
 export declare const ClientExecutedDeliverySchema: z.ZodType<ClientExecutedDelivery>;
 export declare const SurfaceSchema: z.ZodType<Surface>;
 export declare const PaymentSurfaceSchema: z.ZodType<PaymentSurface>;

package/dist/table.js

@@ -36,7 +36,7 @@ __export(table_exports, {
 module.exports = __toCommonJS(table_exports);
 
 // package.json
-var version = "0.20.0";
+var version = "0.20.2";
 
 // src/table.ts
 var TABLE_VERSION = version;

package/dist/table.mjs

@@ -11,7 +11,7 @@ import {
   tableEntry,
   unofferedEndpoints,
   unreachableStates
-} from "./chunk-TV6IWKTB.mjs";
+} from "./chunk-CYT2NARF.mjs";
 export {
   DOCUMENTED_ENDPOINTS,
   STATE_KEYS,

package/dist/terms.d.ts

@@ -49,8 +49,9 @@ export interface FiatTermsResponse {
  * fetches the documents again. `IN_PROGRESS`: the same key is still running (409).
  * `IDEMPOTENCY_KEY_REUSED`: the same key with a different body (422). `INVALID_REQUEST`: a bad body
  * or a missing key (400). `RATE_LIMITED`: the per-login terms budget is spent (429).
+ * `PROVIDER_UNAVAILABLE`: the KYC service or a store is down (503); nothing is recorded, so retry.
  */
-export type FiatTermsFaultReason = 'STALE_TERMS' | 'IN_PROGRESS' | 'IDEMPOTENCY_KEY_REUSED' | 'INVALID_REQUEST' | 'RATE_LIMITED';
+export type FiatTermsFaultReason = 'STALE_TERMS' | 'IN_PROGRESS' | 'IDEMPOTENCY_KEY_REUSED' | 'INVALID_REQUEST' | 'RATE_LIMITED' | 'PROVIDER_UNAVAILABLE';
 /** `RETRY` sends the same request, with the same key. `REQUOTE` goes back to `POST /fiat/quote`. `NONE` ends the flow. */
 export type FiatTermsRecovery = 'RETRY' | 'REQUOTE' | 'NONE';
 /** The 4xx/5xx body of `POST /fiat/terms`: the shared error body plus `reason` and `recovery`. */

package/dist/terms.mjs

@@ -1,6 +1,6 @@
 import {
   FIAT_TERMS_ENDPOINT
-} from "./chunk-QXJ54JWX.mjs";
+} from "./chunk-WRRCWAY2.mjs";
 export {
   FIAT_TERMS_ENDPOINT
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fun-xyz/fiat-contract",
-  "version": "0.20.0",
+  "version": "0.20.2",
   "description": "Published conformance contract for Fun's headless fiat onramp: FlowState/Transition types, zod schemas, the transition table as data, recorded fixtures, assertion helpers.",
   "license": "MIT",
   "repository": {