import {z} from 'zod' export type PaymentMethodType = 'ach' | 'affirm' | 'afterpay_clearpay' | 'alfamart' | 'ali_pay' | 'ali_pay_hk' | 'alma' | 'amazon_pay' | 'paysera' | 'apple_pay' | 'atome' | 'bacs' | 'bancontact_card' | 'becs' | 'benefit' | 'bizum' | 'blik' | 'bluecode' | 'boleto' | 'bca_bank_transfer' | 'bni_va' | 'breadpay' | 'bri_va' | 'bhn_card_network' | 'card_redirect' | 'cimb_va' | 'classic' | 'credit' | 'crypto_currency' | 'cashapp' | 'dana' | 'danamon_va' | 'debit' | 'duit_now' | 'efecty' | 'eft' | 'eft_debit_order' | 'eps' | 'flexiti' | 'fps' | 'evoucher' | 'giropay' | 'givex' | 'google_pay' | 'go_pay' | 'gcash' | 'ideal' | 'interac' | 'indomaret' | 'klarna' | 'kakao_pay' | 'local_bank_redirect' | 'mandiri_va' | 'knet' | 'mb_way' | 'mobile_pay' | 'momo' | 'momo_atm' | 'multibanco' | 'online_banking_thailand' | 'online_banking_czech_republic' | 'online_banking_finland' | 'online_banking_fpx' | 'online_banking_poland' | 'online_banking_slovakia' | 'oxxo' | 'pago_efectivo' | 'permata_bank_transfer' | 'open_banking_uk' | 'pay_bright' | 'payjustnow' | 'paypal' | 'paze' | 'pix' | 'pix_key' | 'pix_emv' | 'pix_qr' | 'pix_automatico_qr' | 'pix_automatico_push' | 'pay_safe_card' | 'przelewy24' | 'prompt_pay' | 'pse' | 'qris' | 'red_compra' | 'red_pagos' | 'samsung_pay' | 'sepa' | 'sepa_bank_transfer' | 'sepa_guarenteed_debit' | 'skrill' | 'sofort' | 'swish' | 'touch_n_go' | 'trustly' | 'twint' | 'upi_collect' | 'upi_intent' | 'upi_qr' | 'vipps' | 'viet_qr' | 'venmo' | 'walley' | 'we_chat_pay' | 'seven_eleven' | 'lawson' | 'mini_stop' | 'family_mart' | 'seicomart' | 'pay_easy' | 'local_bank_transfer' | 'mifinity' | 'open_banking_pis' | 'direct_carrier_billing' | 'instant_bank_transfer' | 'instant_bank_transfer_finland' | 'instant_bank_transfer_poland' | 'revolut_pay' | 'indonesian_bank_transfer' | 'open_banking' | 'network_token'; export type MerchantConnectorDetails = {connector_account_details?: (Record | null) | undefined, metadata?: (Record | null) | undefined}; export type MerchantConnectorDetailsWrap = {creds_identifier: string, encoded_data?: (MerchantConnectorDetails | null) | undefined}; export type PaymentsSessionRequest = {payment_id: string, client_secret?: (string | null) | undefined, wallets: Array, merchant_connector_details?: (MerchantConnectorDetailsWrap | null) | undefined}; export type CreateApiPaymentsSessionTokensArgs = {body: PaymentsSessionRequest}; export type CreateApiPaymentsSessionTokensOptions = {baseUrl: string, publishableKey?: string | undefined, fetch?: typeof fetch | undefined}; export const nextActionCall = z.union([z.literal("post_session_tokens"), z.literal("confirm"), z.literal("sync"), z.literal("complete_authorize"), z.literal("await_merchant_callback"), z.object({deny: z.object({message: z.string()})}), z.literal("eligibility_check")]); export const sdkNextAction = z.object({next_action: nextActionCall, should_block_confirm: z.boolean().nullable().optional()}); export const gpayMerchantInfo = z.object({merchant_id: z.string().nullable().optional(), merchant_name: z.string()}); export const gpayShippingAddressParameters = z.object({phone_number_required: z.boolean()}); export const gpayBillingAddressFormat = z.enum(["FULL", "MIN"]); export const gpayBillingAddressParameters = z.object({phone_number_required: z.boolean(), format: gpayBillingAddressFormat}); export const gpayAllowedMethodsParameters = z.object({allowed_auth_methods: z.array(z.string()), allowed_card_networks: z.array(z.string()), billing_address_required: z.boolean().nullable().optional(), billing_address_parameters: gpayBillingAddressParameters.nullable().optional(), assurance_details_required: z.boolean().nullable().optional(), allow_credit_cards: z.boolean().nullable().optional()}); export const gpayTokenParameters = z.object({gateway: z.string().nullable().optional(), gateway_merchant_id: z.string().nullable().optional(), "stripe:version": z.string().nullable().optional(), "stripe:publishableKey": z.string().nullable().optional(), protocol_version: z.string().nullable().optional(), public_key: z.string().nullable().optional()}); export const gpayTokenizationSpecification = z.object({type: z.string(), parameters: gpayTokenParameters}); export const gpayAllowedPaymentMethods = z.object({type: z.string(), parameters: gpayAllowedMethodsParameters, tokenization_specification: gpayTokenizationSpecification}); export const countryAlpha2 = z.enum(["AF", "AX", "AL", "DZ", "AS", "AD", "AO", "AI", "AQ", "AG", "AR", "AM", "AW", "AU", "AT", "AZ", "BS", "BH", "BD", "BB", "BY", "BE", "BZ", "BJ", "BM", "BT", "BO", "BQ", "BA", "BW", "BV", "BR", "IO", "BN", "BG", "BF", "BI", "KH", "CM", "CA", "CV", "KY", "CF", "TD", "CL", "CN", "CX", "CC", "CO", "KM", "CG", "CD", "CK", "CR", "CI", "HR", "CU", "CW", "CY", "CZ", "DK", "DJ", "DM", "DO", "EC", "EG", "SV", "GQ", "ER", "EE", "ET", "FK", "FO", "FJ", "FI", "FR", "GF", "PF", "TF", "GA", "GM", "GE", "DE", "GH", "GI", "GR", "GL", "GD", "GP", "GU", "GT", "GG", "GN", "GW", "GY", "HT", "HM", "VA", "HN", "HK", "HU", "IS", "IN", "ID", "IR", "IQ", "IE", "IM", "IL", "IT", "JM", "JP", "JE", "JO", "KZ", "KE", "KI", "KP", "KR", "KW", "KG", "LA", "LV", "LB", "LS", "LR", "LY", "LI", "LT", "LU", "MO", "MK", "MG", "MW", "MY", "MV", "ML", "MT", "MH", "MQ", "MR", "MU", "YT", "MX", "FM", "MD", "MC", "MN", "ME", "MS", "MA", "MZ", "MM", "NA", "NR", "NP", "NL", "NC", "NZ", "NI", "NE", "NG", "NU", "NF", "MP", "NO", "OM", "PK", "PW", "PS", "PA", "PG", "PY", "PE", "PH", "PN", "PL", "PT", "PR", "QA", "RE", "RO", "RU", "RW", "BL", "SH", "KN", "LC", "MF", "PM", "VC", "WS", "SM", "ST", "SA", "SN", "RS", "SC", "SL", "SG", "SX", "SK", "SI", "SB", "SO", "ZA", "GS", "SS", "ES", "LK", "SD", "SR", "SJ", "SZ", "SE", "CH", "SY", "TW", "TJ", "TZ", "TH", "TL", "TG", "TK", "TO", "TT", "TN", "TR", "TM", "TC", "TV", "UG", "UA", "AE", "GB", "UM", "UY", "UZ", "VU", "VE", "VN", "VG", "VI", "WF", "EH", "YE", "ZM", "ZW", "US"]); export const currency = z.enum(["AED", "AFN", "ALL", "AMD", "ANG", "AOA", "ARS", "AUD", "AWG", "AZN", "BAM", "BBD", "BDT", "BGN", "BHD", "BIF", "BMD", "BND", "BOB", "BRL", "BSD", "BTN", "BWP", "BYN", "BZD", "CAD", "CDF", "CHF", "CLF", "CLP", "CNY", "COP", "CRC", "CUC", "CUP", "CVE", "CZK", "DJF", "DKK", "DOP", "DZD", "EGP", "ERN", "ETB", "EUR", "FJD", "FKP", "GBP", "GEL", "GHS", "GIP", "GMD", "GNF", "GTQ", "GYD", "HKD", "HNL", "HRK", "HTG", "HUF", "IDR", "ILS", "INR", "IQD", "IRR", "ISK", "JMD", "JOD", "JPY", "KES", "KGS", "KHR", "KMF", "KPW", "KRW", "KWD", "KYD", "KZT", "LAK", "LBP", "LKR", "LRD", "LSL", "LYD", "MAD", "MDL", "MGA", "MKD", "MMK", "MNT", "MOP", "MRU", "MUR", "MVR", "MWK", "MXN", "MYR", "MZN", "NAD", "NGN", "NIO", "NOK", "NPR", "NZD", "OMR", "PAB", "PEN", "PGK", "PHP", "PKR", "PLN", "PYG", "QAR", "RON", "RSD", "RUB", "RWF", "SAR", "SBD", "SCR", "SDG", "SEK", "SGD", "SHP", "SLE", "SLL", "SOS", "SRD", "SSP", "STD", "STN", "SVC", "SYP", "SZL", "THB", "TJS", "TMT", "TND", "TOP", "TRY", "TTD", "TWD", "TZS", "UAH", "UGX", "USD", "UYU", "UZS", "VES", "VND", "VUV", "WST", "XAF", "XCD", "XOF", "XPF", "YER", "ZAR", "ZMW", "ZWL"]); export const gpayTransactionInfo = z.object({country_code: countryAlpha2, currency_code: currency, total_price_status: z.string(), total_price: z.string()}); export const secretInfoToInitiateSdk = z.object({display: z.string(), payment: z.string()}); export const samsungPayMerchantPaymentInformation = z.object({name: z.string(), url: z.string().nullable().optional(), country_code: countryAlpha2}); export const samsungPayAmountFormat = z.enum(["FORMAT_TOTAL_PRICE_ONLY", "FORMAT_TOTAL_ESTIMATED_AMOUNT"]); export const samsungPayAmountDetails = z.object({option: samsungPayAmountFormat, currency_code: currency, total: z.string()}); export const samsungPayProtocolType = z.literal("PROTOCOL3DS"); export const paypalFlow = z.literal("checkout"); export const paypalTransactionInfo = z.object({flow: paypalFlow, currency_code: currency, total_price: z.string()}); export const paypalCaptureMethod = z.enum(["capture", "authorize"]); export const thirdPartySdkSessionResponse = z.object({secrets: secretInfoToInitiateSdk}); export const nullObject = z.unknown(); export const applePaySessionResponse = z.union([thirdPartySdkSessionResponse, z.unknown(), nullObject]); export const amountInfo = z.object({label: z.string(), type: z.string().nullable().optional(), amount: z.string()}); export const applePayAddressParameters = z.enum(["postalAddress", "phone", "email"]); export const applePayBillingContactFields = z.array(applePayAddressParameters); export const applePayShippingContactFields = z.array(applePayAddressParameters); export const applePayPaymentTiming = z.enum(["immediate", "recurring"]); export const recurringPaymentIntervalUnit = z.enum(["year", "month", "day", "hour", "minute"]); export const applePayRegularBillingRequest = z.object({amount: z.string(), label: z.string(), payment_timing: applePayPaymentTiming, recurring_payment_start_date: z.string().nullable().optional(), recurring_payment_end_date: z.string().nullable().optional(), recurring_payment_interval_unit: recurringPaymentIntervalUnit.nullable().optional(), recurring_payment_interval_count: z.number().int().nullable().optional()}); export const applePayRecurringPaymentRequest = z.object({payment_description: z.string(), regular_billing: applePayRegularBillingRequest, billing_agreement: z.string().nullable().optional(), management_u_r_l: z.string()}); export const applePayPaymentRequest = z.object({country_code: countryAlpha2, currency_code: currency, total: amountInfo, merchant_capabilities: z.array(z.string()).nullable().optional(), supported_networks: z.array(z.string()).nullable().optional(), merchant_identifier: z.string().nullable().optional(), required_billing_contact_fields: applePayBillingContactFields.nullable().optional(), required_shipping_contact_fields: applePayShippingContactFields.nullable().optional(), recurring_payment_request: applePayRecurringPaymentRequest.nullable().optional()}); export const cardNetwork = z.enum(["Visa", "Mastercard", "AmericanExpress", "JCB", "DinersClub", "Discover", "CartesBancaires", "UnionPay", "Interac", "RuPay", "Maestro", "Star", "Pulse", "Accel", "Nyce", "Prop", "PrivateLabel", "Dinacard"]); export const ctpServiceProvider = z.enum(["visa", "mastercard"]); export const amazonPayPaymentIntent = z.enum(["Confirm", "Authorize", "AuthorizeWithCapture"]); export const minorUnit = z.number().int(); export const amazonPayDeliveryPrice = z.object({amount: minorUnit, currency_code: currency}); export const amazonPayShippingMethod = z.object({shipping_method_name: z.string(), shipping_method_code: z.string()}); export const amazonPayDeliveryOptions = z.object({id: z.string(), price: amazonPayDeliveryPrice, shipping_method: amazonPayShippingMethod, is_default: z.boolean()}); export const sessionToken = z.discriminatedUnion("wallet_name", [z.object({delayed_session_token: z.boolean(), connector: z.string(), sdk_next_action: sdkNextAction, wallet_name: z.literal("google_pay")}), z.object({merchant_info: gpayMerchantInfo, shipping_address_required: z.boolean(), email_required: z.boolean(), shipping_address_parameters: gpayShippingAddressParameters, allowed_payment_methods: z.array(gpayAllowedPaymentMethods), transaction_info: gpayTransactionInfo, delayed_session_token: z.boolean(), connector: z.string(), sdk_next_action: sdkNextAction, secrets: secretInfoToInitiateSdk.nullable().optional(), wallet_name: z.literal("google_pay")}), z.object({version: z.string(), service_id: z.string(), order_number: z.string(), merchant: samsungPayMerchantPaymentInformation, amount: samsungPayAmountDetails, protocol: samsungPayProtocolType, allowed_brands: z.array(z.string()), billing_address_required: z.boolean(), shipping_address_required: z.boolean(), wallet_name: z.literal("samsung_pay")}), z.object({session_token: z.string(), session_id: z.string(), wallet_name: z.literal("klarna")}), z.object({connector: z.string(), session_token: z.string(), sdk_next_action: sdkNextAction, client_token: z.string().nullable().optional(), transaction_info: paypalTransactionInfo.nullable().optional(), data_user_id_token: z.string().nullable().optional(), currency: currency.nullable().optional(), intent: paypalCaptureMethod.nullable().optional(), wallet_name: z.literal("paypal")}), z.object({session_token_data: applePaySessionResponse.nullable().optional(), payment_request_data: applePayPaymentRequest.nullable().optional(), connector: z.string(), delayed_session_token: z.boolean(), sdk_next_action: sdkNextAction, connector_reference_id: z.string().nullable().optional(), connector_sdk_public_key: z.string().nullable().optional(), connector_merchant_id: z.string().nullable().optional(), wallet_name: z.literal("apple_pay")}), z.object({open_banking_session_token: z.string(), wallet_name: z.literal("open_banking")}), z.object({client_id: z.string(), client_name: z.string(), client_profile_id: z.string(), transaction_currency_code: currency, transaction_amount: z.string(), email_address: z.string().max(255).nullable().optional(), wallet_name: z.literal("paze")}), z.object({dpa_id: z.string(), dpa_name: z.string(), locale: z.string(), card_brands: z.array(cardNetwork), acquirer_bin: z.string(), acquirer_merchant_id: z.string(), merchant_category_code: z.string().nullable().optional(), merchant_country_code: z.string(), transaction_amount: z.string(), transaction_currency_code: currency, phone_number: z.string().max(255).nullable().optional(), email: z.string().max(255).nullable().optional(), phone_country_code: z.string().nullable().optional(), provider: ctpServiceProvider.nullable().optional(), dpa_client_id: z.string().nullable().optional(), wallet_name: z.literal("click_to_pay")}), z.object({merchant_id: z.string(), ledger_currency: currency, store_id: z.string(), payment_intent: amazonPayPaymentIntent, total_shipping_amount: z.string(), total_tax_amount: z.string(), total_base_amount: z.string(), delivery_options: z.array(amazonPayDeliveryOptions), wallet_name: z.literal("amazon_pay")}), z.object({wallet_name: z.literal("no_session_token_received")})]); export const hyperswitchVaultData = z.object({sdk_authorization: z.string()}); export const vgsVaultData = z.object({vault_id: z.string(), environment: z.string()}); export const vaultDetailsResponse = z.discriminatedUnion("vault_type", [z.object({vault_type: z.literal("hyperswitch"), vault_data: hyperswitchVaultData}), z.object({vault_type: z.literal("vgs"), vault_data: vgsVaultData})]); export const paymentsSessionResponse = z.object({payment_id: z.string(), client_secret: z.string(), session_token: z.array(sessionToken), vault_details: vaultDetailsResponse.nullable().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 }; /** * Payments - Session token * * POST /payments/session_tokens */ export const createApiPaymentsSessionTokens = async (args: CreateApiPaymentsSessionTokensArgs, options: CreateApiPaymentsSessionTokensOptions) => { const {baseUrl, fetch: fetchFn = fetch, publishableKey} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('content-type', "application/json") headers.set('accept', "application/json") if (publishableKey !== undefined) headers.set("api-key", publishableKey) const url = `${baseUrl.replace(/\/+$/, '')}/payments/session_tokens${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(paymentsSessionResponse, await res.json()) };