import {z} from 'zod' export type IssuingTransactionId = string; export type GetApiIssuingTransactionsTransactionIdArgs = {transactionId: IssuingTransactionId}; export type GetApiIssuingTransactionsTransactionIdOptions = {baseUrl: string, OAuth?: string | undefined, fetch?: typeof fetch | undefined}; export const issuingTransactionId = z.string().min(30).max(30); export const issuingClientId = z.string().min(30).max(30); export const issuingTransactionClient = z.object({id: issuingClientId.optional()}); export const issuingEntityId = z.string().min(30).max(30); export const issuingTransactionEntity = z.object({id: issuingEntityId.optional()}); export const issuingCardId = z.string().min(30).max(30); export const issuingTransactionCard = z.object({id: issuingCardId.optional(), network: z.literal("mastercard").optional()}); export const issuingDigitalCardId = z.string().min(30).max(30); export const issuingTransactionDigitalCard = z.object({id: issuingDigitalCardId.optional(), wallet_type: z.enum(["googlepay", "applepay", "remote_commerce_programs"]).optional()}); export const issuingCardholderId = z.string().min(30).max(30); export const issuingTransactionCardholder = z.object({id: issuingCardholderId.optional()}); export const issuingCurrency = z.string().min(3).max(3); export const issuingTransactionAmount = z.object({amount: z.number().optional(), currency: issuingCurrency.optional()}); export const issuingTransactionAmounts = z.object({total_held: issuingTransactionAmount.optional(), total_authorized: issuingTransactionAmount.optional(), total_reversed: issuingTransactionAmount.optional(), total_cleared: issuingTransactionAmount.optional(), total_refunded: issuingTransactionAmount.optional()}); export const issuingTransactionMerchant = z.object({id: z.string().optional(), name: z.string().optional(), city: z.string().optional(), state: z.string().optional(), country_code: z.string().optional(), category_code: z.string().optional()}); export const issuingReferenceTransaction = z.object({transaction_id: issuingTransactionId.optional(), reference_type: z.enum(["original_mit", "original_recurring"]).optional()}); export const issuingMessageId = z.string().min(30).max(30); export const issuingTransactionMessage = z.object({id: issuingMessageId.optional(), initiator: z.enum(["cardholder", "merchant", "acquirer", "card_network", "issuer"]).optional(), type: z.enum(["authorization", "reversal", "authorization_advice", "reversal_advice", "presentment", "authorization_refund", "presentment_refund", "presentment_reversed", "presentment_reversed_refund"]).optional(), result: z.enum(["approved", "declined", "processed"]).optional(), is_relayed: z.boolean().optional(), indicator: z.enum(["incremental_preauthorization", "deferred_authorization", "preauthorization", "normal_authorization", "final_authorization", "partial_reversal", "full_reversal", "partial_presentment", "final_presentment", "unknown"]).optional(), decline_reason: z.string().optional(), authorization_code: z.string().optional(), billing_amount: z.number().int().optional(), billing_currency: issuingCurrency.optional(), transaction_amount: z.number().int().optional(), transaction_currency: issuingCurrency.optional(), created_on: z.string().optional()}); export const issuingLink = z.object({href: z.string().max(100), actions: z.array(z.enum(["GET", "POST", "PUT", "DELETE", "PATCH"]).max(100)), types: z.array(z.string().max(100))}); export const getTransactionResponse = z.object({id: issuingTransactionId.optional(), created_on: z.string().optional(), status: z.enum(["authorized", "declined", "canceled", "cleared", "refunded", "disputed"]).optional(), transaction_type: z.enum(["account_funding", "account_transfer", "atm_installment", "balance_inquiry", "bill_payment", "cash_advance", "cashback", "credit_adjustment", "debit_adjustment", "original_credit", "payment_account_inquiry", "payment", "pin_change", "pin_unblock", "purchase_account_inquiry", "purchase", "quasi_cash", "remittance_funding", "remittance_payment", "unknown", "withdrawal", "refund"]).optional(), client: issuingTransactionClient.optional(), entity: issuingTransactionEntity.optional(), card: issuingTransactionCard.optional(), digital_card: issuingTransactionDigitalCard.optional(), cardholder: issuingTransactionCardholder.optional(), amounts: issuingTransactionAmounts.optional(), merchant: issuingTransactionMerchant.optional(), reference_transaction: issuingReferenceTransaction.optional(), messages: z.array(issuingTransactionMessage).optional(), _links: z.object({self: issuingLink.optional(), card: issuingLink.optional(), cardholder: issuingLink.optional(), reference_transaction: issuingLink.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 }; /** * Get a single transaction * * GET /issuing/transactions/{transactionId} */ export const getApiIssuingTransactionsTransactionId = async (args: GetApiIssuingTransactionsTransactionIdArgs, options: GetApiIssuingTransactionsTransactionIdOptions) => { const {baseUrl, fetch: fetchFn = fetch, OAuth} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/json") if (OAuth !== undefined) headers.set('authorization', `Bearer ${OAuth}`) const url = `${baseUrl.replace(/\/+$/, '')}/issuing/transactions/${encodeURIComponent(String(args.transactionId))}${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(getTransactionResponse, await res.json()) };