chore:update readme

Author: Andrew-Paystack

README.md

@@ -16,7 +16,7 @@
 
 ## Installation
 
-Add this line to your application's Gemfile:
+Add this to your application's Gemfile:
 
 ```ruby
 gem "paystack-ruby"
@@ -34,10 +34,22 @@ Or install directly:
 gem install paystack-ruby
 ```
 
+---
+## Configuration
+
+`Paystack::Client` takes your secret key as its only argument:
+
+```ruby
+paystack = Paystack::Client.new(ENV.fetch("PAYSTACK_SECRET_KEY"))
+```
+Use your Test Secret Key (`sk_test_...`) for development and Live Secret Key (`sk_live_...`) in production. Get them from your [Paystack Dashboard](https://dashboard.paystack.com/#/login).
+
 ---
 
 ## Quick Start
 
+Initialize a transaction and send the customer to `authorization_url` to pay:
+
 ```ruby
 require "paystack"
 
@@ -53,19 +65,16 @@ result = paystack.transaction.initialize(
 puts result.data[:authorization_url]
 ```
 
----
-
-## Configuration
-
-Initialize `Paystack::Client` with your secret key:
+Once the customer is redirected back, verify the transaction before you treat it as paid; never trust the redirect alone:
 
 ```ruby
-paystack = Paystack::Client.new("sk_live_xxxxxxxxxxxx")
+result = paystack.transaction.verify(reference)
+
+if result.data[:status] == "success"
+  # fulfil the order
+end
 ```
 
-| Option | Type | Required | Default |
-|---|---|---|---|
-| `api_key` | `String` | ✅ | — |
 
 ---
 
@@ -85,21 +94,28 @@ response.meta        # Hash / nil
 
 ## Error Handling
 
-API failures raise typed exceptions:
+API failures raise a `Paystack::Error`, carrying the HTTP status and response body:
 
 ```ruby
 begin
   paystack.transaction.initialize({ email: "customer@example.com", amount: 100_000 })
-rescue Paystack::AuthenticationError,
-       Paystack::ValidationError,
-       Paystack::NotFoundError,
-       Paystack::RateLimitError,
-       Paystack::ServerError => e
+rescue Paystack::Error => e
   puts e.message
   puts e.http_status
 end
 ```
 
+If you need to branch on failure type, rescue the specific subclass instead — `Paystack::AuthenticationError`, `ValidationError`, `NotFoundError`, `RateLimitError`, or `ServerError`:
+
+```ruby
+begin
+  paystack.transaction.initialize({ email: "customer@example.com", amount: 100_000 })
+rescue Paystack::RateLimitError
+  sleep(1)
+  retry
+end
+```
+
 ---
 
 ## API Reference