tango-api-client

require "tango/api/client"

Tango::Api.configure do |c|
  c.base_url = ENV["TANGO_URL"]
  c.timeout = 45
  c.retries = { max: 2, base: 0.5, max_delay: 5 }
  # Basic auth
  c.auth = Tango::Api::Auth::Basic.new(platform: ENV["TANGO_PLATFORM"], key: ENV["TANGO_KEY"])
  # or OAuth2
  # c.auth = Tango::Api::Auth::OAuth2.new(
  #   token_url: ENV["TANGO_TOKEN_URL"],
  #   client_id: ENV["TANGO_CLIENT_ID"],
  #   client_secret: ENV["TANGO_CLIENT_SECRET"],
  #   scope: ENV["TANGO_SCOPE"]
  # )
end

client = Tango::Api::Client.new

# Alternatively, pass a base URL string directly
# (convenient for scripts or isolated clients)
client = Tango::Api::Client.new("https://integration-api.tangocard.com/raas/v2")

# Or pass a configuration hash for explicit per-client settings
client = Tango::Api::Client.new(
  base_url: "https://integration-api.tangocard.com/raas/v2",
  timeout: 60,
  retries: { max: 3, base: 0.5, max_delay: 8 },
  default_headers: { "Accept-Language" => "en-US" }
)

# Catalogs
client.catalogs.get(country: 'US', status: 'active', verbose: true, rewardType: ['gift card','payment card'], categoryIds: 'uuid1,uuid2', currency: 'USD')

# Orders
client.orders.create(accountIdentifier: 'acc', amount: 1000, customerIdentifier: 'cust', utid: 'UT...', recipient: { email: 'a@b.com', firstName: 'A' }, sendEmail: true)

# Accounts
client.accounts.get('acc-identifier')

# Create Account for a Customer
client.accounts.create('customer-identifier', { accountIdentifier: 'new-acc', currency: 'USD' })

# Customers
client.customers.create({ customerIdentifier: 'cust', name: 'ACME Inc.' })
# List and filter customers
client.customers.list(displayName: 'ACME', status: 'active')
# Fetch a specific customer
client.customers.get('cust')

# Funds
client.funds.register_card({ accountIdentifier: 'acc', card: { number: '4111...', expiryMonth: '12', expiryYear: '2030' } })
client.funds.add_funds({ accountIdentifier: 'acc', amount: 5000 })
client.funds.unregister_card({ accountIdentifier: 'acc' })

# Error handling
begin
  client.accounts.get('missing')
rescue Tango::Api::Errors::HttpError => e
  puts "Error: #{e.class} status=#{e.status} request_id=#{e.request_id} message=#{e.message}"
end

# Catalogs convenience filters
client.catalogs.get_by_brand_key('AMAZON', verbose: true)
client.catalogs.get_by_brand_name('Amazon', country: 'US')
client.catalogs.get_by_utid('UT123456')
client.catalogs.get_by_reward_name('Gift Card')

# Choice Products
client.choice_products.get(rewardName: 'Choice', currencyCode: 'USD', countries: ['US'])
client.choice_products.get_for_utid('UT-CHOICE-123')
client.choice_products.catalog('UT-CHOICE-123', verbose: true, country: 'US')

# Orders with Idempotency-Key for safe retries
require 'securerandom'
idempotency = SecureRandom.uuid
client.orders.create(
  { accountIdentifier: 'acc', amount: 1000, customerIdentifier: 'cust', utid: 'UT123', recipient: { email: 'a@b.com' } },
  idempotency_key: idempotency
)

# Resend with Idempotency-Key (prevents duplicate resends)
client.orders.resend('ORDER-123', idempotency_key: idempotency)