import {z} from 'zod' export type GetApiStatusApiKeyGetByMerchantTransactionIdMerchantTransactionIdArgs = {apiKey: string, merchantTransactionId: string}; export type GetApiStatusApiKeyGetByMerchantTransactionIdMerchantTransactionIdOptions = {baseUrl?: string | undefined, basicAuth?: {username: string, password: string} | undefined, fetch?: typeof fetch | undefined}; export const transactionStatus = z.enum(["SUCCESS", "PENDING", "REDIRECT", "CANCELLED", "ERROR"]); export const transactionType = z.enum(["DEBIT", "CAPTURE", "DEREGISTER", "PREAUTHORIZE", "REFUND", "REGISTER", "VOID", "CHARGEBACK", "CHARGEBACK-REVERSAL", "PAYOUT", "INCREMENTAL-AUTHORIZATION", "DISPUTE", "DISPUTE-REVERSAL"]); export const transactionSubType = z.enum(["cb-resolved", "cb-reversal-resolved"]); export const amount = z.string(); export const currency = z.string(); export const scheduleStatus = z.enum(["ACTIVE", "PAUSED", "CANCELLED", "ERROR", "CREATE-PENDING"]); export const dateTimeZone = z.string(); export const scheduleData = z.object({scheduleId: z.string().optional(), scheduleStatus: scheduleStatus.optional(), scheduledAt: dateTimeZone.optional(), merchantMetaData: z.string().optional()}); export const transactionError = z.object({message: z.string().optional(), code: z.number().int().optional(), adapterMessage: z.string().optional(), adapterCode: z.string().optional()}); export const transactionErrors = z.array(transactionError); export const transactionDisputeData = z.object({adapterDisputeId: z.string().optional(), status: z.string().optional(), reasonText: z.string().optional(), reasonCode: z.string().optional(), metaData: z.string().optional(), createdAt: dateTimeZone.optional(), modifiedAt: dateTimeZone.optional()}); export const chargebackData = z.object({originalUuid: z.string().optional(), originalMerchantTransactionId: z.string().min(1).max(50).optional(), amount: amount.optional(), currency: currency.optional(), reason: z.string().optional(), chargebackDateTime: dateTimeZone.optional(), disputeData: transactionDisputeData.optional()}); export const chargebackReversalData = z.object({originalUuid: z.string().optional(), originalMerchantTransactionId: z.string().min(1).max(50).optional(), chargebackUuid: z.string().optional(), amount: amount.optional(), currency: currency.optional(), reason: z.string().optional(), reversalDateTime: dateTimeZone.optional()}); export const extraData = z.record(z.string(), z.string()); export const country = z.string(); export const returnCardData = z.object({_TYPE: z.literal("cardData").optional(), type: z.string().optional(), firstName: z.string().optional(), lastName: z.string().optional(), country: country.optional(), cardHolder: z.string().optional(), expiryMonth: z.string().optional(), expiryYear: z.string().optional(), binDigits: z.string().optional(), firstSixDigits: z.string().optional(), lastFourDigits: z.string().optional(), fingerprint: z.string().optional(), binBrand: z.string().optional(), binBank: z.string().optional(), binType: z.string().optional(), binLevel: z.string().optional(), binCountry: z.string().optional(), binSegment: z.enum(["Consumer", "Business", "Commercial", "Government", "Unknown"]).optional(), binRawData: z.object({type: z.string().optional(), data: z.record(z.string(), z.unknown()).optional()}).optional(), threeDSecure: z.string().optional(), eci: z.string().optional(), merchantAdviceCode: z.string().optional(), parsedMerchantAdviceCode: z.string().optional(), schemeTransactionIdentifier: z.string().optional(), schemeLifecycleIdentifier: z.string().optional(), referenceSchemeLifecycleIdentifier: z.string().optional(), cardUpdateStatus: z.enum(["updated", "contact", "new-expiry", "closed"]).optional(), cardUpdatedAt: z.string().optional(), cardUpdatePausedUntil: z.string().optional()}); export const returnPhoneData = z.object({_TYPE: z.literal("phoneData").optional(), phoneNumber: z.string().optional(), country: country.optional(), operator: z.string().optional()}); export const date = z.string(); export const returnIbanData = z.object({_TYPE: z.literal("ibanData").optional(), accountOwner: z.string().optional(), iban: z.string().optional(), bic: z.string().optional(), mandateId: z.string().optional(), mandateDate: date.optional(), bankName: z.string().optional(), bankBranchName: z.string().optional(), country: country.optional()}); export const returnWalletData = z.object({_TYPE: z.literal("walletData").optional(), walletReferenceId: z.string().optional(), walletOwner: z.string().optional(), walletType: z.string().optional()}); export const returnData = z.discriminatedUnion("_TYPE", [returnCardData, returnPhoneData, returnIbanData, returnWalletData]); export const payByLinkData = z.object({payByLink: z.boolean().optional(), sendViaEmail: z.boolean().optional()}); export const ibanData = z.object({ibanData: z.object({iban: z.string().max(34).optional(), bic: z.string().max(11).optional(), mandateId: z.string().max(50).optional(), mandateDate: date.optional()}).optional()}); export const walletData = z.object({walletData: z.object({walletReferenceId: z.string().max(255).optional(), walletOwner: z.string().max(255).optional(), walletType: z.string().max(255).optional()}).optional()}); export const paymentData = z.union([ibanData, walletData]); export const customer = z.object({identification: z.string().max(36).optional(), firstName: z.string().max(50).optional(), lastName: z.string().max(50).optional(), birthDate: date.optional(), gender: z.enum(["M", "F"]).optional(), billingAddress1: z.string().max(50).optional(), billingAddress2: z.string().max(50).optional(), billingCity: z.string().max(50).optional(), billingPostcode: z.string().max(16).optional(), billingState: z.string().max(30).optional(), billingCountry: country.optional(), billingPhone: z.string().max(20).optional(), shippingFirstName: z.string().max(50).optional(), shippingLastName: z.string().max(50).optional(), shippingCompany: z.string().max(50).optional(), shippingAddress1: z.string().max(50).optional(), shippingAddress2: z.string().max(50).optional(), shippingCity: z.string().max(50).optional(), shippingPostcode: z.string().max(16).optional(), shippingState: z.string().max(30).optional(), shippingCountry: country.optional(), shippingPhone: z.string().max(20).optional(), company: z.string().max(50).optional(), email: z.string().max(255).optional(), emailVerified: z.boolean().optional(), ipAddress: z.string().max(50).optional(), nationalId: z.string().max(20).optional(), extraData: extraData.optional(), paymentData: paymentData.optional()}); export const customerProfileData = z.object({profileGuid: z.string().optional(), customerIdentification: z.string().max(36).optional(), paymentToken: z.string().optional(), markAsPreferred: z.boolean().optional()}); export const tracingData = z.object({transactions: z.array(z.object({uuid: z.string().optional(), sequence_number: z.string().optional(), status: z.string().optional(), connector: z.object({guid: z.string().optional(), adapter_name: z.string().optional(), brand: z.string().optional()}).optional()})).optional()}); export const statusResponse = z.object({success: z.boolean().optional(), transactionStatus: transactionStatus.optional(), uuid: z.string().optional(), merchantTransactionId: z.string().min(1).max(50).optional(), adapterMerchantTransactionId: z.string().min(1).max(64).optional(), purchaseId: z.string().optional(), transactionType: transactionType.optional(), transactionSubType: transactionSubType.optional(), paymentMethod: z.string().optional(), amount: amount.optional(), currency: currency.optional(), surchargeAmount: amount.optional(), totalAmount: amount.optional(), schedules: z.record(z.string(), scheduleData).optional(), errors: transactionErrors.optional(), chargebackData: chargebackData.optional(), chargebackReversalData: chargebackReversalData.optional(), extraData: extraData.optional(), merchantMetaData: z.string().optional(), returnData: returnData.optional(), payByLinkData: payByLinkData.optional(), customer: customer.optional(), customerProfileData: customerProfileData.optional(), tracingData: tracingData.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 }; /** * Retrieve status of a transaction * * GET /status/{apiKey}/getByMerchantTransactionId/{merchantTransactionId} */ export const getApiStatusApiKeyGetByMerchantTransactionIdMerchantTransactionId = async (args: GetApiStatusApiKeyGetByMerchantTransactionIdMerchantTransactionIdArgs, options?: GetApiStatusApiKeyGetByMerchantTransactionIdMerchantTransactionIdOptions) => { const {baseUrl = "https://gateway.tillpayments.com/api/v3", fetch: fetchFn = fetch, basicAuth} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/json") if (basicAuth !== undefined) headers.set('authorization', `Basic ${btoa(`${basicAuth.username}:${basicAuth.password}`)}`) const url = `${baseUrl.replace(/\/+$/, '')}/status/${encodeURIComponent(String(args.apiKey))}/getByMerchantTransactionId/${encodeURIComponent(String(args.merchantTransactionId))}${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(statusResponse, await res.json()) };