paygate_pk 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9705a5a01a864f4d8e318e11448540887091d6ef3d7294c1abaeb00df24a4cba
-  data.tar.gz: d0408482c432003735671608da1a46e71f1bae509c8b7f455d7dcbd1dd99865e
+  metadata.gz: dd62d57ff115a50c39bc303dbc2713554f220d64e7bfa262f5973851ccbef217
+  data.tar.gz: 9e459c21d4d178b2601c5ccc37b245defce997995e31bf85e82b5f08ceed9758
 SHA512:
-  metadata.gz: 95ff08faf44d5d6bb64311e24b02ce077ac0e19c28b33ce322acd647f1728cd3702b5af08f42bf89dd9d80f1378ccff424ad510e60e30c78de264d2b580acebb
-  data.tar.gz: 43e241ecdaa260a068e5224f0a560845b09a07de9f61cb2cef667796e8611697b50070d55f7d6ddee6a66b431794444ad748bb63128ac498272a86e9cb7a569d
+  metadata.gz: 6ad4cb08e2ced98d4daaad9bf4f519615b773dacdca507b9e5eaeee0b03cc9f4cb29eb87e62aee815cfb99c99167e71176c63362d3fa8e20b0d1a82dfe8ac112
+  data.tar.gz: fd859b7d8ef82f97e4a34b02dcd3b7b077b6cf5f479069d75194dd2bbd9587beb629cad6bf9e7d8573a0ce4cde4c1e80965d868fcb8489f4eddfb8eb3baf09b5

data/.rubocop.yml

@@ -42,6 +42,9 @@ Metrics/ParameterLists:
 Metrics/ClassLength:
   Max: 200
 
+Metrics/ModuleLength:
+  Max: 150
+
 # PayFast field names use ADDRESS_1, ADDRESS_2 -- mirror them in the
 # option hashes so it's obvious how each key maps to the wire format.
 Naming/VariableNumber:

data/CHANGELOG.md

@@ -1,5 +1,92 @@
 # Changelog
 
+## [1.1.0] - 2026-05-12
+
+### Overview
+
+Easypaisa lands — three new REST endpoints + a Rails OTC voucher helper.
+Pure addition; nothing in 1.0 changes shape, no breaking changes.
+
+### Public API (new)
+
+```ruby
+# Mobile Account: customer authorises via OTP push to their Easypaisa wallet
+result  = PaygatePk::EasyPaisa::MobileAccount.charge(
+  order_id:          "lawzo-#{payment.id}",
+  amount:            1500,
+  mobile_account_no: "03001234567",
+  email:             "client@example.com"
+)
+result.success?       # response_code == "0000"
+result.transaction_id # Ericsson EWP ID
+
+# OTC voucher: customer pays cash at any Easypaisa shop
+voucher = PaygatePk::EasyPaisa::OTC.create(
+  order_id:     "lawzo-#{payment.id}",
+  amount:       1500,
+  msisdn:       "03001234567",
+  email:        "client@example.com",
+  token_expiry: 7.days.from_now
+)
+voucher.payment_token   # "40933012" -- show this to the customer
+voucher.expires_at      # Time
+
+# Inquiry: poll status until PAID
+status = PaygatePk::EasyPaisa::Inquiry.fetch(
+  order_id:    "lawzo-...",
+  account_num: PaygatePk.config.easy_paisa.account_num
+)
+status.paid?
+status.pending?
+```
+
+Rails OTC voucher helper:
+
+```erb
+<%= paygate_pk_otc_voucher(@voucher) %>
+```
+
+### Added
+
+- `PaygatePk::EasyPaisa::MobileAccount.charge` — `initiate-ma-transaction`.
+- `PaygatePk::EasyPaisa::OTC.create` — `initiate-otc-transaction`. Accepts
+  Date/Time/DateTime/String for `token_expiry`, formats to
+  `"yyyymmdd HHmmss"` internally, validates future-dated up-front.
+- `PaygatePk::EasyPaisa::Inquiry.fetch` — `inquire-transaction`. Returns
+  `InquiryResult` with `paid?` / `failed?` / `pending?` / `expired?` /
+  `blocked?` / `reversed?` predicates covering every documented
+  `transactionStatus` value.
+- `PaygatePk::EasyPaisa::Endpoints` — sandbox URL baked in;
+  `c.easy_paisa.base_url = "..."` override for production (Easypaisa
+  hands the host out at go-live).
+- `Contracts::ChargeResult` — universal value object for any REST-style
+  "take a payment" call. Carries `success?`, `failed?`, `otc?`,
+  `mobile_account?` predicates.
+- `Contracts::InquiryResult` — universal value object for status lookups.
+- `Config::EasyPaisaConfig` — `environment` / `username` / `password` /
+  `store_id` / `account_num` / `base_url` override.
+- `Util::Credentials.basic(user, pass)` — `Base64.strict_encode64`
+  helper for Easypaisa's `Credentials` HTTP header.
+- `Coercions.to_easypaisa_timestamp` — formats Date/Time to the
+  `"yyyymmdd HHmmss"` format `tokenExpiry` demands.
+- `PaygatePk::Rails::ViewHelpers#paygate_pk_otc_voucher(charge_result)`
+  — prints a styled voucher (token, amount, mobile, expiry, order id,
+  instructions). Renders a failure card with `response_message` when
+  the upstream call returned a non-`0000` `responseCode`, never a fake
+  token.
+
+### Deferred to 1.2
+
+- `EasyPaisa::Callback.verify!` — Easypaisa's integration guide mentions
+  IPN configuration in the merchant portal but does not ship the full
+  wire spec. Until that's published, host apps should poll
+  `Inquiry.fetch` after issuing an OTC voucher.
+
+### Not changed
+
+- Nothing in the PayFast surface; 1.0's contracts and call sites are
+  unchanged.
+
 ## [1.0.0] - 2026-05-12
 
 ### Overview

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    paygate_pk (1.0.0)
+    paygate_pk (1.1.0)
       faraday (>= 2.7)
       faraday-retry (>= 2.0)
       json

data/README.md

@@ -3,10 +3,10 @@
 Unified Ruby/Rails client for Pakistani payment gateways.
 
 **1.0 ships:** PayFast hosted-checkout (redirection flow) and callback verification, with a one-line Rails view helper.
-**1.1 will ship:** Easypaisa REST APIs (Mobile Account, OTC voucher, Inquiry).
-**1.2 will ship:** PayFast tokenization / saved-instrument charge.
+**1.1 ships:** Easypaisa REST APIs — Mobile Account, OTC voucher, Inquiry — plus a Rails OTC voucher helper.
+**1.2 will ship:** PayFast tokenization / saved-instrument charge and Easypaisa IPN verification.
 
-The gem wraps every PayFast field documented in *Merchant Integration Guide v2.3*, validates required inputs, normalises dates and amounts, and returns plain Struct value objects you can pass around your Rails app.
+The gem wraps every documented field from the *PayFast Merchant Integration Guide v2.3* and the *Easypaisa REST APIs without RSA Integration Guide*, validates required inputs, normalises dates and amounts, and returns plain Struct value objects you can pass around your Rails app.
 
 ## Requirements
 
@@ -23,7 +23,7 @@ bundle add paygate_pk
 Or in a Gemfile:
 
 ```ruby
-gem "paygate_pk", "~> 1.0"
+gem "paygate_pk", "~> 1.1"
 ```
 
 ## Configure
@@ -33,15 +33,23 @@ gem "paygate_pk", "~> 1.0"
 PaygatePk.configure do |c|
   c.default_currency = "PKR"
 
+  # PayFast (hosted checkout / redirection)
   c.pay_fast.environment   = Rails.env.production? ? :production : :sandbox
   c.pay_fast.merchant_id   = Rails.application.credentials.dig(:pay_fast, :merchant_id)
   c.pay_fast.secured_key   = Rails.application.credentials.dig(:pay_fast, :secured_key)
   c.pay_fast.merchant_name = "Acme Store"
   c.pay_fast.store_id      = Rails.application.credentials.dig(:pay_fast, :store_id)  # optional
+
+  # Easypaisa (REST: Mobile Account / OTC / Inquiry)
+  c.easy_paisa.environment = Rails.env.production? ? :production : :sandbox
+  c.easy_paisa.username    = Rails.application.credentials.dig(:easy_paisa, :username)
+  c.easy_paisa.password    = Rails.application.credentials.dig(:easy_paisa, :password)
+  c.easy_paisa.store_id    = Rails.application.credentials.dig(:easy_paisa, :store_id)
+  c.easy_paisa.account_num = Rails.application.credentials.dig(:easy_paisa, :account_num)  # required for Inquiry
 end
 ```
 
-Sandbox URL is built in. If PayFast hands you a bespoke staging or production host, override with `c.pay_fast.base_url = "https://..."`.
+Sandbox URLs are built in for both providers. If either hands you a bespoke staging or production host, override with `c.pay_fast.base_url = "https://..."` / `c.easy_paisa.base_url = "https://..."`.
 
 After the block runs the config is deep-frozen for the lifetime of the process. Use `PaygatePk.reset_config!` in console/tests to start over.
 
@@ -142,6 +150,72 @@ PaygatePk::PayFast::Redirect.build(
 )
 ```
 
+## Take a payment via Easypaisa (REST)
+
+Easypaisa offers two flavours; pick per use case:
+
+- **Mobile Account (MA)** — customer authorises in their Easypaisa app via OTP push; merchant gets paid immediately. No redirect, no voucher.
+- **OTC (Over-the-Counter)** — merchant issues a payment token; customer pays cash at any Easypaisa shop within the expiry window.
+
+### Mobile Account
+
+```ruby
+result = PaygatePk::EasyPaisa::MobileAccount.charge(
+  order_id:          "lawzo-#{payment.id}",
+  amount:            1500,
+  mobile_account_no: "03001234567",
+  email:             "client@example.com",
+  optional:          { "1" => "tenant-42" }  # optional1..5 passthrough
+)
+
+if result.success?
+  payment.update!(external_transaction_id: result.transaction_id, status: :pending)
+  # customer now sees the OTP prompt on their Easypaisa app
+else
+  flash[:alert] = "Easypaisa: #{result.response_message} (code #{result.response_code})"
+end
+```
+
+### OTC voucher
+
+```ruby
+voucher = PaygatePk::EasyPaisa::OTC.create(
+  order_id:     "lawzo-#{payment.id}",
+  amount:       1500,
+  msisdn:       "03001234567",
+  email:        "client@example.com",
+  token_expiry: 7.days.from_now    # Date / Time / DateTime / pre-formatted String
+)
+voucher.payment_token   # => "40933012" — print or show this
+voucher.expires_at      # => Time
+```
+
+```erb
+<%# Rails: one-line printable voucher %>
+<%= paygate_pk_otc_voucher(@voucher) %>
+```
+
+### Inquiry (poll status)
+
+Use this after issuing an OTC voucher (or for any MA transaction you didn't catch via IPN):
+
+```ruby
+status = PaygatePk::EasyPaisa::Inquiry.fetch(
+  order_id:    "lawzo-#{payment.id}",
+  account_num: PaygatePk.config.easy_paisa.account_num    # falls back to config
+)
+
+case status.transaction_status
+when "PAID"     then payment.mark_completed!(amount: status.transaction_amount)
+when "FAILED", "EXPIRED", "BLOCKED", "REVERSED" then payment.mark_failed!(reason: status.transaction_status)
+when "PENDING"  then # customer hasn't visited a shop yet -- check again later
+end
+```
+
+Predicates available on the result: `paid?`, `failed?`, `pending?`, `expired?`, `blocked?`, `reversed?`, `successful_lookup?`.
+
+> **Note on IPN.** Easypaisa supports merchant-portal-configured IPN callbacks, but the wire spec isn't published in the REST guide. Until 1.2 ships `EasyPaisa::Callback.verify!`, poll `Inquiry.fetch` from a background job for OTC and on-demand for MA.
+
 ## Contracts
 
 ### `Contracts::RedirectRequest`
@@ -181,6 +255,47 @@ What `Callback.verify!` returns.
 | `recurring` | `Boolean` |  |
 | `raw` | `Hash` | Original params, unmodified |
 
+### `Contracts::ChargeResult` *(Easypaisa MA / OTC)*
+
+| Field | Type | Notes |
+|---|---|---|
+| `provider` | `Symbol` | `:easy_paisa` |
+| `basket_id` | `String` | Easypaisa `orderId` echo |
+| `transaction_id` | `String?` | Ericsson EWP id (MA only) |
+| `payment_token` | `String?` | Cash-redemption token (OTC only) |
+| `payment_mode` | `Symbol` | `:mobile_account` or `:otc` |
+| `expires_at` | `Time?` | OTC token expiry |
+| `transacted_at` | `Time?` |  |
+| `amount` | `String` |  |
+| `currency` | `String` |  |
+| `customer` | `Hash` | Echo of submitted customer info |
+| `response_code` | `String` | `"0000"` on success |
+| `response_message` | `String` | `responseDesc` |
+| `success_code` | `String` | `"0000"` — provider's success literal |
+| `raw` | `Hash` | Full provider response |
+
+Predicates: `success?`, `failed?`, `otc?`, `mobile_account?`.
+
+### `Contracts::InquiryResult` *(Easypaisa Inquire Transaction)*
+
+| Field | Type | Notes |
+|---|---|---|
+| `provider` | `Symbol` | `:easy_paisa` |
+| `basket_id` | `String` | Echoed `orderId` |
+| `account_num` | `String` |  |
+| `store_id` / `store_name` | `String?` |  |
+| `payment_token` | `String?` | OTC only |
+| `transaction_status` | `String` | `PAID`/`FAILED`/`PENDING`/`BLOCKED`/`EXPIRED`/`REVERSED` |
+| `transaction_amount` | `String` |  |
+| `transaction_date_time` | `String` | As Easypaisa sends, `dd/MM/yyyy hh:mm a` |
+| `payment_token_expiry` | `String?` | OTC only |
+| `msisdn` | `String?` |  |
+| `payment_mode` | `String` | `"MA"` / `"OTC"` / `"CC"` |
+| `response_code` / `response_message` | `String` |  |
+| `raw` | `Hash` | Full provider response |
+
+Predicates: `successful_lookup?`, `paid?`, `failed?`, `pending?`, `expired?`, `blocked?`, `reversed?`.
+
 ## Errors
 
 All errors inherit from `PaygatePk::Error`:
@@ -216,9 +331,10 @@ bundle exec rubocop
 
 ## Roadmap
 
-- **1.1** — Easypaisa: Mobile Account, OTC voucher, Inquiry, IPN. New helper `paygate_pk_otc_voucher`. Adds `c.easy_paisa.*` config block.
-- **1.2** — PayFast tokenization: bearer-token auth (`/api/token`), saved instruments (`/api/user/instruments`), charge-against-saved-instrument.
-- **1.x+** — Additional Pakistani gateways (JazzCash, HBL, SafePay) under the same `Contracts::RedirectRequest`/`CallbackEvent` shape so host code stays unchanged.
+- **1.0** ✅ — PayFast hosted-checkout + callback verification.
+- **1.1** ✅ — Easypaisa: Mobile Account, OTC voucher, Inquiry. `paygate_pk_otc_voucher` Rails helper. `c.easy_paisa.*` config block.
+- **1.2** — Easypaisa IPN (`EasyPaisa::Callback.verify!`). PayFast tokenization: bearer-token auth (`/api/token`), saved instruments (`/api/user/instruments`), charge-against-saved-instrument.
+- **1.x+** — Additional Pakistani gateways (JazzCash, HBL, SafePay) under the same `Contracts::RedirectRequest` / `ChargeResult` / `CallbackEvent` shapes so host code stays unchanged.
 
 ## Contributing
 

data/lib/paygate_pk/coercions.rb

@@ -8,7 +8,8 @@ module PaygatePk
   module Coercions
     module_function
 
-    DATE_ISO = "%Y-%m-%d"
+    DATE_ISO            = "%Y-%m-%d"
+    EASYPAISA_TIMESTAMP = "%Y%m%d %H%M%S"
 
     # Returns "YYYY-MM-DD" (PayFast's ORDER_DATE format) for Date/Time/DateTime
     # or a String already in that shape. nil-tolerant.
@@ -35,6 +36,23 @@ module PaygatePk
       end
     end
 
+    # Returns "yyyymmdd HHmmss" -- Easypaisa's tokenExpiry format
+    # (per the REST without RSA Integration Guide, Initiate OTC
+    # Transaction request parameters). Accepts Date/Time/DateTime or a
+    # String already in the right shape. nil-tolerant.
+    def to_easypaisa_timestamp(value)
+      return nil if value.nil?
+      return value if value.is_a?(String) && value.match?(/\A\d{8} \d{6}\z/)
+
+      case value
+      when Time, DateTime then value.strftime(EASYPAISA_TIMESTAMP)
+      when Date           then value.to_time.strftime(EASYPAISA_TIMESTAMP)
+      when String         then DateTime.parse(value).strftime(EASYPAISA_TIMESTAMP)
+      else
+        raise ArgumentError, "cannot coerce #{value.inspect} to Easypaisa timestamp"
+      end
+    end
+
     def blank?(value)
       value.nil? || (value.respond_to?(:empty?) && value.empty?)
     end

data/lib/paygate_pk/config.rb

@@ -6,17 +6,23 @@ module PaygatePk
   # Typical Rails usage:
   #   PaygatePk.configure do |c|
   #     c.default_currency = "PKR"
+  #
   #     c.pay_fast.environment   = Rails.env.production? ? :production : :sandbox
   #     c.pay_fast.merchant_id   = ENV["PAYFAST_MERCHANT_ID"]
   #     c.pay_fast.secured_key   = ENV["PAYFAST_SECURED_KEY"]
   #     c.pay_fast.merchant_name = "Acme Store"
-  #     c.pay_fast.store_id      = ENV["PAYFAST_STORE_ID"]
+  #
+  #     c.easy_paisa.environment = Rails.env.production? ? :production : :sandbox
+  #     c.easy_paisa.username    = ENV["EASYPAISA_USERNAME"]
+  #     c.easy_paisa.password    = ENV["EASYPAISA_PASSWORD"]
+  #     c.easy_paisa.store_id    = ENV["EASYPAISA_STORE_ID"]
+  #     c.easy_paisa.account_num = ENV["EASYPAISA_ACCOUNT"]
   #   end
   #
   # After `configure`, the config object is frozen — mutating it raises.
   class Config
     attr_accessor :default_currency, :timeouts, :retry, :user_agent, :logger
-    attr_reader   :pay_fast
+    attr_reader   :pay_fast, :easy_paisa
 
     def initialize
       @default_currency = "PKR"
@@ -28,6 +34,7 @@ module PaygatePk
       @user_agent       = "paygate_pk/#{PaygatePk::VERSION}"
       @logger           = nil
       @pay_fast         = PayFastConfig.new
+      @easy_paisa       = EasyPaisaConfig.new
       @configured       = false
     end
 
@@ -36,6 +43,7 @@ module PaygatePk
     def freeze!
       @configured = true
       @pay_fast.freeze
+      @easy_paisa.freeze
       freeze
       self
     end
@@ -86,5 +94,41 @@ module PaygatePk
         PaygatePk::PayFast::Endpoints.base_url(environment)
       end
     end
+
+    # Per-provider config for Easypaisa (REST without RSA).
+    #
+    # Required for any call: username + password + store_id. account_num
+    # is required for Inquiry only (it's the merchant's EWP Account #
+    # found on the Profile page of the Easypaisa Merchant Portal).
+    class EasyPaisaConfig
+      ENVIRONMENTS = %i[sandbox production].freeze
+
+      attr_accessor :username, :password, :store_id, :account_num, :base_url
+      attr_reader :environment
+
+      def initialize
+        @environment = :sandbox
+        @username    = nil
+        @password    = nil
+        @store_id    = nil
+        @account_num = nil
+        @base_url    = nil
+      end
+
+      def environment=(env)
+        sym = env&.to_sym
+        unless ENVIRONMENTS.include?(sym)
+          raise ArgumentError,
+                "environment must be one of #{ENVIRONMENTS.inspect}, got #{env.inspect}"
+        end
+        @environment = sym
+      end
+
+      def resolved_base_url
+        return base_url if base_url
+
+        PaygatePk::EasyPaisa::Endpoints.base_url(environment)
+      end
+    end
   end
 end

data/lib/paygate_pk/contracts/charge_result.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module PaygatePk
+  module Contracts
+    # Returned by every "create a charge / take a payment" call against a
+    # REST-style provider (Easypaisa MA + OTC in 1.1; future providers
+    # to follow). Universal shape so host apps can branch on
+    # payment_mode rather than provider-specific response classes.
+    #
+    # OTC fills payment_token and expires_at (the customer takes that
+    # token to an Easypaisa shop). MA fills transaction_id (the
+    # gateway's Ericsson EWP id) and leaves payment_token nil.
+    #
+    # response_code/response_message are the upstream provider's raw
+    # status code and human-readable reason. Compare against
+    # success_code for the success predicate -- Easypaisa says "0000",
+    # but other providers may say "000" or "OK".
+    ChargeResult = Struct.new(
+      :provider,            # Symbol e.g. :easy_paisa
+      :basket_id,           # String -- the merchant's reference (Easypaisa orderId)
+      :transaction_id,      # String or nil (Easypaisa Ericsson EWP id for MA)
+      :payment_token,       # String or nil (OTC only)
+      :payment_mode,        # Symbol :mobile_account | :otc
+      :expires_at,          # Time or nil (OTC only)
+      :transacted_at,       # Time or nil
+      :amount,              # String -- echo of input amount
+      :currency,            # String
+      :customer,            # Hash echo of customer info actually sent
+      :response_code,       # String e.g. "0000"
+      :response_message,    # String e.g. "SUCCESS"
+      :success_code,        # String -- provider's success literal
+      :raw,                 # Hash -- full provider response
+      keyword_init: true
+    ) do
+      def success?
+        response_code == success_code
+      end
+
+      def failed?
+        !success?
+      end
+
+      def otc?
+        payment_mode == :otc
+      end
+
+      def mobile_account?
+        payment_mode == :mobile_account
+      end
+    end
+  end
+end

data/lib/paygate_pk/contracts/inquiry_result.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+module PaygatePk
+  module Contracts
+    # Returned by status-inquiry calls (Easypaisa Inquire Transaction in
+    # 1.1; future providers to follow). Captures the canonical
+    # transaction status alongside everything the upstream API hands
+    # back so the host app can rebuild its mental model of the
+    # transaction without making additional calls.
+    InquiryResult = Struct.new(
+      :provider,                  # Symbol :easy_paisa
+      :basket_id,                 # String  Easypaisa orderId
+      :account_num,               # String  Merchant EWP account number
+      :store_id,                  # String
+      :store_name,                # String
+      :payment_token,             # String or nil  OTC only
+      :transaction_status,        # String  "PAID" | "FAILED" | "PENDING" | "BLOCKED" | "EXPIRED" | "REVERSED"
+      :transaction_amount,        # String
+      :transaction_date_time,     # String  "dd/MM/yyyy hh:mm a" as Easypaisa sends
+      :payment_token_expiry,      # String or nil  OTC only
+      :msisdn,                    # String
+      :payment_mode,              # String  "MA" | "OTC" | "CC"
+      :response_code,             # String  "0000" on a successful lookup
+      :response_message,          # String
+      :success_code,              # String  provider's success literal
+      :raw,                       # Hash    full provider response
+      keyword_init: true
+    ) do
+      def successful_lookup?
+        response_code == success_code
+      end
+
+      def paid?
+        transaction_status == "PAID"
+      end
+
+      def failed?
+        transaction_status == "FAILED"
+      end
+
+      def pending?
+        transaction_status == "PENDING"
+      end
+
+      def expired?
+        transaction_status == "EXPIRED"
+      end
+
+      def blocked?
+        transaction_status == "BLOCKED"
+      end
+
+      def reversed?
+        transaction_status == "REVERSED"
+      end
+    end
+  end
+end

data/lib/paygate_pk/easy_paisa/client.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+module PaygatePk
+  module EasyPaisa
+    # Internal shared HTTP wrapper for the three Easypaisa REST endpoints.
+    # Not advertised on the public surface; MobileAccount / OTC /
+    # Inquiry instantiate it directly and consume the parsed response.
+    #
+    # Responsibilities:
+    # - Validate provider config (username + password + store_id) before
+    #   touching the network; raises ConfigurationError with a list of
+    #   missing keys.
+    # - Build the Credentials header (Base64Strict("user:pass")).
+    # - POST a JSON body, returning the decoded Hash.
+    # - Convert any non-Hash response (Easypaisa always returns JSON, so
+    #   this is defensive) into a ProviderError with the raw body
+    #   attached.
+    class Client
+      SUCCESS_CODE = "0000"
+
+      def initialize(config: PaygatePk::EasyPaisa.config, http: nil)
+        @config = config
+        @http   = http
+      end
+
+      # POSTs json to the given path. Returns the decoded Hash. Does NOT
+      # interpret responseCode -- the caller decides whether non-0000
+      # warrants raising vs. surfacing as a result with success? == false.
+      def post(path, json:)
+        ensure_config!
+        http.post(path, json: json, headers: auth_headers)
+      end
+
+      def success_code
+        SUCCESS_CODE
+      end
+
+      private
+
+      def http
+        @http ||= PaygatePk::HTTP::Client.new(
+          base_url: @config.resolved_base_url,
+          headers: { "Accept" => "application/json" }
+        )
+      end
+
+      def auth_headers
+        {
+          "Credentials" => PaygatePk::Util::Credentials.basic(@config.username, @config.password)
+        }
+      end
+
+      def ensure_config!
+        missing = []
+        missing << :username if Coercions.blank?(@config.username)
+        missing << :password if Coercions.blank?(@config.password)
+        missing << :store_id if Coercions.blank?(@config.store_id)
+        return if missing.empty?
+
+        raise PaygatePk::ConfigurationError, "Easypaisa config missing: #{missing.join(", ")}"
+      end
+    end
+  end
+end

data/lib/paygate_pk/easy_paisa/endpoints.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module PaygatePk
+  module EasyPaisa
+    # Centralised URL map for Easypaisa REST endpoints. Picks between
+    # sandbox and production based on EasyPaisaConfig#environment;
+    # callers never hand-type hostnames.
+    #
+    # The path constants encode the three documented endpoints from the
+    # vendor's "REST APIs without RSA Integration Guide".
+    module Endpoints
+      URLS = {
+        sandbox: "https://easypaystg.easypaisa.com.pk",
+        # Easypaisa has not published an official production base URL in
+        # the public REST guide; merchants typically receive it on
+        # go-live. Configure via `c.easy_paisa.base_url = "..."` until
+        # then.
+        production: "https://easypay.easypaisa.com.pk"
+      }.freeze
+
+      INITIATE_MA_PATH  = "/easypay-service/rest/v4/initiate-ma-transaction"
+      INITIATE_OTC_PATH = "/easypay-service/rest/v4/initiate-otc-transaction"
+      INQUIRE_PATH      = "/easypay-service/rest/v4/inquire-transaction"
+
+      module_function
+
+      def base_url(env)
+        URLS.fetch(env) do
+          raise PaygatePk::ConfigurationError, "unknown Easypaisa environment: #{env.inspect}"
+        end
+      end
+    end
+  end
+end

data/lib/paygate_pk/easy_paisa/inquiry.rb

@@ -0,0 +1,87 @@
+# frozen_string_literal: true
+
+module PaygatePk
+  module EasyPaisa
+    # Inquire Transaction Status — given an orderId we previously
+    # submitted (and the merchant EWP account number), Easypaisa
+    # returns the current state. Use this to drive your own state
+    # machine for OTC payments (where success arrives asynchronously
+    # when the customer pays at a shop) or as a poor-man's IPN
+    # replacement until the IPN spec is wired.
+    #
+    # POST {base}/easypay-service/rest/v4/inquire-transaction
+    #
+    # Usage:
+    #
+    #   status = PaygatePk::EasyPaisa::Inquiry.fetch(
+    #     order_id:    "lawzo-#{payment.id}",
+    #     account_num: PaygatePk.config.easy_paisa.account_num
+    #   )
+    #   status.paid?     # transactionStatus == "PAID"
+    #   status.pending?  # transactionStatus == "PENDING"
+    class Inquiry
+      def self.fetch(**kwargs)
+        new.fetch(**kwargs)
+      end
+
+      def initialize(config: PaygatePk::EasyPaisa.config, client: nil)
+        @config = config
+        @client = client
+      end
+
+      def fetch(order_id:, account_num: nil)
+        account_num ||= @config.account_num
+        ensure_args!(order_id: order_id, account_num: account_num)
+
+        body = {
+          "orderId" => order_id.to_s,
+          "storeId" => @config.store_id.to_s,
+          "accountNum" => account_num.to_s
+        }
+
+        resp = client.post(Endpoints::INQUIRE_PATH, json: body)
+        build_result(order_id, account_num, resp)
+      end
+
+      private
+
+      def client
+        @client ||= Client.new(config: @config)
+      end
+
+      def ensure_args!(order_id:, account_num:)
+        missing = []
+        missing << :order_id    if Coercions.blank?(order_id)
+        missing << :account_num if Coercions.blank?(account_num)
+        return if missing.empty?
+
+        raise PaygatePk::ValidationError.new(
+          "missing required args: #{missing.join(", ")}",
+          details: { missing: missing }
+        )
+      end
+
+      def build_result(order_id, account_num, resp)
+        resp = {} unless resp.is_a?(Hash)
+        Contracts::InquiryResult.new(
+          provider: :easy_paisa,
+          basket_id: order_id.to_s,
+          account_num: account_num.to_s,
+          store_id: resp["storeId"]&.to_s,
+          store_name: resp["storeName"],
+          payment_token: resp["paymentToken"],
+          transaction_status: resp["transactionStatus"],
+          transaction_amount: resp["transactionAmount"]&.to_s,
+          transaction_date_time: resp["transactionDateTime"],
+          payment_token_expiry: resp["paymentTokenExpiryDateTime"],
+          msisdn: resp["msisdn"],
+          payment_mode: resp["paymentMode"],
+          response_code: resp["responseCode"],
+          response_message: resp["responseDesc"],
+          success_code: client.success_code,
+          raw: resp
+        )
+      end
+    end
+  end
+end

data/lib/paygate_pk/easy_paisa/mobile_account.rb

@@ -0,0 +1,123 @@
+# frozen_string_literal: true
+
+module PaygatePk
+  module EasyPaisa
+    # Initiate MA Transaction — pushes an OTP confirmation to the
+    # customer's Easypaisa wallet so they can authorise payment without
+    # leaving the merchant site.
+    #
+    # POST {base}/easypay-service/rest/v4/initiate-ma-transaction
+    #
+    # Usage:
+    #
+    #   result = PaygatePk::EasyPaisa::MobileAccount.charge(
+    #     order_id:          "lawzo-#{payment.id}",
+    #     amount:            1500,
+    #     mobile_account_no: "03001234567",
+    #     email:             "client@example.com"
+    #   )
+    #   result.success?       # => true if responseCode == "0000"
+    #   result.transaction_id # => Ericsson EWP ID (string)
+    class MobileAccount
+      TRANSACTION_TYPE = "MA"
+
+      def self.charge(**kwargs)
+        new.charge(**kwargs)
+      end
+
+      def initialize(config: PaygatePk::EasyPaisa.config, client: nil)
+        @config = config
+        @client = client
+      end
+
+      def charge(order_id:, amount:, mobile_account_no:, email:, optional: {})
+        ensure_args!(order_id: order_id, amount: amount,
+                     mobile_account_no: mobile_account_no, email: email)
+
+        body = build_body(order_id: order_id, amount: amount,
+                          mobile_account_no: mobile_account_no, email: email,
+                          optional: optional)
+
+        resp = client.post(Endpoints::INITIATE_MA_PATH, json: body)
+        build_result(order_id: order_id, amount: amount,
+                     mobile_account_no: mobile_account_no, email: email,
+                     resp: resp)
+      end
+
+      private
+
+      def client
+        @client ||= Client.new(config: @config)
+      end
+
+      def ensure_args!(order_id:, amount:, mobile_account_no:, email:)
+        missing = []
+        missing << :order_id          if Coercions.blank?(order_id)
+        missing << :amount            if amount.nil?
+        missing << :mobile_account_no if Coercions.blank?(mobile_account_no)
+        missing << :email             if Coercions.blank?(email)
+        return if missing.empty?
+
+        raise PaygatePk::ValidationError.new(
+          "missing required args: #{missing.join(", ")}",
+          details: { missing: missing }
+        )
+      end
+
+      def build_body(order_id:, amount:, mobile_account_no:, email:, optional:)
+        body = {
+          "orderId" => order_id.to_s,
+          "storeId" => @config.store_id.to_s,
+          "transactionAmount" => Coercions.to_amount_string(amount),
+          "transactionType" => TRANSACTION_TYPE,
+          "mobileAccountNo" => mobile_account_no.to_s,
+          "emailAddress" => email.to_s
+        }
+        add_optionals!(body, optional)
+        body
+      end
+
+      def add_optionals!(body, optional)
+        return unless optional.is_a?(Hash)
+
+        optional.each do |key, value|
+          next if Coercions.blank?(value)
+          next unless ("1".."5").cover?(key.to_s)
+
+          body["optional#{key}"] = value.to_s
+        end
+      end
+
+      def build_result(order_id:, amount:, mobile_account_no:, email:, resp:)
+        resp = {} unless resp.is_a?(Hash)
+        Contracts::ChargeResult.new(
+          provider: :easy_paisa,
+          basket_id: order_id.to_s,
+          transaction_id: resp["transactionId"],
+          payment_token: nil,
+          payment_mode: :mobile_account,
+          expires_at: nil,
+          transacted_at: parse_easypaisa_time(resp["transactionDateTime"]),
+          amount: Coercions.to_amount_string(amount),
+          currency: PaygatePk.config.default_currency,
+          customer: { mobile_account_no: mobile_account_no.to_s, email: email.to_s },
+          response_code: resp["responseCode"],
+          response_message: resp["responseDesc"],
+          success_code: client.success_code,
+          raw: resp
+        )
+      end
+
+      # Easypaisa hands back "dd/MM/yyyy hh:mm a" (e.g. "11/08/2018 11:30 PM").
+      # Best-effort parse -- returns the raw string if it's in some
+      # unexpected shape rather than blowing up the call site.
+      def parse_easypaisa_time(value)
+        return nil if Coercions.blank?(value)
+
+        DateTime.strptime(value, "%d/%m/%Y %I:%M %p").to_time
+      rescue ArgumentError, TypeError
+        value
+      end
+    end
+  end
+end

data/lib/paygate_pk/easy_paisa/otc.rb

@@ -0,0 +1,146 @@
+# frozen_string_literal: true
+
+module PaygatePk
+  module EasyPaisa
+    # Initiate OTC Transaction — issues a paymentToken the customer
+    # takes to any Easypaisa shop and pays with cash. The merchant gets
+    # paid when Easypaisa reconciles the shop deposit (status moves to
+    # PAID; poll via Inquiry.fetch or rely on IPN once configured in
+    # the merchant portal).
+    #
+    # POST {base}/easypay-service/rest/v4/initiate-otc-transaction
+    #
+    # Usage:
+    #
+    #   voucher = PaygatePk::EasyPaisa::OTC.create(
+    #     order_id:     "lawzo-#{payment.id}",
+    #     amount:       1500,
+    #     msisdn:       "03001234567",
+    #     email:        "client@example.com",
+    #     token_expiry: 7.days.from_now
+    #   )
+    #   voucher.payment_token  # => "40933012" (show this to the customer)
+    #   voucher.expires_at     # => Time
+    class OTC
+      TRANSACTION_TYPE = "OTC"
+
+      def self.create(**kwargs)
+        new.create(**kwargs)
+      end
+
+      def initialize(config: PaygatePk::EasyPaisa.config, client: nil)
+        @config = config
+        @client = client
+      end
+
+      def create(order_id:, amount:, msisdn:, email:, token_expiry:, optional: {})
+        ensure_args!(order_id: order_id, amount: amount,
+                     msisdn: msisdn, email: email, token_expiry: token_expiry)
+
+        formatted_expiry = format_expiry(token_expiry)
+
+        body = build_body(order_id: order_id, amount: amount, msisdn: msisdn,
+                          email: email, token_expiry: formatted_expiry, optional: optional)
+
+        resp = client.post(Endpoints::INITIATE_OTC_PATH, json: body)
+        build_result(order_id: order_id, amount: amount, msisdn: msisdn,
+                     email: email, formatted_expiry: formatted_expiry, resp: resp)
+      end
+
+      private
+
+      def client
+        @client ||= Client.new(config: @config)
+      end
+
+      def ensure_args!(order_id:, amount:, msisdn:, email:, token_expiry:)
+        missing = []
+        missing << :order_id     if Coercions.blank?(order_id)
+        missing << :amount       if amount.nil?
+        missing << :msisdn       if Coercions.blank?(msisdn)
+        missing << :email        if Coercions.blank?(email)
+        missing << :token_expiry if Coercions.blank?(token_expiry)
+        return if missing.empty?
+
+        raise PaygatePk::ValidationError.new(
+          "missing required args: #{missing.join(", ")}",
+          details: { missing: missing }
+        )
+      end
+
+      def format_expiry(value)
+        formatted = Coercions.to_easypaisa_timestamp(value)
+        validate_future!(formatted)
+        formatted
+      end
+
+      # Easypaisa returns code "0016" when tokenExpiry is in the past.
+      # Surface that as a ValidationError up-front so the caller doesn't
+      # waste a round-trip.
+      def validate_future!(formatted)
+        # Parse back to compare; we trust to_easypaisa_timestamp's shape.
+        parsed = DateTime.strptime(formatted, Coercions::EASYPAISA_TIMESTAMP).to_time
+        return if parsed > Time.now
+
+        raise PaygatePk::ValidationError.new(
+          "token_expiry must be in the future (got #{formatted})",
+          details: { token_expiry: formatted }
+        )
+      end
+
+      def build_body(order_id:, amount:, msisdn:, email:, token_expiry:, optional:)
+        body = {
+          "orderId" => order_id.to_s,
+          "storeId" => @config.store_id.to_s,
+          "transactionAmount" => Coercions.to_amount_string(amount),
+          "transactionType" => TRANSACTION_TYPE,
+          "msisdn" => msisdn.to_s,
+          "emailAddress" => email.to_s,
+          "tokenExpiry" => token_expiry
+        }
+        add_optionals!(body, optional)
+        body
+      end
+
+      def add_optionals!(body, optional)
+        return unless optional.is_a?(Hash)
+
+        optional.each do |key, value|
+          next if Coercions.blank?(value)
+          next unless ("1".."5").cover?(key.to_s)
+
+          body["optional#{key}"] = value.to_s
+        end
+      end
+
+      def build_result(order_id:, amount:, msisdn:, email:, formatted_expiry:, resp:)
+        resp = {} unless resp.is_a?(Hash)
+        Contracts::ChargeResult.new(
+          provider: :easy_paisa,
+          basket_id: order_id.to_s,
+          transaction_id: nil,
+          payment_token: resp["paymentToken"],
+          payment_mode: :otc,
+          expires_at: parse_easypaisa_time(resp["paymentTokenExpiryDateTime"]) ||
+                             DateTime.strptime(formatted_expiry, Coercions::EASYPAISA_TIMESTAMP).to_time,
+          transacted_at: parse_easypaisa_time(resp["transactionDateTime"]),
+          amount: Coercions.to_amount_string(amount),
+          currency: PaygatePk.config.default_currency,
+          customer: { msisdn: msisdn.to_s, email: email.to_s },
+          response_code: resp["responseCode"],
+          response_message: resp["responseDesc"],
+          success_code: client.success_code,
+          raw: resp
+        )
+      end
+
+      def parse_easypaisa_time(value)
+        return nil if Coercions.blank?(value)
+
+        DateTime.strptime(value, "%d/%m/%Y %I:%M %p").to_time
+      rescue ArgumentError, TypeError
+        value
+      end
+    end
+  end
+end

data/lib/paygate_pk/easy_paisa.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module PaygatePk
+  # Easypaisa integration (REST APIs without RSA encryption, per the
+  # vendor's "REST APIs without RSA Integration Guide").
+  #
+  # Public API (1.1):
+  #
+  #   PaygatePk::EasyPaisa::MobileAccount.charge(...)  # => Contracts::ChargeResult
+  #   PaygatePk::EasyPaisa::OTC.create(...)            # => Contracts::ChargeResult
+  #   PaygatePk::EasyPaisa::Inquiry.fetch(...)         # => Contracts::InquiryResult
+  #
+  # Callback (IPN) verification is deferred to 1.2 until Easypaisa
+  # publishes the full IPN wire spec; for now configure the IPN URL in
+  # the Easypaisa Merchant Portal and use Inquiry.fetch to poll status.
+  module EasyPaisa
+    def self.config
+      PaygatePk.config.easy_paisa
+    end
+  end
+end

data/lib/paygate_pk/rails/view_helpers.rb

@@ -8,6 +8,10 @@ module PaygatePk
       DEFAULT_FORM_ID = "paygate-pk-redirect-form"
       SUBMIT_LABEL    = "Pay now"
 
+      OTC_VOUCHER_SUCCESS_CLASS = "paygate-pk-otc-voucher rounded-2xl border border-emerald-200 bg-emerald-50 p-6"
+      OTC_VOUCHER_FAILURE_CLASS = "paygate-pk-otc-voucher paygate-pk-otc-voucher--failed " \
+                                  "rounded-2xl border border-rose-200 bg-rose-50 p-6"
+
       # Renders the auto-submitting redirect form for any provider that
       # produces a Contracts::RedirectRequest.
       #
@@ -29,6 +33,26 @@ module PaygatePk
         form_html + autosubmit_script(form_id)
       end
 
+      # Renders a printable Easypaisa OTC voucher from a
+      # Contracts::ChargeResult (from PaygatePk::EasyPaisa::OTC.create).
+      #
+      #   <%= paygate_pk_otc_voucher(@voucher) %>
+      #
+      # Options:
+      #   html:   { class:, ... } — outer container overrides
+      #   title:  heading text (default "Pay at any Easypaisa shop")
+      #   instructions: array of bullet strings; falls back to a sane
+      #                 default that mentions the expiry time
+      def paygate_pk_otc_voucher(result, html: {}, title: "Pay at any Easypaisa shop", instructions: nil)
+        return otc_voucher_failure(result, html) unless result.success? && result.payment_token.present?
+
+        container_attrs = otc_voucher_attrs(html, success: true)
+        body = otc_voucher_success_body(result, title: title,
+                                                instructions: instructions || default_otc_instructions(result))
+
+        content_tag(:div, body, container_attrs)
+      end
+
       private
 
       def render_form(redirect, form_id, html, autosubmit, submit_label)
@@ -54,6 +78,82 @@ module PaygatePk
           nonce: respond_to?(:content_security_policy_nonce) ? content_security_policy_nonce : nil
         )
       end
+
+      # ── OTC voucher rendering ─────────────────────────────────────
+
+      def otc_voucher_attrs(html, success:)
+        default_class = success ? OTC_VOUCHER_SUCCESS_CLASS : OTC_VOUCHER_FAILURE_CLASS
+        html.merge(class: [default_class, html[:class]].compact.join(" "))
+      end
+
+      def otc_voucher_success_body(result, title:, instructions:)
+        safe_join([
+                    content_tag(:h3, title, class: "text-base font-bold text-slate-900 mb-4"),
+                    otc_voucher_token_block(result),
+                    otc_voucher_meta(result),
+                    otc_voucher_instructions(instructions)
+                  ])
+      end
+
+      def otc_voucher_token_block(result)
+        content_tag(:div, class: "rounded-xl bg-white border border-emerald-200 px-5 py-4 mb-4 text-center") do
+          safe_join([
+                      content_tag(:p, "Payment token",
+                                  class: "text-xs font-semibold uppercase tracking-wide text-slate-500"),
+                      content_tag(:p, result.payment_token,
+                                  class: "mt-1 font-mono text-2xl font-bold tracking-widest text-slate-900")
+                    ])
+        end
+      end
+
+      def otc_voucher_meta(result)
+        rows = []
+        rows << ["Amount",  "PKR #{result.amount}"]
+        rows << ["Mobile",  result.customer[:msisdn]] if result.customer[:msisdn].present?
+        rows << ["Expires", otc_voucher_format_time(result.expires_at)] if result.expires_at
+        rows << ["Order",   result.basket_id]
+
+        content_tag(:dl, class: "grid grid-cols-2 gap-y-2 text-sm mb-4") do
+          safe_join(rows.flat_map do |label, value|
+            [
+              content_tag(:dt, label, class: "text-slate-500"),
+              content_tag(:dd, value, class: "text-right font-semibold text-slate-900")
+            ]
+          end)
+        end
+      end
+
+      def otc_voucher_instructions(instructions)
+        content_tag(:ul, class: "list-disc pl-5 space-y-1 text-xs text-slate-600") do
+          safe_join(instructions.map { |line| content_tag(:li, line) })
+        end
+      end
+
+      def default_otc_instructions(result)
+        expiry = result.expires_at ? otc_voucher_format_time(result.expires_at) : nil
+        [
+          "Visit any Easypaisa shop with the token above.",
+          "Pay PKR #{result.amount} in cash and quote your token to the agent.",
+          expiry ? "Pay before #{expiry} — the token expires after that." : nil
+        ].compact
+      end
+
+      def otc_voucher_failure(result, html)
+        container_attrs = otc_voucher_attrs(html, success: false)
+        message = result.response_message.presence || "Easypaisa did not issue a token for this order."
+        body = safe_join([
+                           content_tag(:h3, "Voucher unavailable", class: "text-base font-bold text-rose-900 mb-2"),
+                           content_tag(:p, message, class: "text-sm text-rose-700")
+                         ])
+        content_tag(:div, body, container_attrs)
+      end
+
+      def otc_voucher_format_time(value)
+        return value if value.is_a?(String)
+        return nil unless value.respond_to?(:strftime)
+
+        value.strftime("%d %b %Y, %I:%M %p")
+      end
     end
   end
 end

data/lib/paygate_pk/util/credentials.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require "base64"
+
+module PaygatePk
+  module Util
+    # Header-credential helpers used by REST providers that authenticate
+    # with a static username/password pair.
+    #
+    # Easypaisa: header key "Credentials", value is Base64Strict of
+    # "username:password" -- HTTP-Basic style but WITHOUT the literal
+    # "Basic " scheme prefix.
+    module Credentials
+      module_function
+
+      # Returns Base64Strict("user:pass"). Raises if either is blank
+      # -- empty credentials would silently authenticate as a different
+      # principal and produce baffling 401s downstream.
+      def basic(username, password)
+        raise PaygatePk::ConfigurationError, "username is required" if Coercions.blank?(username)
+        raise PaygatePk::ConfigurationError, "password is required" if Coercions.blank?(password)
+
+        Base64.strict_encode64("#{username}:#{password}")
+      end
+    end
+  end
+end

data/lib/paygate_pk/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module PaygatePk
-  VERSION = "1.0.0"
+  VERSION = "1.1.0"
 end

data/lib/paygate_pk.rb

@@ -7,12 +7,15 @@ require_relative "paygate_pk/config"
 
 require_relative "paygate_pk/util/security"
 require_relative "paygate_pk/util/signature/pay_fast"
+require_relative "paygate_pk/util/credentials"
 
 require_relative "paygate_pk/http/client"
 
 require_relative "paygate_pk/contracts/access_token"
 require_relative "paygate_pk/contracts/redirect_request"
 require_relative "paygate_pk/contracts/callback_event"
+require_relative "paygate_pk/contracts/charge_result"
+require_relative "paygate_pk/contracts/inquiry_result"
 
 require_relative "paygate_pk/pay_fast"
 require_relative "paygate_pk/pay_fast/endpoints"
@@ -20,19 +23,36 @@ require_relative "paygate_pk/pay_fast/auth"
 require_relative "paygate_pk/pay_fast/redirect"
 require_relative "paygate_pk/pay_fast/callback"
 
+require_relative "paygate_pk/easy_paisa"
+require_relative "paygate_pk/easy_paisa/endpoints"
+require_relative "paygate_pk/easy_paisa/client"
+require_relative "paygate_pk/easy_paisa/mobile_account"
+require_relative "paygate_pk/easy_paisa/otc"
+require_relative "paygate_pk/easy_paisa/inquiry"
+
 require_relative "paygate_pk/rails/railtie" if defined?(Rails::Railtie)
 
 # Unified Ruby/Rails client for Pakistani payment gateways.
 #
 #   PaygatePk.configure do |c|
+#     # PayFast (hosted checkout / redirection)
 #     c.pay_fast.environment   = :sandbox
 #     c.pay_fast.merchant_id   = ENV["PAYFAST_MERCHANT_ID"]
 #     c.pay_fast.secured_key   = ENV["PAYFAST_SECURED_KEY"]
 #     c.pay_fast.merchant_name = "Acme Store"
+#
+#     # Easypaisa (REST APIs)
+#     c.easy_paisa.environment = :sandbox
+#     c.easy_paisa.username    = ENV["EASYPAISA_USERNAME"]
+#     c.easy_paisa.password    = ENV["EASYPAISA_PASSWORD"]
+#     c.easy_paisa.store_id    = ENV["EASYPAISA_STORE_ID"]
 #   end
 #
 #   redirect = PaygatePk::PayFast::Redirect.build(...)
 #   event    = PaygatePk::PayFast::Callback.verify!(request.parameters)
+#   result   = PaygatePk::EasyPaisa::MobileAccount.charge(...)
+#   voucher  = PaygatePk::EasyPaisa::OTC.create(...)
+#   status   = PaygatePk::EasyPaisa::Inquiry.fetch(...)
 module PaygatePk
   class << self
     def configure

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: paygate_pk
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Talha Junaid
@@ -173,7 +173,15 @@ files:
 - lib/paygate_pk/config.rb
 - lib/paygate_pk/contracts/access_token.rb
 - lib/paygate_pk/contracts/callback_event.rb
+- lib/paygate_pk/contracts/charge_result.rb
+- lib/paygate_pk/contracts/inquiry_result.rb
 - lib/paygate_pk/contracts/redirect_request.rb
+- lib/paygate_pk/easy_paisa.rb
+- lib/paygate_pk/easy_paisa/client.rb
+- lib/paygate_pk/easy_paisa/endpoints.rb
+- lib/paygate_pk/easy_paisa/inquiry.rb
+- lib/paygate_pk/easy_paisa/mobile_account.rb
+- lib/paygate_pk/easy_paisa/otc.rb
 - lib/paygate_pk/errors.rb
 - lib/paygate_pk/http/client.rb
 - lib/paygate_pk/pay_fast.rb
@@ -183,6 +191,7 @@ files:
 - lib/paygate_pk/pay_fast/redirect.rb
 - lib/paygate_pk/rails/railtie.rb
 - lib/paygate_pk/rails/view_helpers.rb
+- lib/paygate_pk/util/credentials.rb
 - lib/paygate_pk/util/security.rb
 - lib/paygate_pk/util/signature/pay_fast.rb
 - lib/paygate_pk/version.rb