afconwave — Official Ruby SDK

gem 'afconwave'

require 'afconwave'

afw = AfconWave::Client.new(secret_key: 'sk_test_your_key_here')

payment = afw.create_payment(
  amount: 5000,            # Amount in minor units (5000 = 50 XAF)
  currency: 'XAF',
  description: 'Order #1234',
  callback_url: 'https://yoursite.com/payment/callback',
  customer: {
    name: 'Jean Dupont',
    email: 'jean@example.com'
  }
)

puts payment['checkout_url'] # Redirect user here
puts payment['id']           # e.g., pay_507f191e8180f

payment = afw.retrieve_payment('pay_507f191e8180f')

puts payment['status']   # "pending" | "success" | "failed"
puts payment['amount']

result = afw.list_payments(limit: 20, status: 'success')

result['data'].each do |payment|
  puts "#{payment['id']} - #{payment['amount']} #{payment['currency']}"
end

# In a Rails controller
def webhook
  payload = request.raw_post
  signature = request.headers['X-AfconWave-Signature']
  secret = ENV['AFCONWAVE_WEBHOOK_SECRET']

  is_valid = AfconWave::Client.verify_webhook_signature(
    payload: payload,
    signature: signature,
    secret: secret
  )

  if is_valid
    event = JSON.parse(payload)
    # Handle event...
    render json: { status: 'ok' }, status: 200
  else
    render json: { error: 'Invalid signature' }, status: 400
  end
end

begin
  payment = afw.create_payment(...)
rescue AfconWave::AuthError => e
  puts "Invalid API Key: #{e.message}"
rescue AfconWave::Error => e
  puts "API Error #{e.status_code}: #{e.message}"
end