import {z} from 'zod' export type CreateApiMerchantsMerchantIdVerificationsArgs = {'Finix-Version'?: string | undefined, 'Content-Type'?: string | undefined, body: Record}; export type CreateApiMerchantsMerchantIdVerificationsOptions = {baseUrl?: string | undefined, BasicAuth?: {username: string, password: string} | undefined, fetch?: typeof fetch | undefined}; export const id = z.string().min(1); export const createdAt = z.string(); export const updatedAt = z.string(); export const applicationId = z.string().min(1); export const tags = z.record(z.string(), z.unknown()).nullable(); export const merchantVerification = z.object({id: id.optional(), created_at: createdAt.optional(), updated_at: updatedAt.optional(), application: applicationId.optional(), identity: z.string().nullable().optional(), merchant: z.string().optional(), merchant_identity: z.string().optional(), messages: z.array(z.string()).optional(), outcome_summary: z.string().nullable().optional(), outcomes: z.array(z.object({outcome_code: z.enum(["BANK_STATEMENT_ONE_MONTH_REQUESTED", "BANK_STATEMENT_THREE_MONTHS_REQUESTED", "BUSINESS_ADDRESS_DOCUMENT_REQUESTED", "BUSINESS_INCORPORATION_DOCUMENT_REQUESTED", "BUSINESS_REGISTRATION_DOCUMENT_REQUESTED", "BUSINESS_TAX_EXEMPTION_STATUS_DOCUMENT_REQUESTED", "BUSINESS_TAX_ID_DOCUMENT_REQUESTED", "INVALID_BANK_STATEMENT_ONE_MONTH", "INVALID_BANK_STATEMENT_THREE_MONTHS", "INVALID_BUSINESS_ADDRESS", "INVALID_BUSINESS_ADDRESS_DOCUMENT", "INVALID_BUSINESS_DBA", "INVALID_BUSINESS_DESCRIPTION", "INVALID_BUSINESS_INCORPORATION_DATE", "INVALID_BUSINESS_INCORPORATION_DOCUMENT", "INVALID_BUSINESS_MCC", "INVALID_BUSINESS_NAME", "INVALID_BUSINESS_OWNERSHIP_TYPE", "INVALID_BUSINESS_PHONE", "INVALID_BUSINESS_REGISTRATION_DOCUMENT", "INVALID_BUSINESS_TAX_EXEMPTION_STATUS_DOCUMENT", "INVALID_BUSINESS_TAX_ID", "INVALID_BUSINESS_TAX_ID_DOCUMENT", "INVALID_BUSINESS_TYPE", "INVALID_BUSINESS_WEBSITE", "INVALID_OWNER_ADDRESS", "INVALID_OWNER_BIRTHDATE", "INVALID_OWNER_EMAIL", "INVALID_OWNER_FIRST_NAME", "INVALID_OWNER_GOVERNMENT_ISSUED_PHOTO_ID", "INVALID_OWNER_LAST_NAME", "INVALID_OWNER_PHONE", "INVALID_OWNER_TAX_ID", "INVALID_OWNER_TAX_ID_DOCUMENT", "INVALID_OWNER_TITLE", "INVALID_PAYMENT_INSTRUMENT_ACCOUNT_NUMBER", "INVALID_PAYMENT_INSTRUMENT_BANK_CODE", "INVALID_PAYMENT_INSTRUMENT_NAME", "OWNER_GOVERNMENT_ISSUED_PHOTO_ID_REQUESTED", "OWNER_TAX_ID_DOCUMENT_REQUESTED", "PROCESSING_STATEMENT_REQUESTED"]).optional(), outcome_message: z.string().nullable().optional(), remediation_details: z.object({entity_id: z.string().optional(), entity_type: z.literal("IDENTITY").optional(), field_name: z.string().nullable().optional(), file_type: z.enum(["BANK_STATEMENT_ONE_MONTH", "BANK_STATEMENT_THREE_MONTHS", "BUSINESS_ADDRESS_DOCUMENT", "BUSINESS_INCORPORATION_DOCUMENT", "BUSINESS_REGISTRATION_DOCUMENT", "BUSINESS_TAX_EXEMPTION_STATUS_DOCUMENT", "BUSINESS_TAX_ID_DOCUMENT", "OWNER_GOVERNMENT_ISSUED_PHOTO_ID", "OWNER_TAX_ID_DOCUMENT", "PROCESSING_STATEMENT"]).nullable().optional(), type: z.enum(["FIELD_UPDATE", "FILE_UPLOAD"]).optional()}).nullable().optional()})).nullable().optional(), payment_instrument: z.string().nullable().optional(), payment_instrument_verification_details: z.object({pull_from_card_cross_border: z.string().nullable().optional(), pull_from_card_domestic: z.string().nullable().optional(), push_to_card_domestic: z.string().nullable().optional(), push_to_card_cross_border: z.string().nullable().optional(), card_type: z.string().nullable().optional(), billing_currency: z.string().nullable().optional(), issuer_country: z.string().nullable().optional(), name_verification_results: z.object({first_name: z.enum(["MATCH", "MATCHED", "NO_MATCH", "NOT_SUPPORTED", "PARTIAL_MATCH", "UNKNOWN"]).optional(), last_name: z.enum(["MATCH", "MATCHED", "NO_MATCH", "NOT_SUPPORTED", "PARTIAL_MATCH", "UNKNOWN"]).optional(), middle_name: z.enum(["MATCH", "MATCHED", "NO_MATCH", "NOT_SUPPORTED", "PARTIAL_MATCH", "UNKNOWN"]).optional(), name: z.enum(["MATCH", "MATCHED", "NO_MATCH", "NOT_SUPPORTED", "PARTIAL_MATCH", "UNKNOWN"]).optional()}).nullable().optional()}).optional(), processor: z.enum(["FINIX_V1", "DUMMY_V1"]).optional(), raw: z.union([z.array(z.object({description: z.string().optional(), outcome_code: z.string().optional(), remediation_item: z.string().optional()})).nullable(), z.object({}).nullable(), z.string().nullable()]).optional(), reverification_reason: z.object({initiated_by: z.string().nullable().optional(), reason_description: z.string().nullable().optional(), review_type: z.string().nullable().optional()}).nullable().optional(), state: z.enum(["PENDING", "FAILED", "SUCCEEDED"]).optional(), tags: tags.optional(), trace_id: z.string().optional(), type: z.literal("MERCHANT").optional(), sub_type: z.literal("CYBERSOURCE").nullable().optional(), _links: z.object({self: z.object({href: z.string().optional()}).optional(), merchant: z.object({href: z.string().optional()}).optional(), application: z.object({href: z.string().optional()}).optional()}).optional()}); export const validateResponse = async ( schema: { readonly '~standard': { readonly validate: (value: unknown) => ({ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray | undefined }> }) | Promise<{ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray | undefined }> }> } }, value: unknown ): Promise => { const result = await schema['~standard'].validate(value) if (result.issues !== undefined) { const detail = result.issues .map(({ message, path }) => path?.length ? `${path.map((segment) => String(typeof segment === 'object' ? segment.key : segment)).join('.')}: ${message}` : message ) .join('; ') throw new Error(`Response does not match the schema: ${detail}`, { cause: { issues: result.issues } }) } return result.value }; /** * Verify a Merchant * * POST /merchants/{merchant_id}/verifications */ export const createApiMerchantsMerchantIdVerifications = async (args: CreateApiMerchantsMerchantIdVerificationsArgs, options?: CreateApiMerchantsMerchantIdVerificationsOptions) => { const {baseUrl = "https://finix.sandbox-payments-api.com", fetch: fetchFn = fetch, BasicAuth} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('content-type', "application/json") headers.set('accept', "application/json") if (args['Finix-Version'] != null) headers.set("Finix-Version", String(args['Finix-Version'])) if (args['Content-Type'] != null) headers.set("Content-Type", String(args['Content-Type'])) if (BasicAuth !== undefined) headers.set('authorization', `Basic ${btoa(`${BasicAuth.username}:${BasicAuth.password}`)}`) const url = `${baseUrl.replace(/\/+$/, '')}/merchants/${encodeURIComponent(String(args.merchant_id))}/verifications${query.size > 0 ? `?${query}` : ''}` const res = await fetchFn(url, {method: "POST", headers, body: JSON.stringify(args.body)}) if (!res.ok) throw new Error(`Request failed with status ${res.status}`, {cause: {status: res.status, body: await res.text()}}) return validateResponse(merchantVerification, await res.json()) };