Ruby SDK

gem 'fyatu'

bundle install

gem install fyatu

require 'fyatu'

Fyatu.configure do |config|
  config.app_id = 'your_app_id'
  config.secret_key = 'your_secret_key'
end

# Create a collection
collection = Fyatu::Collection.create(
  amount: 10.00,
  currency: 'USD',
  reference: 'order_123',
  description: 'Payment for Order #123',
  customer: {
    email: 'customer@example.com',
    name: 'Alice Example'
  },
  redirect_url: 'https://yoursite.com/payment/success',
  webhook_url: 'https://yoursite.com/webhooks/fyatu'
)

puts collection.checkout_url

Fyatu.configure do |config|
  config.app_id = Rails.application.credentials.fyatu[:app_id]
  config.secret_key = Rails.application.credentials.fyatu[:secret_key]
end

rails generate fyatu:install

Fyatu.configure do |config|
  config.app_id = 'your_app_id'
  config.secret_key = 'your_secret_key'

  # Optional configuration
  config.base_url = 'https://api.fyatu.com/api/v3'
  config.timeout = 30
  config.max_retries = 3
end

begin
  payout = Fyatu::Payout.create(
    amount: 100,
    currency: 'USD',
    recipient_id: 'invalid_id'
  )
rescue Fyatu::ValidationError => e
  puts "Validation failed: #{e.details}"
rescue Fyatu::AuthenticationError => e
  puts "Authentication failed: #{e.message}"
rescue Fyatu::InsufficientBalanceError => e
  puts "Insufficient balance: #{e.message}"
rescue Fyatu::Error => e
  puts "API error [#{e.code}]: #{e.message}"
end

# Rails controller example
class WebhooksController < ApplicationController
  skip_before_action :verify_authenticity_token

  def fyatu
    signature = request.headers['X-Fyatu-Signature']
    payload = request.raw_post

    unless Fyatu::Webhook.verify_signature(payload, signature, ENV['FYATU_WEBHOOK_SECRET'])
      render plain: 'Invalid signature', status: :unauthorized
      return
    end

    event = JSON.parse(payload)

    case event['type']
    when 'collection.completed'
      handle_collection_completed(event['data'])
    when 'payout.completed'
      handle_payout_completed(event['data'])
    end

    render plain: 'OK', status: :ok
  end

  private

  def handle_collection_completed(data)
    # Process completed collection
  end

  def handle_payout_completed(data)
    # Process completed payout
  end
end

# List all collections with pagination
Fyatu::Collection.list(limit: 10).each do |collection|
  puts "Collection: #{collection.id} - #{collection.status}"
end

# Or with auto-pagination
Fyatu::Collection.auto_paging_each(limit: 100) do |collection|
  puts "Collection: #{collection.id}"
end