@fun-xyz/fiat-contract 0.31.0 → 0.34.0

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.
@@ -1,6 +1,17 @@
1
1
  // src/terms.ts
2
2
  var FIAT_TERMS_ENDPOINT = "POST /fiat/terms";
3
3
  var MOONPAY_TERMS = {
4
+ id: "MOONPAY_TERMS",
5
+ kind: "PROVIDER_TERMS",
6
+ stage: "CHECKOUT",
7
+ version: "moonpay-terms-2026-09",
8
+ contentDigest: "aab09ddd95a6fdd3f7c483e22833375a03c031d7379a3f60e09aa46ab4856d07",
9
+ links: [
10
+ { label: "MoonPay Terms of Use", url: "https://www.moonpay.com/legal/terms" },
11
+ { label: "MoonPay Privacy Policy", url: "https://www.moonpay.com/legal/privacy_policy" }
12
+ ]
13
+ };
14
+ var MOONPAY_TERMS_KYC_SHARING_V2 = {
4
15
  id: "MOONPAY_TERMS",
5
16
  kind: "PROVIDER_TERMS",
6
17
  stage: "CHECKOUT",
@@ -12,9 +23,20 @@ var MOONPAY_TERMS = {
12
23
  { label: "Persona Privacy Policy", url: "https://withpersona.com/legal/privacy-policy" }
13
24
  ]
14
25
  };
26
+ var MOONPAY_KYC_SHARING = {
27
+ id: "MOONPAY_KYC_SHARING",
28
+ kind: "PROVIDER_KYC_SHARING",
29
+ stage: "KYC",
30
+ version: "2026-09-l2-kyc-sharing-v3",
31
+ contentDigest: "fe587d7c6542a12070444ddb2e6ff0f2f6062b00ffc512cdb5c60438d355088e",
32
+ links: [{ label: "Persona Privacy Policy", url: "https://withpersona.com/legal/privacy-policy" }]
33
+ };
15
34
  var PROVIDER_CHECKOUT_DOCUMENTS = {
16
35
  MOONPAY: [MOONPAY_TERMS]
17
36
  };
37
+ var PROVIDER_KYC_DOCUMENTS = {
38
+ MOONPAY: [MOONPAY_KYC_SHARING]
39
+ };
18
40
  var funKycConsent = (contentDigest) => ({
19
41
  id: "FUN_KYC_CONSENT",
20
42
  kind: "FUN_KYC_COLLECTION",
@@ -33,11 +55,17 @@ var FUN_KYC_CONSENT_DOCUMENTS = {
33
55
  tr: funKycConsent("463040c3b58c922ecae2ae8262a78eb732bbcc5606c394723626378b3db2bbc3"),
34
56
  zh: funKycConsent("7f76d850adaf69783c5d9365e51abb5446f4e5778c63eabbdb4784d72464f855")
35
57
  };
36
- var PUBLISHED_TERMS_DOCUMENTS = [MOONPAY_TERMS, ...Object.values(FUN_KYC_CONSENT_DOCUMENTS)];
58
+ var PUBLISHED_TERMS_DOCUMENTS = [
59
+ MOONPAY_TERMS_KYC_SHARING_V2,
60
+ MOONPAY_TERMS,
61
+ MOONPAY_KYC_SHARING,
62
+ ...Object.values(FUN_KYC_CONSENT_DOCUMENTS)
63
+ ];
37
64
 
38
65
  export {
39
66
  FIAT_TERMS_ENDPOINT,
40
67
  PROVIDER_CHECKOUT_DOCUMENTS,
68
+ PROVIDER_KYC_DOCUMENTS,
41
69
  FUN_KYC_CONSENT_DOCUMENTS,
42
70
  PUBLISHED_TERMS_DOCUMENTS
43
71
  };
@@ -1,5 +1,5 @@
1
1
  // package.json
2
- var version = "0.31.0";
2
+ var version = "0.34.0";
3
3
 
4
4
  // src/table.ts
5
5
  var TABLE_VERSION = version;
package/dist/index.js CHANGED
@@ -49,7 +49,6 @@ __export(index_exports, {
49
49
  FiatRoutingQuoteRequestSchema: () => FiatRoutingQuoteRequestSchema,
50
50
  FiatRoutingQuoteTermsSchema: () => FiatRoutingQuoteTermsSchema,
51
51
  FiatRoutingTableErrorBodySchema: () => FiatRoutingTableErrorBodySchema,
52
- FiatRoutingTableQuerySchema: () => FiatRoutingTableQuerySchema,
53
52
  FiatRoutingTableRequestSchema: () => FiatRoutingTableRequestSchema,
54
53
  FiatRoutingTableResponseSchema: () => FiatRoutingTableResponseSchema,
55
54
  FiatStepResponseSchema: () => FiatStepResponseSchema,
@@ -76,6 +75,9 @@ __export(index_exports, {
76
75
  KycReviewDurationSchema: () => KycReviewDurationSchema,
77
76
  KycSdkResultReportSchema: () => KycSdkResultReportSchema,
78
77
  MOONPAY_ENDPOINTS: () => MOONPAY_ENDPOINTS,
78
+ MoonPayCaptureDocumentSchema: () => MoonPayCaptureDocumentSchema,
79
+ MoonPayCaptureNextActionSchema: () => MoonPayCaptureNextActionSchema,
80
+ MoonPayCaptureRequestSchema: () => MoonPayCaptureRequestSchema,
79
81
  MoonPayCheckoutSchema: () => MoonPayCheckoutSchema,
80
82
  MoonPayConnectNextActionSchema: () => MoonPayConnectNextActionSchema,
81
83
  MoonPayConnectRequestSchema: () => MoonPayConnectRequestSchema,
@@ -90,13 +92,21 @@ __export(index_exports, {
90
92
  MoonPayNextRequestSchema: () => MoonPayNextRequestSchema,
91
93
  MoonPayObserveRequestSchema: () => MoonPayObserveRequestSchema,
92
94
  MoonPayOrderNextActionSchema: () => MoonPayOrderNextActionSchema,
95
+ MoonPayOrderPendingNextActionSchema: () => MoonPayOrderPendingNextActionSchema,
93
96
  MoonPayOrderRequestSchema: () => MoonPayOrderRequestSchema,
94
97
  MoonPayOrderResponseSchema: () => MoonPayOrderResponseSchema,
98
+ MoonPayPrepareCaptureNextActionSchema: () => MoonPayPrepareCaptureNextActionSchema,
99
+ MoonPayPrepareCaptureRequestSchema: () => MoonPayPrepareCaptureRequestSchema,
95
100
  MoonPayQuoteInputSchema: () => MoonPayQuoteInputSchema,
101
+ MoonPayReaskReasonSchema: () => MoonPayReaskReasonSchema,
102
+ MoonPayReaskRequirementSchema: () => MoonPayReaskRequirementSchema,
103
+ MoonPayReaskSchema: () => MoonPayReaskSchema,
96
104
  MoonPayRequestContextSchema: () => MoonPayRequestContextSchema,
97
105
  MoonPayRequestSchema: () => MoonPayRequestSchema,
98
106
  MoonPayResponseSchemaFor: () => MoonPayResponseSchemaFor,
99
107
  MoonPaySdkCredentialsSchema: () => MoonPaySdkCredentialsSchema,
108
+ MoonPaySessionNextActionSchema: () => MoonPaySessionNextActionSchema,
109
+ MoonPaySessionRequestSchema: () => MoonPaySessionRequestSchema,
100
110
  MoonPayStepResponseSchema: () => MoonPayStepResponseSchema,
101
111
  MoonPayWaitNextActionSchema: () => MoonPayWaitNextActionSchema,
102
112
  OrderAwaitingConfirmationStateSchema: () => OrderAwaitingConfirmationStateSchema,
@@ -106,6 +116,7 @@ __export(index_exports, {
106
116
  OrderSummarySchema: () => OrderSummarySchema,
107
117
  PAYMENT_METHOD_CATEGORIES: () => PAYMENT_METHOD_CATEGORIES,
108
118
  PROVIDER_CHECKOUT_DOCUMENTS: () => PROVIDER_CHECKOUT_DOCUMENTS,
119
+ PROVIDER_KYC_DOCUMENTS: () => PROVIDER_KYC_DOCUMENTS,
109
120
  PUBLISHED_TERMS_DOCUMENTS: () => PUBLISHED_TERMS_DOCUMENTS,
110
121
  PaymentCaptureStateSchema: () => PaymentCaptureStateSchema,
111
122
  PaymentInstructStateSchema: () => PaymentInstructStateSchema,
@@ -1058,18 +1069,6 @@ var $routingProvider = $provider.extract(["TRANSAK", "BANXA", "MOONPAY", "STRIPE
1058
1069
  var $optionalGeoField = import_zod.z.union([$nonBlank, import_zod.z.literal("")]).optional();
1059
1070
  var US_REGION_REQUIRED = "a US buyer needs a US state code as region";
1060
1071
  var hasUsRegion = (country, region) => country !== "US" || UsStateCodeSchema.safeParse(region).success;
1061
- var $routingTableQuery = obj({
1062
- fiatCurrencyCode: import_zod.z.enum(FIAT_CURRENCY_CODES).optional(),
1063
- cryptoCurrencyCode: $nonBlank,
1064
- chainId: $nonBlank,
1065
- country: $countryCode,
1066
- region: $optionalGeoField,
1067
- methods: import_zod.z.string().refine(
1068
- (methods) => methods.split(",").every((method) => PAYMENT_METHOD_CATEGORIES.includes(method.trim())),
1069
- "must be comma-separated payment method categories"
1070
- )
1071
- }).refine((query) => hasUsRegion(query.country, query.region), { message: US_REGION_REQUIRED, path: ["region"] });
1072
- var FiatRoutingTableQuerySchema = $routingTableQuery;
1073
1072
  var $routingTableProviderInputs = obj({
1074
1073
  MOONPAY: obj({ accessToken: $nonBlank.optional() }).optional()
1075
1074
  });
@@ -1243,7 +1242,7 @@ var $stepResponse = import_zod.z.union([$providerBoundStepResponse, $blockedStep
1243
1242
  var FiatStepResponseSchema = $stepResponse;
1244
1243
 
1245
1244
  // package.json
1246
- var version = "0.31.0";
1245
+ var version = "0.34.0";
1247
1246
 
1248
1247
  // src/table.ts
1249
1248
  var TABLE_VERSION = version;
@@ -2812,6 +2811,17 @@ function assertAllFixtures() {
2812
2811
  // src/terms.ts
2813
2812
  var FIAT_TERMS_ENDPOINT = "POST /fiat/terms";
2814
2813
  var MOONPAY_TERMS = {
2814
+ id: "MOONPAY_TERMS",
2815
+ kind: "PROVIDER_TERMS",
2816
+ stage: "CHECKOUT",
2817
+ version: "moonpay-terms-2026-09",
2818
+ contentDigest: "aab09ddd95a6fdd3f7c483e22833375a03c031d7379a3f60e09aa46ab4856d07",
2819
+ links: [
2820
+ { label: "MoonPay Terms of Use", url: "https://www.moonpay.com/legal/terms" },
2821
+ { label: "MoonPay Privacy Policy", url: "https://www.moonpay.com/legal/privacy_policy" }
2822
+ ]
2823
+ };
2824
+ var MOONPAY_TERMS_KYC_SHARING_V2 = {
2815
2825
  id: "MOONPAY_TERMS",
2816
2826
  kind: "PROVIDER_TERMS",
2817
2827
  stage: "CHECKOUT",
@@ -2823,9 +2833,20 @@ var MOONPAY_TERMS = {
2823
2833
  { label: "Persona Privacy Policy", url: "https://withpersona.com/legal/privacy-policy" }
2824
2834
  ]
2825
2835
  };
2836
+ var MOONPAY_KYC_SHARING = {
2837
+ id: "MOONPAY_KYC_SHARING",
2838
+ kind: "PROVIDER_KYC_SHARING",
2839
+ stage: "KYC",
2840
+ version: "2026-09-l2-kyc-sharing-v3",
2841
+ contentDigest: "fe587d7c6542a12070444ddb2e6ff0f2f6062b00ffc512cdb5c60438d355088e",
2842
+ links: [{ label: "Persona Privacy Policy", url: "https://withpersona.com/legal/privacy-policy" }]
2843
+ };
2826
2844
  var PROVIDER_CHECKOUT_DOCUMENTS = {
2827
2845
  MOONPAY: [MOONPAY_TERMS]
2828
2846
  };
2847
+ var PROVIDER_KYC_DOCUMENTS = {
2848
+ MOONPAY: [MOONPAY_KYC_SHARING]
2849
+ };
2829
2850
  var funKycConsent = (contentDigest) => ({
2830
2851
  id: "FUN_KYC_CONSENT",
2831
2852
  kind: "FUN_KYC_COLLECTION",
@@ -2844,7 +2865,12 @@ var FUN_KYC_CONSENT_DOCUMENTS = {
2844
2865
  tr: funKycConsent("463040c3b58c922ecae2ae8262a78eb732bbcc5606c394723626378b3db2bbc3"),
2845
2866
  zh: funKycConsent("7f76d850adaf69783c5d9365e51abb5446f4e5778c63eabbdb4784d72464f855")
2846
2867
  };
2847
- var PUBLISHED_TERMS_DOCUMENTS = [MOONPAY_TERMS, ...Object.values(FUN_KYC_CONSENT_DOCUMENTS)];
2868
+ var PUBLISHED_TERMS_DOCUMENTS = [
2869
+ MOONPAY_TERMS_KYC_SHARING_V2,
2870
+ MOONPAY_TERMS,
2871
+ MOONPAY_KYC_SHARING,
2872
+ ...Object.values(FUN_KYC_CONSENT_DOCUMENTS)
2873
+ ];
2848
2874
 
2849
2875
  // src/routing.ts
2850
2876
  var ROUTING_ENDPOINTS = {
@@ -2888,46 +2914,86 @@ var $consentFields = {
2888
2914
  action: import_zod2.z.literal("consent"),
2889
2915
  acceptances: import_zod2.z.array(TermsDocumentAcceptanceSchema).min(1).refine((acceptances) => hasUniqueIds2(acceptances.map((acceptance) => acceptance.documentId)), "each document is accepted once")
2890
2916
  };
2917
+ var $sessionFields = { action: import_zod2.z.literal("session") };
2891
2918
  var $connectFields = { action: import_zod2.z.literal("connect"), customerId: $nonEmpty, accessToken: $nonEmpty };
2892
2919
  var $kycFields = {
2893
2920
  action: import_zod2.z.literal("kyc"),
2894
2921
  credentials: $credentials,
2895
- values: import_zod2.z.record(KycFieldIdSchema, import_zod2.z.string()).refine((values) => Object.keys(values).length > 0, "values must not be empty")
2922
+ values: import_zod2.z.record(KycFieldIdSchema, import_zod2.z.string())
2896
2923
  };
2924
+ var $prepareCaptureFields = { action: import_zod2.z.literal("prepareCapture"), credentials: $credentials };
2925
+ var $captureFields = { action: import_zod2.z.literal("capture"), credentials: $credentials, result: KycSdkResultReportSchema };
2897
2926
  var $orderFields = { action: import_zod2.z.literal("order"), orderId: $nonEmpty, quotedAmount: FiatAmountSchema, transactionId: $nonEmpty.optional() };
2898
2927
  var $observeRequest = obj2({ ...$context, ...$observeFields });
2899
2928
  var $consentRequest = obj2({ ...$context, ...$consentFields });
2929
+ var $sessionRequest = obj2({ ...$context, ...$sessionFields });
2900
2930
  var $connectRequest = obj2({ ...$context, ...$connectFields });
2901
2931
  var $kycRequest = obj2({ ...$context, ...$kycFields });
2932
+ var $prepareCaptureRequest = obj2({ ...$context, ...$prepareCaptureFields });
2933
+ var $captureRequest = obj2({ ...$context, ...$captureFields });
2902
2934
  var $orderRequest = obj2({ ...$context, ...$orderFields });
2903
2935
  var MoonPayObserveRequestSchema = $observeRequest;
2904
2936
  var MoonPayConsentRequestSchema = $consentRequest;
2937
+ var MoonPaySessionRequestSchema = $sessionRequest;
2905
2938
  var MoonPayConnectRequestSchema = $connectRequest;
2906
2939
  var MoonPayKycRequestSchema = $kycRequest;
2940
+ var MoonPayPrepareCaptureRequestSchema = $prepareCaptureRequest;
2941
+ var MoonPayCaptureRequestSchema = $captureRequest;
2907
2942
  var MoonPayOrderRequestSchema = $orderRequest;
2908
- var $request = import_zod2.z.discriminatedUnion("action", [$observeRequest, $consentRequest, $connectRequest, $kycRequest, $orderRequest]);
2943
+ var $request = import_zod2.z.discriminatedUnion("action", [$observeRequest, $consentRequest, $sessionRequest, $connectRequest, $kycRequest, $prepareCaptureRequest, $captureRequest, $orderRequest]);
2909
2944
  var MoonPayRequestSchema = $request;
2910
2945
  var $envelope = { provider: import_zod2.z.literal("MOONPAY"), geo: FiatGeoSchema, ...$context };
2911
2946
  var $nextRequest2 = import_zod2.z.discriminatedUnion("action", [
2912
2947
  obj2({ ...$envelope, ...$observeFields }),
2913
2948
  obj2({ ...$envelope, ...$consentFields }),
2949
+ obj2({ ...$envelope, ...$sessionFields }),
2914
2950
  obj2({ ...$envelope, ...$connectFields }),
2915
2951
  obj2({ ...$envelope, ...$kycFields }),
2952
+ obj2({ ...$envelope, ...$prepareCaptureFields }),
2953
+ obj2({ ...$envelope, ...$captureFields }),
2916
2954
  obj2({ ...$envelope, ...$orderFields })
2917
2955
  ]);
2918
2956
  var MoonPayNextRequestSchema = $nextRequest2;
2919
2957
  var FIELD_OF_CODE = { PHONE_IN_USE: "PHONE_NUMBER", TAX_ID_IN_USE: "TAX_IDENTIFIER" };
2920
2958
  var $fieldError = obj2({ fieldId: $nonEmpty, message: $nonEmpty, code: import_zod2.z.enum(["PHONE_IN_USE", "TAX_ID_IN_USE"]).optional() });
2921
2959
  var $consentShape = obj2({ next: import_zod2.z.literal("consent"), documents: import_zod2.z.array(TermsDocumentSchema).min(1) });
2960
+ var $sessionNextAction = obj2({ next: import_zod2.z.literal("session") });
2922
2961
  var $connectNextAction = obj2({
2923
2962
  next: import_zod2.z.literal("connect"),
2924
2963
  sessionToken: $nonEmpty,
2925
2964
  quoteInput: $quoteInput,
2926
2965
  resetConnection: import_zod2.z.literal(true).optional()
2927
2966
  });
2928
- var $kycShape = obj2({ next: import_zod2.z.literal("kyc"), fields: import_zod2.z.array(FormFieldSchema).min(1), fieldErrors: import_zod2.z.array($fieldError).min(1).optional() });
2967
+ var CAPTURE_DOCUMENTS = ["IDENTITY_DOCUMENT", "SELFIE", "PROOF_OF_ADDRESS", "PROOF_OF_INCOME"];
2968
+ var $captureDocument = import_zod2.z.enum(CAPTURE_DOCUMENTS);
2969
+ var $reaskRequirement = import_zod2.z.union([KycFieldIdSchema, $captureDocument]);
2970
+ var $reaskReason = import_zod2.z.enum(["EXPIRED", "POOR_QUALITY", "MISMATCH", "REJECTED"]);
2971
+ var $reask = obj2({
2972
+ requirements: import_zod2.z.array($reaskRequirement).min(1).refine(hasUniqueIds2, "requirements must be unique"),
2973
+ reason: $reaskReason.nullable()
2974
+ });
2975
+ var $kycShape = obj2({
2976
+ next: import_zod2.z.literal("kyc"),
2977
+ fields: import_zod2.z.array(FormFieldSchema),
2978
+ fieldErrors: import_zod2.z.array($fieldError).min(1).optional(),
2979
+ reask: $reask.nullable()
2980
+ });
2981
+ var $prepareCaptureNextAction = obj2({ next: import_zod2.z.literal("prepareCapture") });
2982
+ var $captureShape = obj2({
2983
+ next: import_zod2.z.literal("capture"),
2984
+ kycProvider: KYCProviderSchema,
2985
+ accessToken: $nonEmpty,
2986
+ expiresAt: import_zod2.z.string().datetime({ offset: true }),
2987
+ reask: $reask.nullable()
2988
+ });
2929
2989
  var $waitNextAction = obj2({ next: import_zod2.z.literal("wait"), retryAfterMs: import_zod2.z.number().int().positive().max(6e4) });
2930
2990
  var $orderNextAction = obj2({ next: import_zod2.z.literal("order"), orderId: $nonEmpty, quoteInput: $quoteInput });
2991
+ var $orderPendingNextAction = obj2({
2992
+ next: import_zod2.z.literal("orderPending"),
2993
+ orderId: $nonEmpty,
2994
+ retryAfterMs: import_zod2.z.number().int().positive().max(6e4),
2995
+ order: FiatStepResponseSchema.nullable()
2996
+ });
2931
2997
  var checkConsent = (nextAction, context) => {
2932
2998
  if (!hasUniqueIds2(nextAction.documents.map((document) => document.id))) {
2933
2999
  context.addIssue({ code: "custom", path: ["documents"], message: "document ids must be unique" });
@@ -2944,17 +3010,35 @@ var checkKyc = (nextAction, context) => {
2944
3010
  if (nextAction.fieldErrors?.some((error) => error.code && FIELD_OF_CODE[error.code] !== error.fieldId)) {
2945
3011
  context.addIssue({ code: "custom", path: ["fieldErrors"], message: "a field error code must match its field" });
2946
3012
  }
3013
+ if (nextAction.reask?.requirements.some((requirement) => !fieldIds.includes(requirement))) {
3014
+ context.addIssue({ code: "custom", path: ["reask"], message: "a kyc reask must name fields in this next action" });
3015
+ }
3016
+ };
3017
+ var isCaptureDocument = (requirement) => CAPTURE_DOCUMENTS.includes(requirement);
3018
+ var checkCapture = (nextAction, context) => {
3019
+ if (nextAction.reask?.requirements.some((requirement) => !isCaptureDocument(requirement))) {
3020
+ context.addIssue({ code: "custom", path: ["reask"], message: "a capture reask must name documents only" });
3021
+ }
2947
3022
  };
2948
3023
  var MoonPayConsentNextActionSchema = $consentShape.superRefine(checkConsent);
3024
+ var MoonPaySessionNextActionSchema = $sessionNextAction;
2949
3025
  var MoonPayConnectNextActionSchema = $connectNextAction;
2950
3026
  var MoonPayKycNextActionSchema = $kycShape.superRefine(checkKyc);
3027
+ var MoonPayPrepareCaptureNextActionSchema = $prepareCaptureNextAction;
3028
+ var MoonPayCaptureDocumentSchema = $captureDocument;
3029
+ var MoonPayReaskRequirementSchema = $reaskRequirement;
3030
+ var MoonPayReaskReasonSchema = $reaskReason;
3031
+ var MoonPayReaskSchema = $reask;
3032
+ var MoonPayCaptureNextActionSchema = $captureShape.superRefine(checkCapture);
2951
3033
  var MoonPayWaitNextActionSchema = $waitNextAction;
2952
3034
  var MoonPayOrderNextActionSchema = $orderNextAction;
3035
+ var MoonPayOrderPendingNextActionSchema = $orderPendingNextAction;
2953
3036
  var checkNextAction = (response, context) => {
2954
3037
  if (response.next === "consent") checkConsent(response, context);
2955
3038
  if (response.next === "kyc") checkKyc(response, context);
3039
+ if (response.next === "capture") checkCapture(response, context);
2956
3040
  };
2957
- var $nextActionOptions = [$consentShape, $connectNextAction, $kycShape, $waitNextAction, $orderNextAction];
3041
+ var $nextActionOptions = [$consentShape, $sessionNextAction, $connectNextAction, $kycShape, $prepareCaptureNextAction, $captureShape, $waitNextAction, $orderNextAction];
2958
3042
  var $nextAction = import_zod2.z.discriminatedUnion("next", [...$nextActionOptions]).superRefine(checkNextAction);
2959
3043
  var MoonPayNextActionSchema = $nextAction;
2960
3044
  var $done = obj2({ next: import_zod2.z.literal("done"), order: FiatStepResponseSchema });
@@ -2971,13 +3055,16 @@ var $orderRefused = obj2({
2971
3055
  });
2972
3056
  var $stepResponse2 = import_zod2.z.discriminatedUnion("next", [...$nextActionOptions, $stepRefused]).superRefine(checkNextAction);
2973
3057
  var MoonPayStepResponseSchema = $stepResponse2;
2974
- var $orderResponse = import_zod2.z.discriminatedUnion("next", [$done, $orderNextAction, $orderRefused]);
3058
+ var $orderResponse = import_zod2.z.discriminatedUnion("next", [$done, $orderNextAction, $orderPendingNextAction, $orderRefused]);
2975
3059
  var MoonPayOrderResponseSchema = $orderResponse;
2976
3060
  var MoonPayResponseSchemaFor = {
2977
3061
  observe: MoonPayStepResponseSchema,
2978
3062
  consent: MoonPayStepResponseSchema,
3063
+ session: MoonPayStepResponseSchema,
2979
3064
  connect: MoonPayStepResponseSchema,
2980
3065
  kyc: MoonPayStepResponseSchema,
3066
+ prepareCapture: MoonPayStepResponseSchema,
3067
+ capture: MoonPayStepResponseSchema,
2981
3068
  order: MoonPayOrderResponseSchema
2982
3069
  };
2983
3070
  var $faultFields = {
package/dist/index.mjs CHANGED
@@ -12,7 +12,7 @@ import {
12
12
  tableEntry,
13
13
  unofferedEndpoints,
14
14
  unreachableStates
15
- } from "./chunk-UT4VI4ZA.mjs";
15
+ } from "./chunk-5ZGSYLC3.mjs";
16
16
  import {
17
17
  MOONPAY_ENDPOINTS
18
18
  } from "./chunk-TIEGTTFY.mjs";
@@ -20,8 +20,9 @@ import {
20
20
  FIAT_TERMS_ENDPOINT,
21
21
  FUN_KYC_CONSENT_DOCUMENTS,
22
22
  PROVIDER_CHECKOUT_DOCUMENTS,
23
+ PROVIDER_KYC_DOCUMENTS,
23
24
  PUBLISHED_TERMS_DOCUMENTS
24
- } from "./chunk-EFWIJWBC.mjs";
25
+ } from "./chunk-2CCO7UIS.mjs";
25
26
  import {
26
27
  ROUTING_ENDPOINTS
27
28
  } from "./chunk-2NZSOZHV.mjs";
@@ -920,18 +921,6 @@ var $routingProvider = $provider.extract(["TRANSAK", "BANXA", "MOONPAY", "STRIPE
920
921
  var $optionalGeoField = z.union([$nonBlank, z.literal("")]).optional();
921
922
  var US_REGION_REQUIRED = "a US buyer needs a US state code as region";
922
923
  var hasUsRegion = (country, region) => country !== "US" || UsStateCodeSchema.safeParse(region).success;
923
- var $routingTableQuery = obj({
924
- fiatCurrencyCode: z.enum(FIAT_CURRENCY_CODES).optional(),
925
- cryptoCurrencyCode: $nonBlank,
926
- chainId: $nonBlank,
927
- country: $countryCode,
928
- region: $optionalGeoField,
929
- methods: z.string().refine(
930
- (methods) => methods.split(",").every((method) => PAYMENT_METHOD_CATEGORIES.includes(method.trim())),
931
- "must be comma-separated payment method categories"
932
- )
933
- }).refine((query) => hasUsRegion(query.country, query.region), { message: US_REGION_REQUIRED, path: ["region"] });
934
- var FiatRoutingTableQuerySchema = $routingTableQuery;
935
924
  var $routingTableProviderInputs = obj({
936
925
  MOONPAY: obj({ accessToken: $nonBlank.optional() }).optional()
937
926
  });
@@ -2199,46 +2188,86 @@ var $consentFields = {
2199
2188
  action: z2.literal("consent"),
2200
2189
  acceptances: z2.array(TermsDocumentAcceptanceSchema).min(1).refine((acceptances) => hasUniqueIds2(acceptances.map((acceptance) => acceptance.documentId)), "each document is accepted once")
2201
2190
  };
2191
+ var $sessionFields = { action: z2.literal("session") };
2202
2192
  var $connectFields = { action: z2.literal("connect"), customerId: $nonEmpty, accessToken: $nonEmpty };
2203
2193
  var $kycFields = {
2204
2194
  action: z2.literal("kyc"),
2205
2195
  credentials: $credentials,
2206
- values: z2.record(KycFieldIdSchema, z2.string()).refine((values) => Object.keys(values).length > 0, "values must not be empty")
2196
+ values: z2.record(KycFieldIdSchema, z2.string())
2207
2197
  };
2198
+ var $prepareCaptureFields = { action: z2.literal("prepareCapture"), credentials: $credentials };
2199
+ var $captureFields = { action: z2.literal("capture"), credentials: $credentials, result: KycSdkResultReportSchema };
2208
2200
  var $orderFields = { action: z2.literal("order"), orderId: $nonEmpty, quotedAmount: FiatAmountSchema, transactionId: $nonEmpty.optional() };
2209
2201
  var $observeRequest = obj2({ ...$context, ...$observeFields });
2210
2202
  var $consentRequest = obj2({ ...$context, ...$consentFields });
2203
+ var $sessionRequest = obj2({ ...$context, ...$sessionFields });
2211
2204
  var $connectRequest = obj2({ ...$context, ...$connectFields });
2212
2205
  var $kycRequest = obj2({ ...$context, ...$kycFields });
2206
+ var $prepareCaptureRequest = obj2({ ...$context, ...$prepareCaptureFields });
2207
+ var $captureRequest = obj2({ ...$context, ...$captureFields });
2213
2208
  var $orderRequest = obj2({ ...$context, ...$orderFields });
2214
2209
  var MoonPayObserveRequestSchema = $observeRequest;
2215
2210
  var MoonPayConsentRequestSchema = $consentRequest;
2211
+ var MoonPaySessionRequestSchema = $sessionRequest;
2216
2212
  var MoonPayConnectRequestSchema = $connectRequest;
2217
2213
  var MoonPayKycRequestSchema = $kycRequest;
2214
+ var MoonPayPrepareCaptureRequestSchema = $prepareCaptureRequest;
2215
+ var MoonPayCaptureRequestSchema = $captureRequest;
2218
2216
  var MoonPayOrderRequestSchema = $orderRequest;
2219
- var $request = z2.discriminatedUnion("action", [$observeRequest, $consentRequest, $connectRequest, $kycRequest, $orderRequest]);
2217
+ var $request = z2.discriminatedUnion("action", [$observeRequest, $consentRequest, $sessionRequest, $connectRequest, $kycRequest, $prepareCaptureRequest, $captureRequest, $orderRequest]);
2220
2218
  var MoonPayRequestSchema = $request;
2221
2219
  var $envelope = { provider: z2.literal("MOONPAY"), geo: FiatGeoSchema, ...$context };
2222
2220
  var $nextRequest2 = z2.discriminatedUnion("action", [
2223
2221
  obj2({ ...$envelope, ...$observeFields }),
2224
2222
  obj2({ ...$envelope, ...$consentFields }),
2223
+ obj2({ ...$envelope, ...$sessionFields }),
2225
2224
  obj2({ ...$envelope, ...$connectFields }),
2226
2225
  obj2({ ...$envelope, ...$kycFields }),
2226
+ obj2({ ...$envelope, ...$prepareCaptureFields }),
2227
+ obj2({ ...$envelope, ...$captureFields }),
2227
2228
  obj2({ ...$envelope, ...$orderFields })
2228
2229
  ]);
2229
2230
  var MoonPayNextRequestSchema = $nextRequest2;
2230
2231
  var FIELD_OF_CODE = { PHONE_IN_USE: "PHONE_NUMBER", TAX_ID_IN_USE: "TAX_IDENTIFIER" };
2231
2232
  var $fieldError = obj2({ fieldId: $nonEmpty, message: $nonEmpty, code: z2.enum(["PHONE_IN_USE", "TAX_ID_IN_USE"]).optional() });
2232
2233
  var $consentShape = obj2({ next: z2.literal("consent"), documents: z2.array(TermsDocumentSchema).min(1) });
2234
+ var $sessionNextAction = obj2({ next: z2.literal("session") });
2233
2235
  var $connectNextAction = obj2({
2234
2236
  next: z2.literal("connect"),
2235
2237
  sessionToken: $nonEmpty,
2236
2238
  quoteInput: $quoteInput,
2237
2239
  resetConnection: z2.literal(true).optional()
2238
2240
  });
2239
- var $kycShape = obj2({ next: z2.literal("kyc"), fields: z2.array(FormFieldSchema).min(1), fieldErrors: z2.array($fieldError).min(1).optional() });
2241
+ var CAPTURE_DOCUMENTS = ["IDENTITY_DOCUMENT", "SELFIE", "PROOF_OF_ADDRESS", "PROOF_OF_INCOME"];
2242
+ var $captureDocument = z2.enum(CAPTURE_DOCUMENTS);
2243
+ var $reaskRequirement = z2.union([KycFieldIdSchema, $captureDocument]);
2244
+ var $reaskReason = z2.enum(["EXPIRED", "POOR_QUALITY", "MISMATCH", "REJECTED"]);
2245
+ var $reask = obj2({
2246
+ requirements: z2.array($reaskRequirement).min(1).refine(hasUniqueIds2, "requirements must be unique"),
2247
+ reason: $reaskReason.nullable()
2248
+ });
2249
+ var $kycShape = obj2({
2250
+ next: z2.literal("kyc"),
2251
+ fields: z2.array(FormFieldSchema),
2252
+ fieldErrors: z2.array($fieldError).min(1).optional(),
2253
+ reask: $reask.nullable()
2254
+ });
2255
+ var $prepareCaptureNextAction = obj2({ next: z2.literal("prepareCapture") });
2256
+ var $captureShape = obj2({
2257
+ next: z2.literal("capture"),
2258
+ kycProvider: KYCProviderSchema,
2259
+ accessToken: $nonEmpty,
2260
+ expiresAt: z2.string().datetime({ offset: true }),
2261
+ reask: $reask.nullable()
2262
+ });
2240
2263
  var $waitNextAction = obj2({ next: z2.literal("wait"), retryAfterMs: z2.number().int().positive().max(6e4) });
2241
2264
  var $orderNextAction = obj2({ next: z2.literal("order"), orderId: $nonEmpty, quoteInput: $quoteInput });
2265
+ var $orderPendingNextAction = obj2({
2266
+ next: z2.literal("orderPending"),
2267
+ orderId: $nonEmpty,
2268
+ retryAfterMs: z2.number().int().positive().max(6e4),
2269
+ order: FiatStepResponseSchema.nullable()
2270
+ });
2242
2271
  var checkConsent = (nextAction, context) => {
2243
2272
  if (!hasUniqueIds2(nextAction.documents.map((document) => document.id))) {
2244
2273
  context.addIssue({ code: "custom", path: ["documents"], message: "document ids must be unique" });
@@ -2255,17 +2284,35 @@ var checkKyc = (nextAction, context) => {
2255
2284
  if (nextAction.fieldErrors?.some((error) => error.code && FIELD_OF_CODE[error.code] !== error.fieldId)) {
2256
2285
  context.addIssue({ code: "custom", path: ["fieldErrors"], message: "a field error code must match its field" });
2257
2286
  }
2287
+ if (nextAction.reask?.requirements.some((requirement) => !fieldIds.includes(requirement))) {
2288
+ context.addIssue({ code: "custom", path: ["reask"], message: "a kyc reask must name fields in this next action" });
2289
+ }
2290
+ };
2291
+ var isCaptureDocument = (requirement) => CAPTURE_DOCUMENTS.includes(requirement);
2292
+ var checkCapture = (nextAction, context) => {
2293
+ if (nextAction.reask?.requirements.some((requirement) => !isCaptureDocument(requirement))) {
2294
+ context.addIssue({ code: "custom", path: ["reask"], message: "a capture reask must name documents only" });
2295
+ }
2258
2296
  };
2259
2297
  var MoonPayConsentNextActionSchema = $consentShape.superRefine(checkConsent);
2298
+ var MoonPaySessionNextActionSchema = $sessionNextAction;
2260
2299
  var MoonPayConnectNextActionSchema = $connectNextAction;
2261
2300
  var MoonPayKycNextActionSchema = $kycShape.superRefine(checkKyc);
2301
+ var MoonPayPrepareCaptureNextActionSchema = $prepareCaptureNextAction;
2302
+ var MoonPayCaptureDocumentSchema = $captureDocument;
2303
+ var MoonPayReaskRequirementSchema = $reaskRequirement;
2304
+ var MoonPayReaskReasonSchema = $reaskReason;
2305
+ var MoonPayReaskSchema = $reask;
2306
+ var MoonPayCaptureNextActionSchema = $captureShape.superRefine(checkCapture);
2262
2307
  var MoonPayWaitNextActionSchema = $waitNextAction;
2263
2308
  var MoonPayOrderNextActionSchema = $orderNextAction;
2309
+ var MoonPayOrderPendingNextActionSchema = $orderPendingNextAction;
2264
2310
  var checkNextAction = (response, context) => {
2265
2311
  if (response.next === "consent") checkConsent(response, context);
2266
2312
  if (response.next === "kyc") checkKyc(response, context);
2313
+ if (response.next === "capture") checkCapture(response, context);
2267
2314
  };
2268
- var $nextActionOptions = [$consentShape, $connectNextAction, $kycShape, $waitNextAction, $orderNextAction];
2315
+ var $nextActionOptions = [$consentShape, $sessionNextAction, $connectNextAction, $kycShape, $prepareCaptureNextAction, $captureShape, $waitNextAction, $orderNextAction];
2269
2316
  var $nextAction = z2.discriminatedUnion("next", [...$nextActionOptions]).superRefine(checkNextAction);
2270
2317
  var MoonPayNextActionSchema = $nextAction;
2271
2318
  var $done = obj2({ next: z2.literal("done"), order: FiatStepResponseSchema });
@@ -2282,13 +2329,16 @@ var $orderRefused = obj2({
2282
2329
  });
2283
2330
  var $stepResponse2 = z2.discriminatedUnion("next", [...$nextActionOptions, $stepRefused]).superRefine(checkNextAction);
2284
2331
  var MoonPayStepResponseSchema = $stepResponse2;
2285
- var $orderResponse = z2.discriminatedUnion("next", [$done, $orderNextAction, $orderRefused]);
2332
+ var $orderResponse = z2.discriminatedUnion("next", [$done, $orderNextAction, $orderPendingNextAction, $orderRefused]);
2286
2333
  var MoonPayOrderResponseSchema = $orderResponse;
2287
2334
  var MoonPayResponseSchemaFor = {
2288
2335
  observe: MoonPayStepResponseSchema,
2289
2336
  consent: MoonPayStepResponseSchema,
2337
+ session: MoonPayStepResponseSchema,
2290
2338
  connect: MoonPayStepResponseSchema,
2291
2339
  kyc: MoonPayStepResponseSchema,
2340
+ prepareCapture: MoonPayStepResponseSchema,
2341
+ capture: MoonPayStepResponseSchema,
2292
2342
  order: MoonPayOrderResponseSchema
2293
2343
  };
2294
2344
  var $faultFields = {
@@ -2336,7 +2386,6 @@ export {
2336
2386
  FiatRoutingQuoteRequestSchema,
2337
2387
  FiatRoutingQuoteTermsSchema,
2338
2388
  FiatRoutingTableErrorBodySchema,
2339
- FiatRoutingTableQuerySchema,
2340
2389
  FiatRoutingTableRequestSchema,
2341
2390
  FiatRoutingTableResponseSchema,
2342
2391
  FiatStepResponseSchema,
@@ -2363,6 +2412,9 @@ export {
2363
2412
  KycReviewDurationSchema,
2364
2413
  KycSdkResultReportSchema,
2365
2414
  MOONPAY_ENDPOINTS,
2415
+ MoonPayCaptureDocumentSchema,
2416
+ MoonPayCaptureNextActionSchema,
2417
+ MoonPayCaptureRequestSchema,
2366
2418
  MoonPayCheckoutSchema,
2367
2419
  MoonPayConnectNextActionSchema,
2368
2420
  MoonPayConnectRequestSchema,
@@ -2377,13 +2429,21 @@ export {
2377
2429
  MoonPayNextRequestSchema,
2378
2430
  MoonPayObserveRequestSchema,
2379
2431
  MoonPayOrderNextActionSchema,
2432
+ MoonPayOrderPendingNextActionSchema,
2380
2433
  MoonPayOrderRequestSchema,
2381
2434
  MoonPayOrderResponseSchema,
2435
+ MoonPayPrepareCaptureNextActionSchema,
2436
+ MoonPayPrepareCaptureRequestSchema,
2382
2437
  MoonPayQuoteInputSchema,
2438
+ MoonPayReaskReasonSchema,
2439
+ MoonPayReaskRequirementSchema,
2440
+ MoonPayReaskSchema,
2383
2441
  MoonPayRequestContextSchema,
2384
2442
  MoonPayRequestSchema,
2385
2443
  MoonPayResponseSchemaFor,
2386
2444
  MoonPaySdkCredentialsSchema,
2445
+ MoonPaySessionNextActionSchema,
2446
+ MoonPaySessionRequestSchema,
2387
2447
  MoonPayStepResponseSchema,
2388
2448
  MoonPayWaitNextActionSchema,
2389
2449
  OrderAwaitingConfirmationStateSchema,
@@ -2393,6 +2453,7 @@ export {
2393
2453
  OrderSummarySchema,
2394
2454
  PAYMENT_METHOD_CATEGORIES,
2395
2455
  PROVIDER_CHECKOUT_DOCUMENTS,
2456
+ PROVIDER_KYC_DOCUMENTS,
2396
2457
  PUBLISHED_TERMS_DOCUMENTS,
2397
2458
  PaymentCaptureStateSchema,
2398
2459
  PaymentInstructStateSchema,
@@ -5,6 +5,7 @@
5
5
  * the client needs to do it. The client's request names it in `action` and carries the result. Every
6
6
  * response is the next action, `done`, or `refused` (`MoonPayResponseFor`). `observe` carries no
7
7
  * result and answers the current next action. `wait` has no request: the client sends `observe` after it.
8
+ * `orderPending` answers only `order` and has no request either: the client sends the same `order` after it.
8
9
  *
9
10
  * The body is `MoonPayNextRequest`: `provider`, the shared `geo`, the context (`checkout`, and
10
11
  * `credentials` after `connect`), and the action's result. Identity and the deposit wallet always
@@ -20,11 +21,11 @@
20
21
  */
21
22
  import type { FiatCurrencyCode } from '../codes';
22
23
  import type { FiatTermsRequest, TermsDocument } from '../terms';
23
- import type { FiatAmount, FiatGeo, FiatStepResponse, FormField, KycFieldId } from '../types';
24
+ import type { FiatAmount, FiatGeo, FiatStepResponse, FormField, KYCProvider, KycFieldId, KycSdkResultReport } from '../types';
24
25
  export declare const MOONPAY_ENDPOINTS: {
25
26
  readonly next: "POST /fiat/next";
26
27
  };
27
- export type MoonPayAction = 'observe' | 'consent' | 'connect' | 'kyc' | 'wait' | 'order';
28
+ export type MoonPayAction = 'observe' | 'consent' | 'session' | 'connect' | 'kyc' | 'prepareCapture' | 'capture' | 'wait' | 'order';
28
29
  /** The checkout terms. The client holds them and sends them on every request. */
29
30
  export interface MoonPayCheckout {
30
31
  amount: FiatAmount;
@@ -84,8 +85,20 @@ export type MoonPayConsentRequest = {
84
85
  acceptances: FiatTermsRequest['acceptances'];
85
86
  };
86
87
  /**
87
- * Run MoonPay's connection check with `sessionToken`; it asks for an OTP only if the hidden check
88
- * fails. `resetConnection`: the device's connection is another buyer's, so reset it first.
88
+ * Send `session` so the backend mints a MoonPay SDK session token. Each request mints a new token and
89
+ * spends one from the per-login session budget; once it is spent the fault is `SESSION_BUDGET_SPENT`.
90
+ */
91
+ export type MoonPaySessionNextAction = {
92
+ next: 'session';
93
+ };
94
+ /** Answered with `connect` carrying the new `sessionToken`. */
95
+ export type MoonPaySessionRequest = {
96
+ action: 'session';
97
+ };
98
+ /**
99
+ * Run MoonPay's connection check with `sessionToken`, the token `session` minted; it asks for an OTP
100
+ * only if the hidden check fails. `resetConnection`: the device's connection is another buyer's, so
101
+ * reset it first.
89
102
  */
90
103
  export type MoonPayConnectNextAction = {
91
104
  next: 'connect';
@@ -109,19 +122,78 @@ export interface MoonPayFieldError {
109
122
  message: string;
110
123
  code?: MoonPayFieldErrorCode;
111
124
  }
112
- /** Show the shared form. */
125
+ /**
126
+ * Show the shared form. Empty `fields` means nothing for the buyer to type: the client sends
127
+ * `{ action: 'kyc', values: {} }` at once and the backend shares the KYC data it already holds.
128
+ * `reask` names fields of this form the buyer gave before and MoonPay asks for again; `null` otherwise.
129
+ */
113
130
  export type MoonPayKycNextAction = {
114
131
  next: 'kyc';
115
132
  fields: FormField[];
116
133
  fieldErrors?: MoonPayFieldError[];
134
+ reask: MoonPayReask | null;
117
135
  };
118
- /** Keyed by the ids of the next action's fields; there is no form id. Needs `credentials`: the backend reads the customer. */
136
+ /**
137
+ * Keyed by the ids of the next action's fields; there is no form id. `values` is empty when the next
138
+ * action's `fields` is. Needs `credentials`: the backend reads the customer.
139
+ */
119
140
  export type MoonPayKycRequest = {
120
141
  action: 'kyc';
121
142
  credentials: MoonPaySdkCredentials;
122
143
  values: Partial<Record<KycFieldId, string>>;
123
144
  };
124
- /** MoonPay is reviewing. No request of its own: send `observe` after the delay. */
145
+ /**
146
+ * Sumsub must change the applicant before capture: move it to the capture level, or reset an expired
147
+ * proof of address. Send `prepareCapture` at once; the buyer types nothing.
148
+ */
149
+ export type MoonPayPrepareCaptureNextAction = {
150
+ next: 'prepareCapture';
151
+ };
152
+ /** Makes that change and answers `capture`. Needs `credentials`: the backend reads the customer. */
153
+ export type MoonPayPrepareCaptureRequest = {
154
+ action: 'prepareCapture';
155
+ credentials: MoonPaySdkCredentials;
156
+ };
157
+ /** A document the Sumsub SDK captures for MoonPay. No shared type names documents, so this one does. */
158
+ export type MoonPayCaptureDocument = 'IDENTITY_DOCUMENT' | 'SELFIE' | 'PROOF_OF_ADDRESS' | 'PROOF_OF_INCOME';
159
+ /** What a re-ask names: a declarative value by its `KycFieldId`, or a captured document. */
160
+ export type MoonPayReaskRequirement = KycFieldId | MoonPayCaptureDocument;
161
+ /**
162
+ * Why a re-ask asks again, as a code: the backend sends no display text, and the client owns every word.
163
+ * `EXPIRED`: the document on file is too old. `POOR_QUALITY`: the upload could not be read. `MISMATCH`: the
164
+ * data or the selfie does not match. `REJECTED`: any other retryable rejection. Treat an unknown code like
165
+ * `null`: adding a code is a minor contract change.
166
+ */
167
+ export type MoonPayReaskReason = 'EXPIRED' | 'POOR_QUALITY' | 'MISMATCH' | 'REJECTED';
168
+ /**
169
+ * Something the buyer gave before is asked again: `requirements`, never empty, on the `kyc` form or in the
170
+ * `capture`. One shape for every cause, so the client shows each the same way and may ignore `reason`
171
+ * (`null` when there is no code). Not `fieldErrors`: those check the value this request just submitted.
172
+ */
173
+ export type MoonPayReask = {
174
+ requirements: MoonPayReaskRequirement[];
175
+ reason: MoonPayReaskReason | null;
176
+ };
177
+ /**
178
+ * Open the Sumsub SDK with `accessToken` to capture what MoonPay still needs (an ID, a selfie, a
179
+ * proof of address). `reask` is `null` on a first capture; on a retake it names documents only. To refresh
180
+ * an expired token, send `observe`.
181
+ */
182
+ export type MoonPayCaptureNextAction = {
183
+ next: 'capture';
184
+ kycProvider: KYCProvider;
185
+ accessToken: string;
186
+ /** ISO-8601. */
187
+ expiresAt: string;
188
+ reask: MoonPayReask | null;
189
+ };
190
+ /** When the SDK closes. A report only: the backend reads Sumsub itself. */
191
+ export type MoonPayCaptureRequest = {
192
+ action: 'capture';
193
+ credentials: MoonPaySdkCredentials;
194
+ result: KycSdkResultReport;
195
+ };
196
+ /** MoonPay or Sumsub is reviewing. No request of its own: send `observe` after the delay. */
125
197
  export type MoonPayWaitNextAction = {
126
198
  next: 'wait';
127
199
  retryAfterMs: number;
@@ -143,13 +215,29 @@ export type MoonPayOrderRequest = {
143
215
  quotedAmount: FiatAmount;
144
216
  transactionId?: string;
145
217
  };
146
- export type MoonPayRequest = MoonPayRequestContext & (MoonPayObserveRequest | MoonPayConsentRequest | MoonPayConnectRequest | MoonPayKycRequest | MoonPayOrderRequest);
218
+ /**
219
+ * The charge is made or in flight and its order is not terminal yet. `order` is the order's current body
220
+ * (status, and the settlement transaction once observed) for the client to show, or `null` while MoonPay
221
+ * does not list or price the charge and no order exists yet. Do not mount Apple Pay. After `retryAfterMs`,
222
+ * send the same `order` request again: each one reads MoonPay and moves the order forward.
223
+ */
224
+ export type MoonPayOrderPendingNextAction = {
225
+ next: 'orderPending';
226
+ orderId: string;
227
+ retryAfterMs: number;
228
+ order: FiatStepResponse | null;
229
+ };
230
+ export type MoonPayRequest = MoonPayRequestContext & (MoonPayObserveRequest | MoonPayConsentRequest | MoonPaySessionRequest | MoonPayConnectRequest | MoonPayKycRequest | MoonPayPrepareCaptureRequest | MoonPayCaptureRequest | MoonPayOrderRequest);
147
231
  /** The wire body. The orchestrator reads `provider` and `geo`; MoonPay's action schemas read the rest. */
148
232
  export type MoonPayNextRequest = {
149
233
  provider: 'MOONPAY';
150
234
  geo: FiatGeo;
151
235
  } & MoonPayRequest;
152
- /** `REQUOTE` for `NOT_ELIGIBLE` and `DOCUMENTS_REQUIRED`, `NONE` for the others. */
236
+ /**
237
+ * Read `recovery`, never derive it from the reason. `NOT_ELIGIBLE` and `DOCUMENTS_REQUIRED` carry
238
+ * `REQUOTE` when another provider can serve the buyer, and `NONE` when a requote would only route
239
+ * back here (no verified email, or documents this flow cannot capture). The others are always `NONE`.
240
+ */
153
241
  export type MoonPayStepRefusal = 'NOT_ELIGIBLE' | 'DOCUMENTS_REQUIRED' | 'FINAL_REJECTION' | 'CUSTOMER_MISMATCH';
154
242
  /**
155
243
  * After a charge, always with `recovery: NONE`. `CUSTOMER_MISMATCH`: the transaction's customer is
@@ -157,8 +245,8 @@ export type MoonPayStepRefusal = 'NOT_ELIGIBLE' | 'DOCUMENTS_REQUIRED' | 'FINAL_
157
245
  * assertion's. `UNRECORDABLE`: a charge no retry can record, held for refund review.
158
246
  */
159
247
  export type MoonPayOrderRefusal = 'CUSTOMER_MISMATCH' | 'WALLET_MISMATCH' | 'UNRECORDABLE';
160
- export type MoonPayNextAction = MoonPayConsentNextAction | MoonPayConnectNextAction | MoonPayKycNextAction | MoonPayWaitNextAction | MoonPayOrderNextAction;
161
- /** `order` is the `GET /fiat/orders/:orderId` body; the shared order screen renders it. */
248
+ export type MoonPayNextAction = MoonPayConsentNextAction | MoonPaySessionNextAction | MoonPayConnectNextAction | MoonPayKycNextAction | MoonPayPrepareCaptureNextAction | MoonPayCaptureNextAction | MoonPayWaitNextAction | MoonPayOrderNextAction;
249
+ /** The order is terminal. `order` is its body, which the shared order screen renders; nothing is left to poll. */
162
250
  export type MoonPayDone = {
163
251
  next: 'done';
164
252
  order: FiatStepResponse;
@@ -169,28 +257,33 @@ export type MoonPayRefused<R, V> = {
169
257
  reason: R;
170
258
  recovery: V;
171
259
  };
172
- /** The answer to `observe`, `consent`, `connect` and `kyc`. */
260
+ /** The answer to `observe`, `consent`, `session`, `connect`, `kyc`, `prepareCapture` and `capture`. */
173
261
  export type MoonPayStepResponse = MoonPayNextAction | MoonPayRefused<MoonPayStepRefusal, 'REQUOTE' | 'NONE'>;
174
262
  /**
175
- * The answer to `order`. A failed charge is recorded too: `done` with the order in `FAILED`, and the
176
- * client requotes for a new `orderId`. `order` again while MoonPay does not list the transaction
177
- * yet. A refusal after a charge never requotes: that would start a second payment.
263
+ * The answer to `order`. `done` once the order is terminal. A failed charge is recorded too: `done` with
264
+ * the order in `FAILED`, and the client requotes for a new `orderId`. `orderPending` while the order is
265
+ * not terminal, or MoonPay does not list or price the transaction yet: the client polls by sending the
266
+ * same `order` request, never `GET /fiat/orders/:orderId`. A refusal after a charge never requotes:
267
+ * that would start a second payment.
178
268
  */
179
- export type MoonPayOrderResponse = MoonPayDone | MoonPayOrderNextAction | MoonPayRefused<MoonPayOrderRefusal, 'NONE'>;
269
+ export type MoonPayOrderResponse = MoonPayDone | MoonPayOrderNextAction | MoonPayOrderPendingNextAction | MoonPayRefused<MoonPayOrderRefusal, 'NONE'>;
180
270
  export type MoonPayResponseFor = {
181
271
  observe: MoonPayStepResponse;
182
272
  consent: MoonPayStepResponse;
273
+ session: MoonPayStepResponse;
183
274
  connect: MoonPayStepResponse;
184
275
  kyc: MoonPayStepResponse;
276
+ prepareCapture: MoonPayStepResponse;
277
+ capture: MoonPayStepResponse;
185
278
  order: MoonPayOrderResponse;
186
279
  };
187
280
  /** `RETRY` sends the same request again. `REQUOTE` goes back to routing. `NONE` ends the flow. */
188
281
  export type MoonPayRecovery = 'RETRY' | 'REQUOTE' | 'NONE';
189
282
  /**
190
- * `SESSION_BUDGET_SPENT`: the per-login SDK session mint budget (429). `RATE_LIMITED`: the action's
191
- * request budget (429). `PROVIDER_UNAVAILABLE`: MoonPay is down (503). `KYC_PROVIDER_UNAVAILABLE`:
192
- * the KYC provider (Sumsub) is down (503). `SERVICE_UNAVAILABLE`: one of Fun's own stores is down
193
- * (503). `INVALID_REQUEST`: a bad body (400).
283
+ * `SESSION_BUDGET_SPENT`: the per-login SDK session mint budget that `session` spends (429).
284
+ * `RATE_LIMITED`: the action's request budget (429). `PROVIDER_UNAVAILABLE`: MoonPay is down (503).
285
+ * `KYC_PROVIDER_UNAVAILABLE`: the KYC provider (Sumsub) is down (503). `SERVICE_UNAVAILABLE`: one of
286
+ * Fun's own stores is down (503). `INVALID_REQUEST`: a bad body (400).
194
287
  */
195
288
  export type MoonPayFaultReason = 'SESSION_BUDGET_SPENT' | 'RATE_LIMITED' | 'PROVIDER_UNAVAILABLE' | 'KYC_PROVIDER_UNAVAILABLE' | 'SERVICE_UNAVAILABLE' | 'INVALID_REQUEST';
196
289
  /** The fields a MoonPay fault adds to the shared error body. */
@@ -3,23 +3,34 @@
3
3
  * exported from the package root, never from `./moonpay`, so the production entry stays free of zod.
4
4
  */
5
5
  import { z } from 'zod';
6
- import type { MoonPayCheckout, MoonPayConnectNextAction, MoonPayConnectRequest, MoonPayConsentNextAction, MoonPayConsentRequest, MoonPayDone, MoonPayErrorBody, MoonPayFault, MoonPayKycNextAction, MoonPayKycRequest, MoonPayNextRequest, MoonPayObserveRequest, MoonPayOrderNextAction, MoonPayOrderRequest, MoonPayOrderResponse, MoonPayNextAction, MoonPayQuoteInput, MoonPayRequest, MoonPayRequestContext, MoonPayResponseFor, MoonPaySdkCredentials, MoonPayStepResponse, MoonPayWaitNextAction } from './moonpay';
6
+ import type { MoonPayCaptureDocument, MoonPayCaptureNextAction, MoonPayCaptureRequest, MoonPayCheckout, MoonPayConnectNextAction, MoonPayConnectRequest, MoonPayConsentNextAction, MoonPayConsentRequest, MoonPayDone, MoonPayErrorBody, MoonPayFault, MoonPayKycNextAction, MoonPayKycRequest, MoonPayNextRequest, MoonPayObserveRequest, MoonPayOrderNextAction, MoonPayOrderPendingNextAction, MoonPayOrderRequest, MoonPayOrderResponse, MoonPayPrepareCaptureNextAction, MoonPayPrepareCaptureRequest, MoonPayReask, MoonPayReaskReason, MoonPayReaskRequirement, MoonPayNextAction, MoonPayQuoteInput, MoonPayRequest, MoonPayRequestContext, MoonPayResponseFor, MoonPaySdkCredentials, MoonPaySessionNextAction, MoonPaySessionRequest, MoonPayStepResponse, MoonPayWaitNextAction } from './moonpay';
7
7
  export declare const MoonPayCheckoutSchema: z.ZodType<MoonPayCheckout>;
8
8
  export declare const MoonPaySdkCredentialsSchema: z.ZodType<MoonPaySdkCredentials>;
9
9
  export declare const MoonPayRequestContextSchema: z.ZodType<MoonPayRequestContext>;
10
10
  export declare const MoonPayQuoteInputSchema: z.ZodType<MoonPayQuoteInput>;
11
11
  export declare const MoonPayObserveRequestSchema: z.ZodType<MoonPayRequestContext & MoonPayObserveRequest>;
12
12
  export declare const MoonPayConsentRequestSchema: z.ZodType<MoonPayRequestContext & MoonPayConsentRequest>;
13
+ export declare const MoonPaySessionRequestSchema: z.ZodType<MoonPayRequestContext & MoonPaySessionRequest>;
13
14
  export declare const MoonPayConnectRequestSchema: z.ZodType<MoonPayRequestContext & MoonPayConnectRequest>;
14
15
  export declare const MoonPayKycRequestSchema: z.ZodType<MoonPayRequestContext & MoonPayKycRequest>;
16
+ export declare const MoonPayPrepareCaptureRequestSchema: z.ZodType<MoonPayRequestContext & MoonPayPrepareCaptureRequest>;
17
+ export declare const MoonPayCaptureRequestSchema: z.ZodType<MoonPayRequestContext & MoonPayCaptureRequest>;
15
18
  export declare const MoonPayOrderRequestSchema: z.ZodType<MoonPayRequestContext & MoonPayOrderRequest>;
16
19
  export declare const MoonPayRequestSchema: z.ZodType<MoonPayRequest>;
17
20
  export declare const MoonPayNextRequestSchema: z.ZodType<MoonPayNextRequest>;
18
21
  export declare const MoonPayConsentNextActionSchema: z.ZodType<MoonPayConsentNextAction>;
22
+ export declare const MoonPaySessionNextActionSchema: z.ZodType<MoonPaySessionNextAction>;
19
23
  export declare const MoonPayConnectNextActionSchema: z.ZodType<MoonPayConnectNextAction>;
20
24
  export declare const MoonPayKycNextActionSchema: z.ZodType<MoonPayKycNextAction>;
25
+ export declare const MoonPayPrepareCaptureNextActionSchema: z.ZodType<MoonPayPrepareCaptureNextAction>;
26
+ export declare const MoonPayCaptureDocumentSchema: z.ZodType<MoonPayCaptureDocument>;
27
+ export declare const MoonPayReaskRequirementSchema: z.ZodType<MoonPayReaskRequirement>;
28
+ export declare const MoonPayReaskReasonSchema: z.ZodType<MoonPayReaskReason>;
29
+ export declare const MoonPayReaskSchema: z.ZodType<MoonPayReask>;
30
+ export declare const MoonPayCaptureNextActionSchema: z.ZodType<MoonPayCaptureNextAction>;
21
31
  export declare const MoonPayWaitNextActionSchema: z.ZodType<MoonPayWaitNextAction>;
22
32
  export declare const MoonPayOrderNextActionSchema: z.ZodType<MoonPayOrderNextAction>;
33
+ export declare const MoonPayOrderPendingNextActionSchema: z.ZodType<MoonPayOrderPendingNextAction>;
23
34
  export declare const MoonPayNextActionSchema: z.ZodType<MoonPayNextAction>;
24
35
  export declare const MoonPayDoneSchema: z.ZodType<MoonPayDone>;
25
36
  export declare const MoonPayStepResponseSchema: z.ZodType<MoonPayStepResponse>;
package/dist/routing.d.ts CHANGED
@@ -56,22 +56,6 @@ export interface FiatRoutingTableRequest {
56
56
  /** Optional provider-specific inputs. */
57
57
  providers?: FiatRoutingTableProviderInputs;
58
58
  }
59
- /**
60
- * The query string of `GET /fiat/routing/table`, which `POST /fiat/routing/table` replaces.
61
- *
62
- * @deprecated Send a `FiatRoutingTableRequest` to `ROUTING_ENDPOINTS.table`. The GET route still
63
- * answers while clients move, with no provider inputs.
64
- */
65
- export interface FiatRoutingTableQuery {
66
- /** Defaults to `USD`. */
67
- fiatCurrencyCode?: FiatCurrencyCode;
68
- cryptoCurrencyCode: string;
69
- chainId: string;
70
- country: CountryCode;
71
- region?: string;
72
- /** Comma-separated `PaymentMethodCategory` values, for example `apple_pay,card`. */
73
- methods: string;
74
- }
75
59
  /** What a provider needs from this buyer before it can take the payment. */
76
60
  export type RoutingNextStep = 'READY' | 'AUTH' | 'DECLARATIVE_KYC' | 'DOCUMENTARY_KYC' | 'PENDING_REVIEW';
77
61
  /** How much past `next` the backend can see: the whole picture, part of it, or nothing before auth. */
package/dist/schemas.d.ts CHANGED
@@ -30,7 +30,7 @@ import { z } from 'zod';
30
30
  import type { UsStateCode } from './codes';
31
31
  import type { BlockedReason, CryptoAmount, FailureReason, FeeLine, FiatAmount, FiatEndpoint, FiatProvider, FiatStepResponse, FieldSpec, FlowState, FormDescriptor, FormField, FormFieldType, InstructionField, Instructions, Instrument, JsonValue, KYCProvider, KycReviewDuration, 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, FiatGeo, FiatNextRequest } from './types';
32
32
  import type { FiatTermsErrorBody, FiatTermsRequest, FiatTermsResponse, TermsDocument, TermsDocumentAcceptance } from './terms';
33
- import type { FiatRoutingQuoteErrorBody, FiatRoutingQuoteRequest, FiatRoutingQuoteTerms, FiatRoutingTableErrorBody, FiatRoutingTableQuery, FiatRoutingTableRequest, FiatRoutingTableResponse } from './routing';
33
+ import type { FiatRoutingQuoteErrorBody, FiatRoutingQuoteRequest, FiatRoutingQuoteTerms, FiatRoutingTableErrorBody, FiatRoutingTableRequest, FiatRoutingTableResponse } from './routing';
34
34
  export declare const JsonSchema: z.ZodType<JsonValue>;
35
35
  export declare const HTTP_VERBS: readonly ["GET", "POST"];
36
36
  /** `"POST /fiat/session/verify"`, `"GET /fiat/orders/o_31c"` — the verb rides the string. */
@@ -113,8 +113,6 @@ export declare const TermsDocumentAcceptanceSchema: z.ZodType<TermsDocumentAccep
113
113
  export declare const FiatTermsRequestSchema: z.ZodType<FiatTermsRequest>;
114
114
  export declare const FiatTermsResponseSchema: z.ZodType<FiatTermsResponse>;
115
115
  export declare const FiatTermsErrorBodySchema: z.ZodType<FiatTermsErrorBody>;
116
- /** @deprecated `GET /fiat/routing/table` is replaced by `POST /fiat/routing/table` (`FiatRoutingTableRequestSchema`). */
117
- export declare const FiatRoutingTableQuerySchema: z.ZodType<FiatRoutingTableQuery>;
118
116
  export declare const FiatRoutingTableRequestSchema: z.ZodType<FiatRoutingTableRequest>;
119
117
  export declare const FiatRoutingTableResponseSchema: z.ZodType<FiatRoutingTableResponse>;
120
118
  export declare const FiatRoutingQuoteTermsSchema: z.ZodType<FiatRoutingQuoteTerms>;
package/dist/table.js CHANGED
@@ -36,7 +36,7 @@ __export(table_exports, {
36
36
  module.exports = __toCommonJS(table_exports);
37
37
 
38
38
  // package.json
39
- var version = "0.31.0";
39
+ var version = "0.34.0";
40
40
 
41
41
  // src/table.ts
42
42
  var TABLE_VERSION = version;
package/dist/table.mjs CHANGED
@@ -11,7 +11,7 @@ import {
11
11
  tableEntry,
12
12
  unofferedEndpoints,
13
13
  unreachableStates
14
- } from "./chunk-UT4VI4ZA.mjs";
14
+ } from "./chunk-5ZGSYLC3.mjs";
15
15
  export {
16
16
  DOCUMENTED_ENDPOINTS,
17
17
  STATE_KEYS,
package/dist/terms.d.ts CHANGED
@@ -62,6 +62,8 @@ export interface FiatTermsErrorBody {
62
62
  }
63
63
  /** Each provider's current `CHECKOUT` documents, shown next to Continue on the amount screen. */
64
64
  export declare const PROVIDER_CHECKOUT_DOCUMENTS: Readonly<Partial<Record<FiatProvider, readonly TermsDocument[]>>>;
65
+ /** Each provider's current `KYC` documents, which its consent next action shows before the first KYC write. */
66
+ export declare const PROVIDER_KYC_DOCUMENTS: Readonly<Partial<Record<FiatProvider, readonly TermsDocument[]>>>;
65
67
  export type FunKycConsentLocale = 'en' | 'es' | 'fr' | 'ja' | 'ko' | 'ru' | 'tr' | 'zh';
66
68
  /** Fun's KYC consent, one digest per locale the KYC intro screen shows. It counts under any provider. */
67
69
  export declare const FUN_KYC_CONSENT_DOCUMENTS: Readonly<Record<FunKycConsentLocale, TermsDocument>>;
package/dist/terms.js CHANGED
@@ -23,11 +23,23 @@ __export(terms_exports, {
23
23
  FIAT_TERMS_ENDPOINT: () => FIAT_TERMS_ENDPOINT,
24
24
  FUN_KYC_CONSENT_DOCUMENTS: () => FUN_KYC_CONSENT_DOCUMENTS,
25
25
  PROVIDER_CHECKOUT_DOCUMENTS: () => PROVIDER_CHECKOUT_DOCUMENTS,
26
+ PROVIDER_KYC_DOCUMENTS: () => PROVIDER_KYC_DOCUMENTS,
26
27
  PUBLISHED_TERMS_DOCUMENTS: () => PUBLISHED_TERMS_DOCUMENTS
27
28
  });
28
29
  module.exports = __toCommonJS(terms_exports);
29
30
  var FIAT_TERMS_ENDPOINT = "POST /fiat/terms";
30
31
  var MOONPAY_TERMS = {
32
+ id: "MOONPAY_TERMS",
33
+ kind: "PROVIDER_TERMS",
34
+ stage: "CHECKOUT",
35
+ version: "moonpay-terms-2026-09",
36
+ contentDigest: "aab09ddd95a6fdd3f7c483e22833375a03c031d7379a3f60e09aa46ab4856d07",
37
+ links: [
38
+ { label: "MoonPay Terms of Use", url: "https://www.moonpay.com/legal/terms" },
39
+ { label: "MoonPay Privacy Policy", url: "https://www.moonpay.com/legal/privacy_policy" }
40
+ ]
41
+ };
42
+ var MOONPAY_TERMS_KYC_SHARING_V2 = {
31
43
  id: "MOONPAY_TERMS",
32
44
  kind: "PROVIDER_TERMS",
33
45
  stage: "CHECKOUT",
@@ -39,9 +51,20 @@ var MOONPAY_TERMS = {
39
51
  { label: "Persona Privacy Policy", url: "https://withpersona.com/legal/privacy-policy" }
40
52
  ]
41
53
  };
54
+ var MOONPAY_KYC_SHARING = {
55
+ id: "MOONPAY_KYC_SHARING",
56
+ kind: "PROVIDER_KYC_SHARING",
57
+ stage: "KYC",
58
+ version: "2026-09-l2-kyc-sharing-v3",
59
+ contentDigest: "fe587d7c6542a12070444ddb2e6ff0f2f6062b00ffc512cdb5c60438d355088e",
60
+ links: [{ label: "Persona Privacy Policy", url: "https://withpersona.com/legal/privacy-policy" }]
61
+ };
42
62
  var PROVIDER_CHECKOUT_DOCUMENTS = {
43
63
  MOONPAY: [MOONPAY_TERMS]
44
64
  };
65
+ var PROVIDER_KYC_DOCUMENTS = {
66
+ MOONPAY: [MOONPAY_KYC_SHARING]
67
+ };
45
68
  var funKycConsent = (contentDigest) => ({
46
69
  id: "FUN_KYC_CONSENT",
47
70
  kind: "FUN_KYC_COLLECTION",
@@ -60,4 +83,9 @@ var FUN_KYC_CONSENT_DOCUMENTS = {
60
83
  tr: funKycConsent("463040c3b58c922ecae2ae8262a78eb732bbcc5606c394723626378b3db2bbc3"),
61
84
  zh: funKycConsent("7f76d850adaf69783c5d9365e51abb5446f4e5778c63eabbdb4784d72464f855")
62
85
  };
63
- var PUBLISHED_TERMS_DOCUMENTS = [MOONPAY_TERMS, ...Object.values(FUN_KYC_CONSENT_DOCUMENTS)];
86
+ var PUBLISHED_TERMS_DOCUMENTS = [
87
+ MOONPAY_TERMS_KYC_SHARING_V2,
88
+ MOONPAY_TERMS,
89
+ MOONPAY_KYC_SHARING,
90
+ ...Object.values(FUN_KYC_CONSENT_DOCUMENTS)
91
+ ];
package/dist/terms.mjs CHANGED
@@ -2,11 +2,13 @@ import {
2
2
  FIAT_TERMS_ENDPOINT,
3
3
  FUN_KYC_CONSENT_DOCUMENTS,
4
4
  PROVIDER_CHECKOUT_DOCUMENTS,
5
+ PROVIDER_KYC_DOCUMENTS,
5
6
  PUBLISHED_TERMS_DOCUMENTS
6
- } from "./chunk-EFWIJWBC.mjs";
7
+ } from "./chunk-2CCO7UIS.mjs";
7
8
  export {
8
9
  FIAT_TERMS_ENDPOINT,
9
10
  FUN_KYC_CONSENT_DOCUMENTS,
10
11
  PROVIDER_CHECKOUT_DOCUMENTS,
12
+ PROVIDER_KYC_DOCUMENTS,
11
13
  PUBLISHED_TERMS_DOCUMENTS
12
14
  };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@fun-xyz/fiat-contract",
3
- "version": "0.31.0",
3
+ "version": "0.34.0",
4
4
  "description": "Published conformance contract for Fun's headless fiat onramp: FlowState/Transition types, zod schemas, the transition table as data, recorded fixtures, assertion helpers.",
5
5
  "license": "MIT",
6
6
  "repository": {