iOS HSA/FSA Quickstart

// app.js 

const axios = require('axios')
const express = require('express')
const bodyParser = require('body-parser')
require('dotenv').config();

const app = express()
const port = 5000

// Middleware to parse the request body
app.use(bodyParser.urlencoded({ extended: true }))

app.post('/api/session_token', async (req, res) => {
  try {
    const apiUrl = 'https://api.sandbox.joinforage.app/api/session_token/'
    // Replace the below with your authentication token
    const authenticationToken = process.env.AUTHENTICATION_TOKEN
    // Replace the below with your Forage merchant ID
    const merchantId = process.env.MERCHANT_ID

    const headers = {
      Accept: 'application/json',
      Authorization: `Bearer ${authenticationToken}`,
      'Merchant-Account': merchantId,
      'Content-Type': 'application/x-www-form-urlencoded'
    }

    const response = await axios.post(apiUrl, null, { headers })

    res.json(response.data)
  } catch (error) {
    res
      .status(error.response ? error.response.status : 500)
      .json({ error: 'Something went wrong' })
  }
})

app.listen(port, () => {
  console.log(`Server is running on http://localhost:${port}`)
})

# app.rb

require 'sinatra'
require 'net/http'
require 'json'
require 'dotenv/load'

class ApiController < Sinatra::Base
  post '/session_token' do
    begin
      api_url = 'https://api.sandbox.joinforage.app/api/session_token/'
      # Replace the below with your authentication token
      authentication_token = ENV['AUTHENTICATION_TOKEN']
      # Replace the below with your Forage merchant ID
      merchant_id = ENV['MERCHANT_ID']

      uri = URI(api_url)
      http = Net::HTTP.new(uri.host, uri.port)
      http.use_ssl = true

      headers = {
        'Accept' => 'application/json',
        'Authorization' => "Bearer #{authentication_token}",
        'Merchant-Account' => merchant_id,
        'Content-Type' => 'application/x-www-form-urlencoded',
      }

      response = http.post(uri.path, nil, headers)

      if response.is_a?(Net::HTTPSuccess)
        json_response = JSON.parse(response.body)
        content_type :json
        json_response.to_json
      else
        status response.code
        { error: 'Something went wrong' }.to_json
      end
    rescue StandardError => e
      status e.respond_to?(:status) ? e.status : 500
      { error: 'Something went wrong' }.to_json
    end
  end
end

pod init

pod 'ForageSDK', '~> 4.4.4'

pod install

pod repo update
pod update ForageSDK

import ForageSDK

// your code here

// ViewController.swift

ForageSDK.setup(
  ForageSDK.Config(
    merchantID: "d5685d56ed",
    sessionToken: "sandbox_eyJ0eXAiOiJKV1Qi..."
  )
)

// HSAFSAView.swift

private let foragePaymentSheet: ForagePaymentSheet = {
  let ps = ForagePaymentSheet()

  // set paymentType on the sheet
  ps.paymentType = .HSAFSA

  // set default styles on payment sheet that will cascade to all fields
  ps.borderWidth = 2.5
  ps.borderColor = .black
  ps.cornerRadius = 4

  // Set TextField specific settings and accessibility settings
  ps.cardHolderNameTextField.placeholder = "Card holder name"
  ps.cardHolderNameTextField.accessibilityIdentifier = "tf_paymentsheet_cardholderName"
  ps.cardHolderNameTextField.isAccessibilityElement = true

  return ps
}()

foragePaymentSheet.delegate = self

// signature
public protocol ForagePaymentSheetElementDelegate {
    func sheetTextFieldDidChange(_ state: PaymentSheetObservableState)
    func sheetFocusDidChange(_ state: PaymentSheetObservableState)
}

// usage
extension HSAFSAView: ForagePaymentSheetElementDelegate {
    func sheetFocusDidChange(_ state: any PaymentSheetObservableState) {
	if state.currentFirstResponder != nil {} // Payment Sheet gained focus
	else {} // Payment Sheet lost focus (blurred)
	
// view the currently focused field
      	print(state.currentFirstResponder?.name ?? "No focus")
    }
    
    func sheetTextFieldDidChange(_ state: any PaymentSheetObservableState) {
	// you can view all payment sheet completion errors
       print(state.completionErrors)

	// you can highlight fields with errors
        for var field in foragePaymentSheet.fields {
            if !field.isValid && !field.isFirstResponder && field.isDirty {
                field.borderColor = .red
            } else {
                field.borderColor = .black
            }
        }
    }
}

public protocol PaymentSheetObservableState {
    /// isComplete is true when all inputs on the sheet are valid and the sheet ready to be submitted.
    var isComplete: Bool { get }
    var completionErrors: [String: any Error] { get }
    var currentFirstResponder: (any ForagePaymentSheetField)? { get }
}

// HSAFSAView.swift

public func render() {
  foragePaymentSheet.delegate = self
  setupView()
  setupConstraints()
}

// HSAFSAView.swift

extension HSAFSAView: ForagePaymentSheetElementDelegate {
  func sheetFocusDidChange(_ state: PaymentSheetObservableState) {
    updateState(state: state)
  }

  func sheetTextFieldDidChange(_ state: PaymentSheetObservableState) {
    updateState(state: state)
  }
}

class HSAFSAViewController: UIViewController {
  override func viewDidAppear(_ animated: Bool) {
    super.viewDidAppear(animated)
    // You can change which subfield becomes first responder
    customView.foragePaymentSheet.cardHolderNameTextField.becomeFirstResponder()
  }
}

// HSAFSAView.swift

ForageSDK.shared.tokenizeCreditDebitCard(
  foragePaymentSheet: foragePaymentSheet,
  // NOTE: The following line is for testing purposes only and should not be used in production.
  // Please replace this line with a hashed customer ID value.
  customerID: UUID.init().uuidString,
  reusable: true
) { result in
  // Handle result and error here
  switch result {
  case .success(let paymentMethod):
    // Handle the PaymentMethod here (paymentMethodIdentifier, card, type, etc.)
  case .failure(let error):
    if let forageError = error as? ForageError {
      // handle forageError.code, forageError.httpStatusCode and forageError.message
    }
  }
}