import {z} from 'zod' export type GetApiTransactionsTransactionIdOptions = {baseUrl?: string | undefined, oauth2?: string | undefined, fetch?: typeof fetch | undefined}; export const registeredDevice = z.object({external_device_id: z.string().optional(), ip_address_v4: z.string().optional(), ip_address_v6: z.string().optional()}); export const linkedTransactions = z.union([z.object({external_transaction_id: z.string(), transaction_token: z.string().optional(), reason: z.string()}), z.object({external_transaction_id: z.string().optional(), transaction_token: z.string(), reason: z.string()})]); export const eventTransactionBody = z.object({external_transaction_id: z.string().optional(), amount: z.number().int().optional(), currency: z.string().optional(), entity_token: z.string().optional(), external_entity_id: z.string().optional(), external_account_id: z.string().optional(), external_session_id: z.string().max(256).nullable().optional(), counterparty: z.union([z.object({external_counterparty_id: z.string().optional(), name_first: z.string().optional(), name_last: z.string().optional(), routing_number: z.string().optional(), account_number: z.string(), counterparty_type: z.string().optional(), account_name: z.string().optional(), address_line_1: z.string().optional(), address_line_2: z.string().optional(), address_city: z.string().optional(), address_state: z.string().optional(), address_postal_code: z.string().optional(), address_country_code: z.string().optional(), card_network: z.string().optional(), merchant_category_code: z.string().optional(), name_on_card: z.string().optional(), avs: z.string().optional(), description: z.string().optional(), merchant_category_description: z.string().optional(), currency: z.string().optional(), identity: z.object({external_counterparty_identity_id: z.string().min(1).max(256), type: z.enum(["person", "business", "merchant", "customer"]).nullable().optional(), identity_name: z.string().nullable().optional(), name_first: z.string().nullable().optional(), name_last: z.string().nullable().optional(), birth_date: z.string().nullable().optional(), email: z.string().nullable().optional(), phone: z.string().nullable().optional(), tax_id: z.string().nullable().optional(), merchant_identifier: z.string().nullable().optional(), merchant_category_code: z.string().nullable().optional(), mcc_description: z.string().nullable().optional(), dba_name: z.string().nullable().optional(), address_line_1: z.string().nullable().optional(), address_line_2: z.string().nullable().optional(), address_city: z.string().nullable().optional(), address_state: z.string().nullable().optional(), address_postal_code: z.string().nullable().optional(), address_country_code: z.string().nullable().optional(), entity_token: z.string().nullable().optional(), external_entity_id: z.string().max(65535).nullable().optional(), external_entity_id_source: z.string().min(1).max(100).nullable().optional(), device: registeredDevice.nullable().optional()}).nullable().optional(), instrument: z.object({external_instrument_id: z.string().min(1).max(256), instrument_type: z.enum(["bank_account", "card", "digital_wallet", "other"]), routing_number: z.string().nullable().optional(), routing_number_type: z.string().nullable().optional(), account_number: z.string().nullable().optional(), account_number_last4: z.string().nullable().optional(), account_holder_name: z.string().nullable().optional(), account_type: z.enum(["checking", "savings", "deposit", "credit", "other"]).nullable().optional(), country_code: z.string().nullable().optional(), card_bin: z.string().nullable().optional(), card_last4: z.string().nullable().optional(), card_network: z.string().nullable().optional(), form_factor: z.enum(["physical", "virtual"]).nullable().optional(), name_on_card: z.string().nullable().optional(), expiration_month: z.string().nullable().optional(), expiration_year: z.string().nullable().optional(), avs: z.string().nullable().optional(), wallet_provider: z.string().nullable().optional(), wallet_identifier: z.string().nullable().optional(), check_number: z.string().nullable().optional(), payee_name_raw: z.string().nullable().optional(), currency: z.string().max(3).nullable().optional()}).nullable().optional()}), z.object({external_counterparty_id: z.string(), name_first: z.string().optional(), name_last: z.string().optional(), routing_number: z.string().optional(), account_number: z.string().optional(), counterparty_type: z.string().optional(), account_name: z.string().optional(), address_line_1: z.string().optional(), address_line_2: z.string().optional(), address_city: z.string().optional(), address_state: z.string().optional(), address_postal_code: z.string().optional(), address_country_code: z.string().optional(), card_network: z.string().optional(), merchant_category_code: z.string().optional(), name_on_card: z.string().optional(), avs: z.string().optional(), description: z.string().optional(), merchant_category_description: z.string().optional(), currency: z.string().optional(), identity: z.object({external_counterparty_identity_id: z.string().min(1).max(256), type: z.enum(["person", "business", "merchant", "customer"]).nullable().optional(), identity_name: z.string().nullable().optional(), name_first: z.string().nullable().optional(), name_last: z.string().nullable().optional(), birth_date: z.string().nullable().optional(), email: z.string().nullable().optional(), phone: z.string().nullable().optional(), tax_id: z.string().nullable().optional(), merchant_identifier: z.string().nullable().optional(), merchant_category_code: z.string().nullable().optional(), mcc_description: z.string().nullable().optional(), dba_name: z.string().nullable().optional(), address_line_1: z.string().nullable().optional(), address_line_2: z.string().nullable().optional(), address_city: z.string().nullable().optional(), address_state: z.string().nullable().optional(), address_postal_code: z.string().nullable().optional(), address_country_code: z.string().nullable().optional(), entity_token: z.string().nullable().optional(), external_entity_id: z.string().max(65535).nullable().optional(), external_entity_id_source: z.string().min(1).max(100).nullable().optional(), device: registeredDevice.nullable().optional()}).nullable().optional(), instrument: z.object({external_instrument_id: z.string().min(1).max(256), instrument_type: z.enum(["bank_account", "card", "digital_wallet", "other"]), routing_number: z.string().nullable().optional(), routing_number_type: z.string().nullable().optional(), account_number: z.string().nullable().optional(), account_number_last4: z.string().nullable().optional(), account_holder_name: z.string().nullable().optional(), account_type: z.enum(["checking", "savings", "deposit", "credit", "other"]).nullable().optional(), country_code: z.string().nullable().optional(), card_bin: z.string().nullable().optional(), card_last4: z.string().nullable().optional(), card_network: z.string().nullable().optional(), form_factor: z.enum(["physical", "virtual"]).nullable().optional(), name_on_card: z.string().nullable().optional(), expiration_month: z.string().nullable().optional(), expiration_year: z.string().nullable().optional(), avs: z.string().nullable().optional(), wallet_provider: z.string().nullable().optional(), wallet_identifier: z.string().nullable().optional(), check_number: z.string().nullable().optional(), payee_name_raw: z.string().nullable().optional(), currency: z.string().max(3).nullable().optional()}).nullable().optional()}), z.object({external_counterparty_id: z.string().optional(), name_first: z.string().optional(), name_last: z.string().optional(), routing_number: z.string().optional(), account_number: z.string().optional(), counterparty_type: z.string().optional(), account_name: z.string().optional(), address_line_1: z.string().optional(), address_line_2: z.string().optional(), address_city: z.string().optional(), address_state: z.string().optional(), address_postal_code: z.string().optional(), address_country_code: z.string().optional(), card_network: z.string().optional(), merchant_category_code: z.string().optional(), name_on_card: z.string().optional(), avs: z.string().optional(), description: z.string().optional(), merchant_category_description: z.string().optional(), currency: z.string().optional(), identity: z.object({external_counterparty_identity_id: z.string().min(1).max(256), type: z.enum(["person", "business", "merchant", "customer"]).nullable().optional(), identity_name: z.string().nullable().optional(), name_first: z.string().nullable().optional(), name_last: z.string().nullable().optional(), birth_date: z.string().nullable().optional(), email: z.string().nullable().optional(), phone: z.string().nullable().optional(), tax_id: z.string().nullable().optional(), merchant_identifier: z.string().nullable().optional(), merchant_category_code: z.string().nullable().optional(), mcc_description: z.string().nullable().optional(), dba_name: z.string().nullable().optional(), address_line_1: z.string().nullable().optional(), address_line_2: z.string().nullable().optional(), address_city: z.string().nullable().optional(), address_state: z.string().nullable().optional(), address_postal_code: z.string().nullable().optional(), address_country_code: z.string().nullable().optional(), entity_token: z.string().nullable().optional(), external_entity_id: z.string().max(65535).nullable().optional(), external_entity_id_source: z.string().min(1).max(100).nullable().optional(), device: registeredDevice.nullable().optional()}).nullable(), instrument: z.object({external_instrument_id: z.string().min(1).max(256), instrument_type: z.enum(["bank_account", "card", "digital_wallet", "other"]), routing_number: z.string().nullable().optional(), routing_number_type: z.string().nullable().optional(), account_number: z.string().nullable().optional(), account_number_last4: z.string().nullable().optional(), account_holder_name: z.string().nullable().optional(), account_type: z.enum(["checking", "savings", "deposit", "credit", "other"]).nullable().optional(), country_code: z.string().nullable().optional(), card_bin: z.string().nullable().optional(), card_last4: z.string().nullable().optional(), card_network: z.string().nullable().optional(), form_factor: z.enum(["physical", "virtual"]).nullable().optional(), name_on_card: z.string().nullable().optional(), expiration_month: z.string().nullable().optional(), expiration_year: z.string().nullable().optional(), avs: z.string().nullable().optional(), wallet_provider: z.string().nullable().optional(), wallet_identifier: z.string().nullable().optional(), check_number: z.string().nullable().optional(), payee_name_raw: z.string().nullable().optional(), currency: z.string().max(3).nullable().optional()}).nullable().optional()}), z.object({external_counterparty_id: z.string().optional(), name_first: z.string().optional(), name_last: z.string().optional(), routing_number: z.string().optional(), account_number: z.string().optional(), counterparty_type: z.string().optional(), account_name: z.string().optional(), address_line_1: z.string().optional(), address_line_2: z.string().optional(), address_city: z.string().optional(), address_state: z.string().optional(), address_postal_code: z.string().optional(), address_country_code: z.string().optional(), card_network: z.string().optional(), merchant_category_code: z.string().optional(), name_on_card: z.string().optional(), avs: z.string().optional(), description: z.string().optional(), merchant_category_description: z.string().optional(), currency: z.string().optional(), identity: z.object({external_counterparty_identity_id: z.string().min(1).max(256), type: z.enum(["person", "business", "merchant", "customer"]).nullable().optional(), identity_name: z.string().nullable().optional(), name_first: z.string().nullable().optional(), name_last: z.string().nullable().optional(), birth_date: z.string().nullable().optional(), email: z.string().nullable().optional(), phone: z.string().nullable().optional(), tax_id: z.string().nullable().optional(), merchant_identifier: z.string().nullable().optional(), merchant_category_code: z.string().nullable().optional(), mcc_description: z.string().nullable().optional(), dba_name: z.string().nullable().optional(), address_line_1: z.string().nullable().optional(), address_line_2: z.string().nullable().optional(), address_city: z.string().nullable().optional(), address_state: z.string().nullable().optional(), address_postal_code: z.string().nullable().optional(), address_country_code: z.string().nullable().optional(), entity_token: z.string().nullable().optional(), external_entity_id: z.string().max(65535).nullable().optional(), external_entity_id_source: z.string().min(1).max(100).nullable().optional(), device: registeredDevice.nullable().optional()}).nullable().optional(), instrument: z.object({external_instrument_id: z.string().min(1).max(256), instrument_type: z.enum(["bank_account", "card", "digital_wallet", "other"]), routing_number: z.string().nullable().optional(), routing_number_type: z.string().nullable().optional(), account_number: z.string().nullable().optional(), account_number_last4: z.string().nullable().optional(), account_holder_name: z.string().nullable().optional(), account_type: z.enum(["checking", "savings", "deposit", "credit", "other"]).nullable().optional(), country_code: z.string().nullable().optional(), card_bin: z.string().nullable().optional(), card_last4: z.string().nullable().optional(), card_network: z.string().nullable().optional(), form_factor: z.enum(["physical", "virtual"]).nullable().optional(), name_on_card: z.string().nullable().optional(), expiration_month: z.string().nullable().optional(), expiration_year: z.string().nullable().optional(), avs: z.string().nullable().optional(), wallet_provider: z.string().nullable().optional(), wallet_identifier: z.string().nullable().optional(), check_number: z.string().nullable().optional(), payee_name_raw: z.string().nullable().optional(), currency: z.string().max(3).nullable().optional()}).nullable()})]).optional(), category: z.enum(["Adjustment", "ATM Rebate", "Bill Pay", "Chargeback", "Deposit", "Direct Deposit Bonus", "Interest", "Overdraft Fee", "Payment", "Promo", "Purchase", "Purchase Return", "Return", "Service Charge", "Withdrawal"]).nullable().optional(), transaction_settled_at: z.string().nullable().optional(), description: z.string().nullable().optional(), type_code: z.string().nullable().optional(), type_description: z.string().nullable().optional(), is_approved: z.boolean().nullable().optional(), is_reversal: z.boolean().nullable().optional(), process_method: z.enum(["Card", "Internal", "Check", "P2P", "ACH", "Cash", "Wire", "Digital Wallet"]).nullable().optional(), is_triggered_by_user: z.boolean().nullable().optional(), interaction_point: z.enum(["Android", "ATM", "Card Swipe Terminal", "iOS", "Mobile", "Online Form", "Point of Sale", "QR", "Teller", "3rd Party App"]).nullable().optional(), linked_transactions: z.array(linkedTransactions).optional(), return_code: z.string().nullable().optional(), return_code_reason: z.literal("Unauthorized").nullable().optional(), status: z.enum(["Acknowledged", "Accepted", "Rejected", "Paused", "Pending", "Completed", "Declined", "Cancelled"]).nullable().optional(), status_detail: z.string().nullable().optional(), response_code: z.number().nullable().optional(), iso_message: z.number().nullable().optional(), entry_mode: z.number().nullable().optional(), timestamp: z.string().optional()}).and(z.record(z.string(), z.unknown())); 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 }; /** * Get a transaction. * * GET /transactions/{transaction_id} * * Also accepts auth: basic */ export const getApiTransactionsTransactionId = async (options?: GetApiTransactionsTransactionIdOptions) => { const {baseUrl = "https://sandbox.alloy.co/v1", fetch: fetchFn = fetch, oauth2} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/json") if (oauth2 !== undefined) headers.set('authorization', `Bearer ${oauth2}`) const url = `${baseUrl.replace(/\/+$/, '')}/transactions/${encodeURIComponent(String(args.transaction_id))}${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(eventTransactionBody, await res.json()) };