import {z} from 'zod' export type SchemasOffsetToken = string; export type GetApi3dsArgs = {offsetToken?: SchemasOffsetToken | undefined, sortOrder?: ('asc' | 'desc') | undefined, limit?: number | undefined}; export type GetApi3dsOptions = {baseUrl?: string | undefined, ApiKey?: {username: string, password: string} | undefined, fetch?: typeof fetch | undefined}; export const schemasOffsetToken = z.string(); export const threedsKey = z.string(); export const schemasAcceptorKey = z.string().min(5).max(120); export const version = z.number().int(); export const schemasAcceptorRef = z.object({key: schemasAcceptorKey, version: version}); export const merchantInfoResponse = z.object({acquirerBin: z.string().min(6).max(11).optional(), merchantId: z.string().min(1).max(20), mcc: z.string().min(4).max(4), merchantName: z.string(), merchantCountryCode: z.object({alpha3: z.string(), alpha2: z.string(), numeric: z.string()}), websiteUrl: z.string().max(2048), network: z.enum(["american-express", "bancontact", "diners", "mastercard", "visa"])}); export const amountValue = z.number().int().gte(0).lte(999999999999); export const schemasCurrencyCode = z.string(); export const amount = z.object({value: amountValue, currency: schemasCurrencyCode}); export const unknownAmount = z.object({value: z.literal(-1), currency: z.literal("unknown")}); export const responseAmount = z.union([amount, unknownAmount]); export const authenticationNetwork = z.enum(["american-express", "bancontact", "diners", "mastercard", "visa", "unknown"]); export const protocolVersion = z.enum(["2.1.0", "2.2.0"]); export const deviceChannel = z.enum(["browser", "app", "3ri"]); export const frictionlessFlow = z.literal("frictionless"); export const frictionlessResult = z.literal("authenticated"); export const activeProtocolVersion = z.literal("2.2.0"); export const sdkTransID = z.string(); export const messageExtension = z.object({name: z.string().min(1).max(64), id: z.string().min(1).max(64), criticalityIndicator: z.boolean(), data: z.unknown()}); export const messageExtensionList = z.array(messageExtension); export const dsTransID = z.string(); export const acsTransID = z.string(); export const transStatus = z.enum(["Y", "N", "U", "A", "C", "D", "R", "I"]); export const transStatusReason = z.string(); export const threeDSServerTransID = z.string(); export const cardHolderInfo = z.string(); export const acsChallengeMandated = z.string(); export const dsReferenceNumber = z.string(); export const acsReferenceNumber = z.string(); export const acsOperatorID = z.string(); export const acsDecConInd = z.string(); export const acsRenderingType = z.object({acsInterface: z.string(), acsUiTemplate: z.string()}); export const acsUrl = z.string(); export const authenticationType = z.string(); export const eci = z.string(); export const whiteListStatus = z.string(); export const whiteListStatusSource = z.string(); export const acsSignedContent = z.string().min(1).max(2560); export const aResWithoutAuthValue = z.object({messageVersion: activeProtocolVersion, sdkTransID: sdkTransID.optional(), messageExtension: messageExtensionList.optional(), messageType: z.literal("ARes"), dsTransID: dsTransID, acsTransID: acsTransID, transStatus: transStatus, transStatusReason: transStatusReason.optional(), threeDSServerTransID: threeDSServerTransID, cardholderInfo: cardHolderInfo.optional(), acsChallengeMandated: acsChallengeMandated.optional(), dsReferenceNumber: dsReferenceNumber, acsReferenceNumber: acsReferenceNumber, acsOperatorID: acsOperatorID.optional(), acsDecConInd: acsDecConInd.optional(), acsRenderingType: acsRenderingType.optional(), acsURL: acsUrl.optional(), authenticationType: authenticationType.optional(), eci: eci.optional(), whiteListStatus: whiteListStatus.optional(), whiteListStatusSource: whiteListStatusSource.optional(), acsSignedContent: acsSignedContent.optional()}); export const transactionReference = z.string().min(1).max(120); export const order = z.enum(["checkout", "unspecified", "one-click", "recurring", "ucof", "installment", "standing-order"]); export const intent = z.enum(["purchase", "reservation", "account-status", "payout", "payout-status", "funding", "advice", "refund"]); export const schemasCreated = z.string(); export const threeDsFrictionlessAuthenticatedWithoutAuthValue = z.object({key: threedsKey, merchantAcceptorRef: schemasAcceptorRef.optional(), merchantInfo: merchantInfoResponse.optional(), amount: responseAmount, network: authenticationNetwork, protocolVersion: protocolVersion, deviceChannel: deviceChannel, flow: frictionlessFlow, result: frictionlessResult, ares: aResWithoutAuthValue, transactionReference: transactionReference.optional(), type: z.object({order: order.optional(), intent: intent.optional()}).optional(), created: schemasCreated, version: version}); export const authenticationValue = z.string(); export const aRes = z.object({messageVersion: activeProtocolVersion, sdkTransID: sdkTransID.optional(), messageExtension: messageExtensionList.optional(), messageType: z.literal("ARes"), dsTransID: dsTransID, acsTransID: acsTransID, transStatus: transStatus, transStatusReason: transStatusReason.optional(), threeDSServerTransID: threeDSServerTransID, cardholderInfo: cardHolderInfo.optional(), acsChallengeMandated: acsChallengeMandated.optional(), dsReferenceNumber: dsReferenceNumber, acsReferenceNumber: acsReferenceNumber, acsOperatorID: acsOperatorID.optional(), acsDecConInd: acsDecConInd.optional(), acsRenderingType: acsRenderingType.optional(), acsURL: acsUrl.optional(), authenticationType: authenticationType.optional(), eci: eci.optional(), whiteListStatus: whiteListStatus.optional(), whiteListStatusSource: whiteListStatusSource.optional(), acsSignedContent: acsSignedContent.optional(), authenticationValue: authenticationValue.optional()}); export const threeDsChallenge = z.object({key: threedsKey, merchantAcceptorRef: schemasAcceptorRef.optional(), merchantInfo: merchantInfoResponse.optional(), amount: responseAmount, network: authenticationNetwork, protocolVersion: protocolVersion, deviceChannel: deviceChannel, flow: z.literal("challenge"), result: z.literal("challenge"), ares: aRes, transactionReference: transactionReference.optional(), type: z.object({order: order.optional(), intent: intent.optional()}).optional(), created: schemasCreated, version: version}); export const challengeFlow = z.literal("challenge"); export const challengeResult = z.enum(["authenticated", "non-authenticated"]); export const authenticationMethod = z.string(); export const challengeCancel = z.string(); export const interactionCounter = z.string(); export const messageCategory = z.string(); export const rReqWithoutAuthValue = z.object({messageVersion: activeProtocolVersion, sdkTransID: sdkTransID.optional(), messageExtension: messageExtensionList.optional(), messageType: z.literal("RReq"), acsTransID: acsTransID, acsRenderingType: acsRenderingType.optional(), authenticationMethod: authenticationMethod.optional(), authenticationType: authenticationType.optional(), challengeCancel: challengeCancel.optional(), dsTransID: dsTransID, eci: eci.optional(), interactionCounter: interactionCounter, messageCategory: messageCategory, transStatus: transStatus, transStatusReason: transStatusReason.optional(), threeDSServerTransID: threeDSServerTransID, whiteListStatus: whiteListStatus.optional(), whiteListStatusSource: whiteListStatusSource.optional()}); export const fraudLiability = z.enum(["acquirer", "issuer"]); export const schemasLastModified = z.string(); export const threeDsChallengeFinishedWithoutAuthValue = z.object({key: threedsKey, merchantAcceptorRef: schemasAcceptorRef.optional(), merchantInfo: merchantInfoResponse.optional(), amount: responseAmount, network: authenticationNetwork, protocolVersion: protocolVersion, deviceChannel: deviceChannel, flow: challengeFlow, result: challengeResult, ares: aResWithoutAuthValue, rreq: rReqWithoutAuthValue, transactionReference: transactionReference.optional(), fraudLiability: fraudLiability.optional(), type: z.object({order: order.optional(), intent: intent.optional()}).optional(), created: schemasCreated, lastModified: schemasLastModified, version: version}); export const noAuthFlow = z.literal("none"); export const noAuthResult = z.enum(["attempt", "non-authenticated"]); export const threeDsNoFlowNoAuthWithoutAuthValue = z.object({key: threedsKey, merchantAcceptorRef: schemasAcceptorRef.optional(), merchantInfo: merchantInfoResponse.optional(), amount: responseAmount, network: authenticationNetwork, protocolVersion: protocolVersion, deviceChannel: deviceChannel, flow: noAuthFlow, result: noAuthResult, ares: aResWithoutAuthValue, transactionReference: transactionReference.optional(), type: z.object({order: order.optional(), intent: intent.optional()}).optional(), created: schemasCreated, version: version}); export const result = z.enum(["authenticated", "non-authenticated"]); export const threeRiTransStatus = z.enum(["Y", "N", "R"]); export const threeRiAResWithoutAuthenticationValue = z.object({threeDSServerTransID: threeDSServerTransID, messageExtension: messageExtensionList.optional(), messageType: z.literal("ARes"), dsTransID: dsTransID, acsTransID: acsTransID, transStatus: threeRiTransStatus, messageVersion: z.literal("2.2.0"), transStatusReason: transStatusReason.optional(), cardholderInfo: cardHolderInfo.optional(), acsChallengeMandated: acsChallengeMandated.optional(), dsReferenceNumber: dsReferenceNumber, acsReferenceNumber: acsReferenceNumber, acsOperatorID: acsOperatorID.optional(), acsDecConInd: acsDecConInd.optional(), authenticationType: authenticationType.optional(), eci: eci.optional(), whiteListStatus: whiteListStatus.optional(), whiteListStatusSource: whiteListStatusSource.optional()}); export const threeRiResponseWithoutAuthenticationValue = z.object({key: threedsKey, merchantAcceptorRef: schemasAcceptorRef.optional(), merchantInfo: merchantInfoResponse.optional(), amount: responseAmount, network: authenticationNetwork, protocolVersion: z.literal("2.2.0"), deviceChannel: z.literal("3ri"), result: result, ares: threeRiAResWithoutAuthenticationValue, transactionReference: transactionReference.optional(), fraudLiability: fraudLiability, created: schemasCreated, version: version}); export const dataOnlyResult = z.literal("informational"); export const threeDsDataOnly = z.object({key: threedsKey, merchantAcceptorRef: schemasAcceptorRef.optional(), merchantInfo: merchantInfoResponse.optional(), amount: responseAmount, network: authenticationNetwork, protocolVersion: protocolVersion, deviceChannel: deviceChannel, flow: z.literal("none"), result: dataOnlyResult, ares: aRes, transactionReference: transactionReference.optional(), fraudLiability: fraudLiability.optional(), type: z.object({order: order.optional(), intent: intent.optional()}).optional(), created: schemasCreated, version: version}); export const threeDsPageEntity = z.union([threeDsFrictionlessAuthenticatedWithoutAuthValue, threeDsChallenge, threeDsChallengeFinishedWithoutAuthValue, threeDsNoFlowNoAuthWithoutAuthValue, threeRiResponseWithoutAuthenticationValue, threeDsDataOnly]); export const threeDsPage = z.object({offsetToken: schemasOffsetToken.optional(), threeDss: z.array(threeDsPageEntity)}); 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 }; /** * List 3DS Authentications * * GET /3ds * * Also accepts auth: BearerToken */ export const getApi3ds = async (args: GetApi3dsArgs, options?: GetApi3dsOptions) => { const {baseUrl = "https://eu-west-1.api.silverflow.com/v1", fetch: fetchFn = fetch, ApiKey} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/json") if (args.offsetToken != null) query.append("offsetToken", String(args.offsetToken)) if (args.sortOrder != null) query.append("sortOrder", String(args.sortOrder)) if (args.limit != null) query.append("limit", String(args.limit)) if (ApiKey !== undefined) headers.set('authorization', `Basic ${btoa(`${ApiKey.username}:${ApiKey.password}`)}`) const url = `${baseUrl.replace(/\/+$/, '')}/3ds${query.size > 0 ? `?${query}` : ''}` const res = await fetchFn(url, {method: "GET", headers}) if (!res.ok) throw new Error(`Request failed with status ${res.status}`, {cause: {status: res.status, body: await res.text()}}) return validateResponse(threeDsPage, await res.json()) };