@peable.to/contracts 0.3.0 → 1.0.0

package/dist/cjs/resources/checkout/paymentLinks.js

@@ -0,0 +1,330 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.paymentLinkRoutes = exports.createPaymentLinkSessionParams = exports.listPaymentLinkLineItemsQuery = exports.listPaymentLinksQuery = exports.updatePaymentLinkParams = exports.createPaymentLinkParams = exports.linkLineItemParams = exports.paymentLinkSessionStartSchema = exports.publicPaymentLinkSchema = exports.paymentLinkSchema = exports.checkoutAfterCompletionSchema = void 0;
+const zod_1 = require("zod");
+const envelopes_1 = require("../../common/envelopes");
+const objects_1 = require("../../common/objects");
+const params_1 = require("../../common/params");
+const primitives_1 = require("../../common/primitives");
+const route_1 = require("../../route");
+const checkout_1 = require("../../vocabulary/checkout");
+const contributions_1 = require("./contributions");
+const shared_1 = require("./shared");
+/**
+ * Payment Links (`link_…`, Orbit Phase 3) — Stripe's model: a shareable URL
+ * over catalog PRICES. A payer visiting it creates a Checkout Session with the
+ * link's line items and options; the session creates the payment when the
+ * payer confirms. Nothing about a link mints a payment on its own.
+ *
+ * A contribution link (an Oxy organization's FairCoin collection) is a payment
+ * link whose one line is the contribution itself — a fixed amount, or one the
+ * payer chooses — rather than a price.
+ */
+exports.checkoutAfterCompletionSchema = (0, objects_1.defineComponent)('CheckoutAfterCompletion', zod_1.z
+    .object({
+    type: zod_1.z.enum(['redirect', 'hosted_confirmation']),
+    redirect: zod_1.z.object({ url: zod_1.z.string() }).strict().nullable(),
+    hosted_confirmation: zod_1.z.object({ custom_message: zod_1.z.string().nullable() }).strict().nullable(),
+})
+    .strict());
+const linkFields = {
+    id: zod_1.z.string(),
+    object: zod_1.z.literal('payment_link'),
+    livemode: primitives_1.livemode,
+    active: zod_1.z.boolean(),
+    currency: primitives_1.currency,
+    rail: shared_1.railSchema,
+    network: primitives_1.network.nullable(),
+    line_items: zod_1.z
+        .array(shared_1.checkoutLineItemSchema)
+        .describe("The link's prices (`GET /v1/payment_links/{id}/line_items` lists them in full)."),
+    contribution: contributions_1.contributionDetailsSchema
+        .optional()
+        .describe('Present on an organization contribution link (FairCoin).'),
+    locale: zod_1.z.enum(checkout_1.CHECKOUT_LOCALES).nullable(),
+};
+exports.paymentLinkSchema = (0, objects_1.defineObject)('payment_link', 'PaymentLink', zod_1.z
+    .object({
+    ...linkFields,
+    allow_promotion_codes: zod_1.z.boolean(),
+    ...shared_1.collectionResponseFields,
+    automatic_tax: zod_1.z.object({ enabled: zod_1.z.boolean() }).strict(),
+    customer_creation: zod_1.z.enum(checkout_1.CHECKOUT_CUSTOMER_CREATIONS),
+    after_completion: exports.checkoutAfterCompletionSchema,
+    restrictions: zod_1.z
+        .object({
+        completed_sessions: zod_1.z
+            .object({ limit: zod_1.z.number().int(), count: zod_1.z.number().int() })
+            .strict(),
+    })
+        .strict()
+        .nullable(),
+    submit_type: zod_1.z.enum(checkout_1.CHECKOUT_SUBMIT_TYPES),
+    metadata: primitives_1.metadata,
+    url: zod_1.z
+        .string()
+        .describe('`checkout.peable.to/l/<id>` — share it, or render it as a QR code.'),
+    created: primitives_1.unixSeconds,
+    updated_at: primitives_1.unixSeconds,
+})
+    .strict(), {
+    examples: [
+        {
+            id: 'link_0193b8f2c1a87d3e9f4a',
+            object: 'payment_link',
+            livemode: false,
+            active: true,
+            currency: 'EUR',
+            rail: 'card',
+            network: null,
+            line_items: [],
+            allow_promotion_codes: false,
+            billing_address_collection: 'auto',
+            shipping_address_collection: null,
+            phone_number_collection: { enabled: false },
+            tax_id_collection: { enabled: false },
+            custom_fields: [],
+            consent_collection: null,
+            automatic_tax: { enabled: false },
+            customer_creation: 'if_required',
+            after_completion: {
+                type: 'hosted_confirmation',
+                redirect: null,
+                hosted_confirmation: { custom_message: null },
+            },
+            restrictions: null,
+            submit_type: 'auto',
+            locale: null,
+            metadata: {},
+            url: 'https://checkout.peable.to/l/link_0193b8f2c1a87d3e9f4a',
+            created: 1793750400,
+            updated_at: 1793750400,
+        },
+    ],
+});
+/** What an anonymous visitor may see before checkout starts — no metadata, no counts. */
+exports.publicPaymentLinkSchema = (0, objects_1.defineComponent)('PublicPaymentLink', zod_1.z
+    .object({
+    ...linkFields,
+    contribution_amount: zod_1.z
+        .string()
+        .nullable()
+        .describe("A fixed contribution's amount; `null` when the payer chooses (or for a price link)."),
+    merchant: shared_1.merchantDisplaySchema,
+    branding: shared_1.checkoutBrandingSchema,
+})
+    .strict());
+/** `POST /v1/payment_links/{id}/checkout_sessions`' answer: the hosted session and the secret that opens it. */
+exports.paymentLinkSessionStartSchema = (0, objects_1.defineComponent)('PaymentLinkSessionStart', zod_1.z
+    .object({
+    object: zod_1.z.literal('checkout_session_start'),
+    id: zod_1.z.string().describe('The Checkout Session (`cs_…`).'),
+    client_secret: zod_1.z.string(),
+    url: zod_1.z.string().describe('The hosted checkout to send the payer to.'),
+})
+    .strict());
+// ---- Requests --------------------------------------------------------------------
+/** One `line_items[]` entry of a payment link — a catalog price only. */
+exports.linkLineItemParams = zod_1.z
+    .object({
+    price: shared_1.checkoutIdParam,
+    quantity: shared_1.quantityParam,
+    adjustable_quantity: shared_1.adjustableQuantityParam.optional(),
+})
+    .strict()
+    .superRefine((line, ctx) => (0, shared_1.adjustableIssues)(line.quantity, line.adjustable_quantity, ctx));
+const afterCompletionParams = zod_1.z
+    .object({
+    type: zod_1.z.enum(['redirect', 'hosted_confirmation']),
+    redirect: zod_1.z.object({ url: shared_1.redirectUrlParam }).strict().optional(),
+    hosted_confirmation: zod_1.z
+        .object({
+        custom_message: zod_1.z
+            .string()
+            .trim()
+            .min(1)
+            .max(checkout_1.PAYMENT_LINK_LIMITS.customMessageMax)
+            .optional(),
+    })
+        .strict()
+        .optional(),
+})
+    .strict()
+    .superRefine((value, ctx) => {
+    if (value.type === 'redirect' && !value.redirect) {
+        ctx.addIssue({ code: 'custom', path: ['redirect'], message: 'redirect.url is required' });
+    }
+    if (value.type === 'redirect' && value.hosted_confirmation) {
+        ctx.addIssue({
+            code: 'custom',
+            path: ['hosted_confirmation'],
+            message: 'hosted_confirmation is for type hosted_confirmation',
+        });
+    }
+    if (value.type === 'hosted_confirmation' && value.redirect) {
+        ctx.addIssue({
+            code: 'custom',
+            path: ['redirect'],
+            message: 'redirect is for type redirect',
+        });
+    }
+});
+const restrictionsParams = zod_1.z
+    .object({
+    completed_sessions: zod_1.z.object({ limit: zod_1.z.number().int().min(1).max(1000000) }).strict(),
+})
+    .strict();
+const optionParams = {
+    allow_promotion_codes: zod_1.z.boolean().optional(),
+    ...shared_1.collectionParams,
+    automatic_tax: zod_1.z.object({ enabled: zod_1.z.boolean() }).strict().optional(),
+    customer_creation: zod_1.z.enum(checkout_1.CHECKOUT_CUSTOMER_CREATIONS).optional(),
+    after_completion: afterCompletionParams.optional(),
+    submit_type: zod_1.z.enum(checkout_1.CHECKOUT_SUBMIT_TYPES).optional(),
+    locale: shared_1.localeParam.optional(),
+};
+/** `POST /v1/payment_links`: 1–20 one-time prices of ONE currency. */
+exports.createPaymentLinkParams = zod_1.z
+    .object({
+    line_items: zod_1.z.array(exports.linkLineItemParams).min(1).max(checkout_1.PAYMENT_LINK_LIMITS.lineItemsMax),
+    ...optionParams,
+    restrictions: restrictionsParams.optional(),
+    metadata: params_1.metadataCreateParam.optional(),
+    expand: params_1.expandParam.optional(),
+})
+    .strict();
+/**
+ * `POST /v1/payment_links/{id}` — everything but the line items, which are
+ * fixed once shared (a payer may hold a session priced from them). `""`
+ * clears; `metadata` is a patch.
+ */
+exports.updatePaymentLinkParams = zod_1.z
+    .object({
+    active: zod_1.z.boolean().optional(),
+    ...optionParams,
+    shipping_address_collection: zod_1.z
+        .union([shared_1.collectionParams.shipping_address_collection.unwrap(), zod_1.z.literal('')])
+        .optional(),
+    custom_fields: zod_1.z.union([shared_1.collectionParams.custom_fields.unwrap(), zod_1.z.literal('')]).optional(),
+    restrictions: zod_1.z.union([restrictionsParams, zod_1.z.literal('')]).optional(),
+    metadata: params_1.metadataUpdateParam.optional(),
+    expand: params_1.expandParam.optional(),
+})
+    .strict();
+exports.listPaymentLinksQuery = (0, params_1.listQuery)({ active: params_1.queryBoolean.optional() });
+/** A link's lines: a complete set of at most twenty (`has_more` is `false`). */
+exports.listPaymentLinkLineItemsQuery = (0, params_1.listQuery)({});
+/**
+ * `POST /v1/payment_links/{id}/checkout_sessions` — a payer starting checkout.
+ * A contribution link the payer prices takes `amount`; nothing else is the
+ * payer's to say.
+ */
+exports.createPaymentLinkSessionParams = zod_1.z
+    .object({
+    amount: zod_1.z
+        .string()
+        .refine((value) => contributions_1.contributionAmountSchema.safeParse(value).success, 'Enter a positive FairCoin base-unit amount within the supported range')
+        .optional()
+        .describe("A free contribution's amount, in FAIR base units."),
+})
+    .strict();
+const linkId = { id: 'The payment link (`link_…`).' };
+exports.paymentLinkRoutes = [
+    (0, route_1.defineRoute)({
+        operationId: 'createPaymentLink',
+        method: 'post',
+        path: '/v1/payment_links',
+        tag: 'Payment Links',
+        summary: 'Create a payment link',
+        auth: 'service',
+        scope: 'payments:write',
+        idempotent: true,
+        body: exports.createPaymentLinkParams,
+        response: exports.paymentLinkSchema,
+        status: 201,
+        sdk: 'paymentLinks.create',
+        expandable: 'payment_link',
+    }),
+    (0, route_1.defineRoute)({
+        operationId: 'listPaymentLinks',
+        method: 'get',
+        path: '/v1/payment_links',
+        tag: 'Payment Links',
+        summary: 'List payment links',
+        auth: 'service',
+        scope: 'payments:read',
+        query: exports.listPaymentLinksQuery,
+        response: (0, envelopes_1.listOf)(exports.paymentLinkSchema),
+        sdk: 'paymentLinks.list',
+        expandable: 'payment_link',
+    }),
+    (0, route_1.defineRoute)({
+        operationId: 'retrievePaymentLink',
+        method: 'get',
+        path: '/v1/payment_links/{id}',
+        tag: 'Payment Links',
+        summary: 'Retrieve a payment link',
+        auth: 'service',
+        scope: 'payments:read',
+        params: linkId,
+        query: params_1.expandOnlyQuery,
+        response: exports.paymentLinkSchema,
+        sdk: 'paymentLinks.retrieve',
+        expandable: 'payment_link',
+    }),
+    (0, route_1.defineRoute)({
+        operationId: 'updatePaymentLink',
+        method: 'post',
+        path: '/v1/payment_links/{id}',
+        tag: 'Payment Links',
+        summary: 'Update a payment link',
+        description: 'Everything but the line items. `""` clears a field; `metadata` is a patch.',
+        auth: 'service',
+        scope: 'payments:write',
+        idempotent: true,
+        params: linkId,
+        body: exports.updatePaymentLinkParams,
+        response: exports.paymentLinkSchema,
+        sdk: 'paymentLinks.update',
+        expandable: 'payment_link',
+    }),
+    (0, route_1.defineRoute)({
+        operationId: 'listPaymentLinkLineItems',
+        method: 'get',
+        path: '/v1/payment_links/{id}/line_items',
+        tag: 'Payment Links',
+        summary: "List a payment link's line items",
+        description: 'A complete set of at most twenty lines: `has_more` is always `false`.',
+        auth: 'service',
+        scope: 'payments:read',
+        params: linkId,
+        query: exports.listPaymentLinkLineItemsQuery,
+        response: (0, envelopes_1.listOf)(shared_1.checkoutLineItemSchema),
+        sdk: 'paymentLinks.listLineItems',
+        expandable: 'item',
+    }),
+    (0, route_1.defineRoute)({
+        operationId: 'retrievePaymentLinkPublic',
+        method: 'get',
+        path: '/v1/payment_links/{id}/public',
+        tag: 'Payment Links',
+        summary: 'Retrieve a payment link as a visitor',
+        description: 'Anonymous and rate-limited: what a visitor sees before checkout starts. An inactive (or expired contribution) link answers with `active: false`, so the page can say so.',
+        auth: 'public',
+        params: linkId,
+        response: exports.publicPaymentLinkSchema,
+    }),
+    (0, route_1.defineRoute)({
+        operationId: 'createPaymentLinkCheckoutSession',
+        method: 'post',
+        path: '/v1/payment_links/{id}/checkout_sessions',
+        tag: 'Payment Links',
+        summary: 'Start checkout from a payment link',
+        description: 'Anonymous and rate-limited. Creates a Checkout Session from the STORED link — never a payment. A contribution link requires a UUID `Idempotency-Key` header, written by the page before the request, so a lost answer recovers the same session.',
+        auth: 'public',
+        params: linkId,
+        body: exports.createPaymentLinkSessionParams,
+        response: exports.paymentLinkSessionStartSchema,
+        status: 201,
+    }),
+];

package/dist/cjs/resources/checkout/paymentMethodConfigurations.js

@@ -0,0 +1,262 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.paymentMethodConfigurationRoutes = exports.listPaymentMethodDomainsQuery = exports.validatePaymentMethodDomainParams = exports.updatePaymentMethodDomainParams = exports.createPaymentMethodDomainParams = exports.listPaymentMethodConfigurationsQuery = exports.updatePaymentMethodConfigurationParams = exports.createPaymentMethodConfigurationParams = exports.paymentMethodConfigurationEntryParams = exports.paymentMethodDomainSchema = exports.paymentMethodDomainWalletStatusSchema = exports.paymentMethodConfigurationSchema = exports.paymentMethodConfigurationEntrySchema = exports.paymentMethodDisplayPreferenceSchema = void 0;
+const zod_1 = require("zod");
+const envelopes_1 = require("../../common/envelopes");
+const objects_1 = require("../../common/objects");
+const params_1 = require("../../common/params");
+const primitives_1 = require("../../common/primitives");
+const route_1 = require("../../route");
+const paymentMethodConfigurations_1 = require("../../vocabulary/paymentMethodConfigurations");
+/**
+ * Payment method breadth on the card rail — which methods a merchant's payers
+ * are offered (`pmc_…`), and the web domains wallets may run on (`pmd_…`).
+ * Both are Orbit's objects; the provider's configuration and domain are
+ * bindings behind them (ADR 0016). Card data and bank credentials are entered
+ * in the provider's hosted fields and never reach Peable (PCI SAQ-A).
+ */
+/** The merchant's choice (`none`: Orbit's default) and what is in effect. */
+exports.paymentMethodDisplayPreferenceSchema = zod_1.z
+    .object({
+    preference: zod_1.z.enum(['on', 'off', 'none']),
+    value: zod_1.z.enum(['on', 'off']),
+})
+    .strict();
+exports.paymentMethodConfigurationEntrySchema = (0, objects_1.defineComponent)('PaymentMethodConfigurationEntry', zod_1.z
+    .object({
+    available: zod_1.z
+        .boolean()
+        .describe('Whether payers can be offered this method: it is on and nothing prevents it.'),
+    display_preference: exports.paymentMethodDisplayPreferenceSchema,
+    unavailable_reason: zod_1.z
+        .enum(paymentMethodConfigurations_1.PAYMENT_METHOD_UNAVAILABLE_REASONS)
+        .nullable()
+        .describe('Why it cannot be offered whatever the merchant chooses; `null` when it can.'),
+    currencies: zod_1.z.array(primitives_1.fiatCurrency).describe('The payment currencies it is offered on.'),
+})
+    .strict());
+const entryFields = Object.fromEntries(paymentMethodConfigurations_1.PAYMENT_METHOD_CONFIGURATION_TYPES.map((type) => [type, exports.paymentMethodConfigurationEntrySchema]));
+exports.paymentMethodConfigurationSchema = (0, objects_1.defineObject)('payment_method_configuration', 'PaymentMethodConfiguration', zod_1.z
+    .object({
+    id: zod_1.z.string(),
+    object: zod_1.z.literal('payment_method_configuration'),
+    livemode: primitives_1.livemode,
+    name: zod_1.z.string(),
+    active: zod_1.z
+        .boolean()
+        .describe('An inactive configuration cannot be named on a new PaymentIntent. The default is always active.'),
+    is_default: zod_1.z
+        .boolean()
+        .describe('The configuration a PaymentIntent uses when it names none. One per merchant.'),
+    created: primitives_1.unixSeconds,
+    updated_at: primitives_1.unixSeconds,
+    ...entryFields,
+})
+    .strict());
+/** A wallet's standing on one domain. */
+exports.paymentMethodDomainWalletStatusSchema = (0, objects_1.defineComponent)('PaymentMethodDomainWalletStatus', zod_1.z
+    .object({
+    status: zod_1.z
+        .enum(['active', 'inactive'])
+        .describe('`active`: the wallet can run on pages served from this domain.'),
+    status_details: zod_1.z
+        .object({ error_message: zod_1.z.string() })
+        .strict()
+        .nullable()
+        .describe("Present while `inactive`: what the wallet's verification said."),
+})
+    .strict());
+/**
+ * A web domain the merchant serves payment pages from (`pmd_…`), registered so
+ * Apple Pay and Google Pay run there. Peable's own hosted checkout needs none.
+ */
+exports.paymentMethodDomainSchema = (0, objects_1.defineObject)('payment_method_domain', 'PaymentMethodDomain', zod_1.z
+    .object({
+    id: zod_1.z.string(),
+    object: zod_1.z.literal('payment_method_domain'),
+    livemode: primitives_1.livemode,
+    domain_name: zod_1.z.string().describe('Lowercase hostname, no scheme, port or path.'),
+    enabled: zod_1.z.boolean().describe('Whether wallets may run on it at all.'),
+    apple_pay: exports.paymentMethodDomainWalletStatusSchema,
+    google_pay: exports.paymentMethodDomainWalletStatusSchema,
+    created: primitives_1.unixSeconds,
+})
+    .strict(), {
+    examples: [
+        {
+            id: 'pmd_0193b8f2c1a87d3e9f4a',
+            object: 'payment_method_domain',
+            livemode: false,
+            domain_name: 'shop.example.com',
+            enabled: true,
+            apple_pay: { status: 'active', status_details: null },
+            google_pay: { status: 'active', status_details: null },
+            created: 1793750400,
+        },
+    ],
+});
+/** One method's setting in a create or update. `none` returns it to Orbit's default. */
+exports.paymentMethodConfigurationEntryParams = zod_1.z
+    .object({
+    display_preference: zod_1.z.object({ preference: zod_1.z.enum(['on', 'off', 'none']) }).strict(),
+})
+    .strict();
+const methodParams = Object.fromEntries(paymentMethodConfigurations_1.PAYMENT_METHOD_CONFIGURATION_TYPES.map((type) => [
+    type,
+    exports.paymentMethodConfigurationEntryParams.optional(),
+]));
+/** `POST /v1/payment_method_configurations` — an additional, non-default configuration. */
+exports.createPaymentMethodConfigurationParams = zod_1.z
+    .object({ name: zod_1.z.string().min(1).max(100).optional(), ...methodParams })
+    .strict();
+/** `POST /v1/payment_method_configurations/{id}` — methods (merged), name, active. */
+exports.updatePaymentMethodConfigurationParams = zod_1.z
+    .object({
+    name: zod_1.z.string().min(1).max(100).optional(),
+    active: zod_1.z.boolean().optional(),
+    ...methodParams,
+})
+    .strict();
+exports.listPaymentMethodConfigurationsQuery = (0, params_1.listQuery)({});
+exports.createPaymentMethodDomainParams = zod_1.z
+    .object({ domain_name: zod_1.z.string().min(1).max(300), enabled: zod_1.z.boolean().optional() })
+    .strict();
+exports.updatePaymentMethodDomainParams = zod_1.z
+    .object({ enabled: zod_1.z.boolean().optional() })
+    .strict();
+/** The validate body: nothing. */
+exports.validatePaymentMethodDomainParams = zod_1.z.object({}).strict();
+exports.listPaymentMethodDomainsQuery = (0, params_1.listQuery)({
+    domain_name: zod_1.z.string().min(1).max(253).optional().describe('Exact match, any case.'),
+    enabled: params_1.queryBoolean.optional(),
+});
+const pmcId = { id: 'The configuration (`pmc_…`).' };
+const pmdId = { id: 'The domain (`pmd_…`).' };
+exports.paymentMethodConfigurationRoutes = [
+    (0, route_1.defineRoute)({
+        operationId: 'listPaymentMethodConfigurations',
+        method: 'get',
+        path: '/v1/payment_method_configurations',
+        tag: 'Payment method configurations',
+        summary: 'List payment method configurations',
+        description: 'The default configuration is created on first read.',
+        auth: 'service',
+        scope: 'payments:read',
+        query: exports.listPaymentMethodConfigurationsQuery,
+        response: (0, envelopes_1.listOf)(exports.paymentMethodConfigurationSchema),
+        sdk: 'paymentMethodConfigurations.list',
+        expandable: 'payment_method_configuration',
+    }),
+    (0, route_1.defineRoute)({
+        operationId: 'createPaymentMethodConfiguration',
+        method: 'post',
+        path: '/v1/payment_method_configurations',
+        tag: 'Payment method configurations',
+        summary: 'Create a payment method configuration',
+        description: 'An additional, non-default configuration. Turning `on` a method the processing provider does not offer is refused.',
+        auth: 'service',
+        scope: 'payments:write',
+        idempotent: true,
+        body: exports.createPaymentMethodConfigurationParams,
+        response: exports.paymentMethodConfigurationSchema,
+        sdk: 'paymentMethodConfigurations.create',
+    }),
+    (0, route_1.defineRoute)({
+        operationId: 'retrievePaymentMethodConfiguration',
+        method: 'get',
+        path: '/v1/payment_method_configurations/{id}',
+        tag: 'Payment method configurations',
+        summary: 'Retrieve a payment method configuration',
+        auth: 'service',
+        scope: 'payments:read',
+        params: pmcId,
+        query: params_1.expandOnlyQuery,
+        response: exports.paymentMethodConfigurationSchema,
+        sdk: 'paymentMethodConfigurations.retrieve',
+        expandable: 'payment_method_configuration',
+    }),
+    (0, route_1.defineRoute)({
+        operationId: 'updatePaymentMethodConfiguration',
+        method: 'post',
+        path: '/v1/payment_method_configurations/{id}',
+        tag: 'Payment method configurations',
+        summary: 'Update a payment method configuration',
+        description: 'Method settings are merged; the default configuration is always active.',
+        auth: 'service',
+        scope: 'payments:write',
+        idempotent: true,
+        params: pmcId,
+        body: exports.updatePaymentMethodConfigurationParams,
+        response: exports.paymentMethodConfigurationSchema,
+        sdk: 'paymentMethodConfigurations.update',
+    }),
+    (0, route_1.defineRoute)({
+        operationId: 'listPaymentMethodDomains',
+        method: 'get',
+        path: '/v1/payment_method_domains',
+        tag: 'Payment method domains',
+        summary: 'List payment method domains',
+        auth: 'service',
+        scope: 'payments:read',
+        query: exports.listPaymentMethodDomainsQuery,
+        response: (0, envelopes_1.listOf)(exports.paymentMethodDomainSchema),
+        sdk: 'paymentMethodDomains.list',
+        expandable: 'payment_method_domain',
+    }),
+    (0, route_1.defineRoute)({
+        operationId: 'createPaymentMethodDomain',
+        method: 'post',
+        path: '/v1/payment_method_domains',
+        tag: 'Payment method domains',
+        summary: 'Register a payment method domain',
+        auth: 'service',
+        scope: 'payments:write',
+        idempotent: true,
+        body: exports.createPaymentMethodDomainParams,
+        response: exports.paymentMethodDomainSchema,
+        sdk: 'paymentMethodDomains.create',
+    }),
+    (0, route_1.defineRoute)({
+        operationId: 'retrievePaymentMethodDomain',
+        method: 'get',
+        path: '/v1/payment_method_domains/{id}',
+        tag: 'Payment method domains',
+        summary: 'Retrieve a payment method domain',
+        auth: 'service',
+        scope: 'payments:read',
+        params: pmdId,
+        query: params_1.expandOnlyQuery,
+        response: exports.paymentMethodDomainSchema,
+        sdk: 'paymentMethodDomains.retrieve',
+        expandable: 'payment_method_domain',
+    }),
+    (0, route_1.defineRoute)({
+        operationId: 'updatePaymentMethodDomain',
+        method: 'post',
+        path: '/v1/payment_method_domains/{id}',
+        tag: 'Payment method domains',
+        summary: 'Update a payment method domain',
+        auth: 'service',
+        scope: 'payments:write',
+        idempotent: true,
+        params: pmdId,
+        body: exports.updatePaymentMethodDomainParams,
+        response: exports.paymentMethodDomainSchema,
+        sdk: 'paymentMethodDomains.update',
+    }),
+    (0, route_1.defineRoute)({
+        operationId: 'validatePaymentMethodDomain',
+        method: 'post',
+        path: '/v1/payment_method_domains/{id}/validate',
+        tag: 'Payment method domains',
+        summary: 'Validate a payment method domain',
+        description: "Re-runs the wallets' verification of the domain.",
+        auth: 'service',
+        scope: 'payments:write',
+        idempotent: true,
+        params: pmdId,
+        body: exports.validatePaymentMethodDomainParams,
+        response: exports.paymentMethodDomainSchema,
+        sdk: 'paymentMethodDomains.validate',
+    }),
+];