import {z} from 'zod' export type Address = {line1?: string | undefined, line2?: string | undefined, city?: string | undefined, state?: string | undefined, country?: string | undefined, postal_code?: string | undefined}; export type Phone = {calling_code?: string | undefined, number?: string | undefined}; export type BankCodes = {swift_code?: string | undefined, bic_code?: string | undefined, ifsc_code?: string | undefined, aba_code?: string | undefined, sort_code?: string | undefined, branch_code?: string | undefined, bsb_code?: string | undefined, bank_code?: string | undefined, cnaps?: string | undefined}; export type Bank = {account_number?: string | undefined, iban?: string | undefined, bank_name?: string | undefined, branch_name?: string | undefined, country?: string | undefined, currency?: string | undefined, purpose_code?: string | undefined, bank_codes?: BankCodes | undefined, firc_required?: boolean | undefined, account_type?: ('savings' | 'checking' | 'payment') | undefined, account_holder_name?: string | undefined, transfer_type?: string | undefined}; export type Wallet = {deposit_address: string, type: 'ethereum' | 'tron' | 'polygon' | 'solana' | 'bitcoin_lightning_network', currency: string, hosted?: ('yes' | 'no') | undefined, vasp_name?: string | undefined, vasp_website?: string | undefined}; export type LocalPaymentNetwork = {type: string, deposit_key_type?: string | undefined, deposit_key: string, currency?: string | undefined}; export type TazapayAccount = {deposit_address: string}; export type DestinationDetails = {type: 'bank' | 'wallet' | 'local_payment_network' | 'tazapay_account', bank?: Bank | undefined, wallet?: Wallet | undefined, local_payment_network?: LocalPaymentNetwork | undefined, tazapay_account?: TazapayAccount | undefined}; export type BeneficiaryDetails = {name: string, email?: string | undefined, type: 'business' | 'individual', address?: Address | undefined, phone?: Phone | undefined, destination_details?: DestinationDetails | undefined, tax_id?: string | undefined, national_identification_number?: string | undefined, registration_number?: string | undefined, date_of_birth?: string | undefined, nationality?: string | undefined, destination?: string | undefined, documents?: Array | undefined, name_local?: string | undefined, party_classification?: string | undefined, status?: string | undefined}; export type PayoutItem = {name: string, quantity: number, amount: number, category: 'Goods', description?: string | undefined}; export type CreateApiV3PayoutArgs = {body: {amount: number, currency: string, beneficiary_details?: BeneficiaryDetails | undefined, beneficiary?: string | undefined, holding_currency?: string | undefined, metadata?: unknown | undefined, type?: ('local' | 'swift' | 'wallet' | 'local_payment_network' | 'tazapay_account') | undefined, charge_type?: ('shared' | 'ours') | undefined, purpose: 'PYR001' | 'PYR002' | 'PYR003' | 'PYR004' | 'PYR005' | 'PYR006' | 'PYR007' | 'PYR008' | 'PYR009' | 'PYR010' | 'PYR011' | 'PYR012' | 'PYR013' | 'PYR014' | 'PYR015' | 'PYR016' | 'PYR017' | 'PYR018' | 'PYR019' | 'PYR020' | 'PYR021' | 'PYR022' | 'PYR023' | 'PYR024' | 'PYR025' | 'PYR026' | 'PYR027' | 'PYR028' | 'PYR029' | 'PYR030' | 'PYR031' | 'PYR032' | 'PYR033' | 'PYR034' | 'PYR035' | 'PYR036', statement_descriptor?: string | undefined, reference_id?: string | undefined, transaction_description: string, documents?: Array<{type: string, url: string}> | undefined, on_behalf_of?: string | undefined, logistics_tracking_details?: (Array<{tracking_number?: string | undefined, logistics_provider?: ({name?: string | undefined, code?: string | undefined}) | undefined}>) | undefined, quote?: string | undefined, local?: ({fund_transfer_network?: string | undefined}) | undefined, items?: Array | undefined}}; export type CreateApiV3PayoutOptions = {baseUrl?: string | undefined, sec0?: {username: string, password: string} | undefined, fetch?: typeof fetch | undefined}; export const address = z.object({line1: z.string().optional(), line2: z.string().optional(), city: z.string().optional(), state: z.string().optional(), country: z.string().optional(), postal_code: z.string().optional()}); export const phone = z.object({calling_code: z.string().optional(), number: z.string().optional()}); export const bankCodes = z.object({swift_code: z.string().optional(), bic_code: z.string().optional(), ifsc_code: z.string().optional(), aba_code: z.string().optional(), sort_code: z.string().optional(), branch_code: z.string().optional(), bsb_code: z.string().optional(), bank_code: z.string().optional(), cnaps: z.string().optional()}); export const bank = z.object({account_number: z.string().optional(), iban: z.string().optional(), bank_name: z.string().optional(), branch_name: z.string().optional(), country: z.string().optional(), currency: z.string().optional(), purpose_code: z.string().optional(), bank_codes: bankCodes.optional(), firc_required: z.boolean().optional(), account_type: z.enum(["savings", "checking", "payment"]).optional(), account_holder_name: z.string().optional(), transfer_type: z.string().optional()}); export const wallet = z.object({deposit_address: z.string(), type: z.enum(["ethereum", "tron", "polygon", "solana", "bitcoin_lightning_network"]), currency: z.string(), hosted: z.enum(["yes", "no"]).optional(), vasp_name: z.string().optional(), vasp_website: z.string().optional()}); export const localPaymentNetwork = z.object({type: z.string(), deposit_key_type: z.string().optional(), deposit_key: z.string(), currency: z.string().optional()}); export const tazapayAccount = z.object({deposit_address: z.string()}); export const destinationDetails = z.object({type: z.enum(["bank", "wallet", "local_payment_network", "tazapay_account"]), bank: bank.optional(), wallet: wallet.optional(), local_payment_network: localPaymentNetwork.optional(), tazapay_account: tazapayAccount.optional()}); export const beneficiaryDetails = z.object({name: z.string().max(140), email: z.string().optional(), type: z.enum(["business", "individual"]), address: address.optional(), phone: phone.optional(), destination_details: destinationDetails.optional(), tax_id: z.string().optional(), national_identification_number: z.string().optional(), registration_number: z.string().optional(), date_of_birth: z.string().optional(), nationality: z.string().optional(), destination: z.string().optional(), documents: z.array(z.unknown()).optional(), name_local: z.string().optional(), party_classification: z.string().optional(), status: z.string().optional()}); export const fxTransaction = z.object({exchange_rate: z.number().optional(), final: z.object({amount: z.number().optional(), currency: z.string().optional()}).optional(), id: z.string().optional(), initial: z.object({amount: z.number().optional(), currency: z.string().optional()}).optional(), object: z.string().optional()}); export const metadata = z.record(z.string(), z.string()).nullable(); export const payoutItem = z.object({name: z.string().max(512), quantity: z.number().int().gte(1), amount: z.number().int().gte(1), category: z.literal("Goods"), description: z.string().max(512).optional()}); export const payoutData = z.object({amount: z.number().int().optional(), available_balance: z.number().int().optional(), balance_transaction: z.string().optional(), beneficiary: z.string().optional(), beneficiary_details: beneficiaryDetails.optional(), charge_type: z.enum(["ours", "shared"]).optional(), confirmation_documents: z.array(z.object({key: z.string().optional(), type: z.string().optional(), value: z.string().optional()})).optional(), created_at: z.string().optional(), currency: z.string().optional(), documents: z.array(z.unknown()).optional(), holding_currency: z.string().optional(), holding_fx_quote: z.string().optional(), holding_fx_transaction: fxTransaction.optional(), id: z.string().optional(), is_balance_sufficient: z.boolean().optional(), local: z.object({fund_transfer_network: z.string().optional()}).optional(), logistics_tracking_details: z.array(z.object({tracking_number: z.string().optional(), logistics_provider: z.object({name: z.string().optional(), code: z.string().optional()}).optional()})).optional(), metadata: metadata.optional(), mt103: z.string().optional(), object: z.string().optional(), on_behalf_of: z.string().optional(), payout_fx_transaction: fxTransaction.optional(), payout_quote: z.string().optional(), purpose: z.string().optional(), quote: z.string().optional(), reference_id: z.string().optional(), reversal_balance_transaction: z.string().optional(), reversal_payout_fx_transaction: fxTransaction.optional(), statement_descriptor: z.string().optional(), status: z.string().optional(), status_description: z.string().optional(), failure: z.object({code: z.string().optional(), description: z.string().optional()}).nullable().optional(), tracking_details: z.object({tracking_number: z.string().optional(), tracking_type: z.enum(["uetr", "utr", "transaction_hash"]).optional()}).optional(), transaction_description: z.string().optional(), items: z.array(payoutItem).optional(), type: z.enum(["swift", "local", "wallet", "local_payment_network", "tazapay_account"]).optional()}); export const createApiV3PayoutResponse = z.object({status: z.string().optional(), message: z.string().optional(), data: payoutData.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 }; /** * Create Payout * * POST /v3/payout */ export const createApiV3Payout = async (args: CreateApiV3PayoutArgs, options?: CreateApiV3PayoutOptions) => { const {baseUrl = "https://service-sandbox.tazapay.com", fetch: fetchFn = fetch, sec0} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('content-type', "application/json") headers.set('accept', "application/json") if (sec0 !== undefined) headers.set('authorization', `Basic ${btoa(`${sec0.username}:${sec0.password}`)}`) const url = `${baseUrl.replace(/\/+$/, '')}/v3/payout${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(createApiV3PayoutResponse, await res.json()) };