import {z} from 'zod' export type GetApiV2BeneficiariesDetailsArgs = {customer_id: string, beneficiary_id: string}; export type GetApiV2BeneficiariesDetailsOptions = {baseUrl?: string | undefined, bearerAuth?: string | undefined, fetch?: typeof fetch | undefined}; export const getApiV2BeneficiariesDetailsResponse = z.object({data: z.object({id: z.string().optional(), customer_id: z.string().optional(), active: z.boolean().optional(), status: z.enum(["INITIATED", "PROCESSING", "ACTIVE", "INACTIVE", "REJECTED"]).optional(), counter_party: z.enum(["FIRST_PARTY", "THIRD_PARTY"]).optional(), currency: z.string().optional(), country: z.string().optional(), account_holder: z.object({type: z.enum(["INDIVIDUAL", "BUSINESS"]).optional(), first_name: z.string().optional(), last_name: z.string().optional(), business_name: z.string().optional(), email: z.string().optional(), phone: z.string().optional()}).optional(), bank_account: z.object({bank_name: z.string().optional(), number: z.string().optional(), scheme: z.string().optional(), type: z.enum(["BANK", "E_WALLET"]).optional()}).optional(), bank_routing: z.array(z.object({scheme: z.string().optional(), name: z.string().optional()})).optional(), receiver_meta_data: z.object({transaction_purpose_id: z.number().int().optional(), transaction_purpose_remarks: z.string().optional(), occupation_id: z.number().int().optional(), occupation_remarks: z.string().optional(), relationship: z.string().optional(), relationship_remarks: z.string().optional(), nationality: z.string().optional()}).optional(), bank_address: z.object({street_line_1: z.string().optional(), city: z.string().optional(), state: z.string().optional(), postcode: z.string().optional(), country: z.string().optional()}).optional(), account_holder_address: z.object({street_line_1: z.string().optional(), city: z.string().optional(), state: z.string().optional(), postcode: z.string().optional(), country: z.string().optional()}).optional(), developer_fee: z.object({fixed: z.number().optional(), percentage: z.number().optional()}).optional(), deposit_instruction: z.object({currency: z.string().optional(), rail: z.string().optional(), liquidation_address: z.string().optional()}).optional(), refund_instruction: z.object({wallet_address: z.string().optional(), currency: z.string().optional(), rail: z.string().optional()}).optional(), e_wallet: z.object({scheme: z.string().optional(), number: z.string().optional()}).nullable().optional(), settlement_config: z.object({auto_settlement: z.boolean().optional()}).optional(), destination_wallet: z.object({address: z.string().optional(), currency: z.string().optional(), rail: z.string().optional()}).nullable().optional(), created_at: z.string().optional(), updated_at: z.string().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 }; /** * Fetch Beneficiary Details v2 * * GET /v2/beneficiaries/details */ export const getApiV2BeneficiariesDetails = async (args: GetApiV2BeneficiariesDetailsArgs, options?: GetApiV2BeneficiariesDetailsOptions) => { const {baseUrl = "https://sandbox.api.fin.com", fetch: fetchFn = fetch, bearerAuth} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/json") if (args.customer_id != null) query.append("customer_id", String(args.customer_id)) if (args.beneficiary_id != null) query.append("beneficiary_id", String(args.beneficiary_id)) if (bearerAuth !== undefined) headers.set('authorization', `Bearer ${bearerAuth}`) const url = `${baseUrl.replace(/\/+$/, '')}/v2/beneficiaries/details${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(getApiV2BeneficiariesDetailsResponse, await res.json()) };