bitpesa-sdk 0.1.0

data/example/client.rb

@@ -0,0 +1,395 @@
+#!/usr/bin/env ruby
+
+require 'securerandom'
+require 'bundler/inline'
+
+gemfile do
+  gem "bitpesa-sdk", "=0.1.0"
+end
+
+require 'bitpesa-sdk'
+
+credentials = {
+    key: "/8w2C+cXLixtV+erRpFK3kd/neknrfToQGCw9zoCYw5jAFJEv6XrnOhF0+Vk65jgq094J8LDQ9H8x1hEgeXdFA==",
+    secret: "biBm9X2y2wRY4U1WZPpFrxCSoHQ1Xtyy9VPxbfhAI70wxsnmvEGhC4PlTyjejRqvrnIT7velS8WyYb0AN4Y29A==",
+    host: 'localhost:3002/v1',
+}
+
+class Client
+  def initialize(credentials)
+    Bitpesa.configure do |config|
+      config.api_key = credentials[:key]
+      config.api_secret = credentials[:secret]
+      config.host = credentials[:host]
+      config.scheme = 'http'
+    end
+  end
+
+  def list_currencies_example
+    begin
+      currency_info_api = Bitpesa::CurrencyInfoApi.new
+      currencies = currency_info_api.info_currencies.object
+      currencies.map(&:code)
+    rescue Bitpesa::ApiError => e
+      puts "Exception when calling CurrencyInfoApi#info_currencies: #{e}"
+    end
+  end
+
+  def account_validation_example
+    begin
+      request = Bitpesa::AccountValidationRequest.new
+      request.bank_account = '9040009999999'
+      request.bank_code = '120100'
+      request.country = 'GH'
+      request.currency = 'GHS'
+      request.method = 'bank'
+
+      account_validation_api = Bitpesa::AccountValidationApi.new
+      account_validation = account_validation_api.post_account_validations(request)
+      account_name = account_validation.object.account_name
+      puts "Account Name: #{account_name}"
+    rescue Bitpesa::ApiError => e
+      if e.validation_error
+        puts e.response_object("AccountValidationResponse").meta.error
+      else
+        puts "Exception when calling AccountValidationApi#account_validation_example: #{e}"
+      end
+    end
+  end
+
+  def create_sender_example
+    begin
+      api = Bitpesa::SendersApi.new
+      sender = Bitpesa::Sender.new
+      sender.country = 'UG'
+      sender.phone_country = 'UG'
+      sender.phone_number = '752403639'
+      sender.email = 'example@home.org'
+      sender.first_name = 'Johnny'
+      sender.last_name = 'English'
+      sender.city = 'Kampala'
+      sender.street = "Unknown 17-3"
+      sender.address_description = "Description of address"
+      sender.postal_code = "798983"
+      sender.birth_date = "1900-12-31"
+      sender.ip = '127.0.0.1'
+
+      sender_request = Bitpesa::SenderRequest.new
+      sender_request.sender = sender
+      api.post_senders(sender_request)
+      # SenderRequest |
+    rescue Bitpesa::ApiError => e
+      if e.validation_error
+        puts e.response_object("SenderResponse").object.errors
+      else
+        puts "Exception when calling SendersApi#create_sender_example: #{e}"
+      end
+    end
+  end
+
+  def update_sender_example
+    begin
+      api = Bitpesa::SendersApi.new
+      sender = Bitpesa::Sender.new
+      sender.city = 'London'
+      sender_request = Bitpesa::SenderRequest.new
+      sender_request.sender = sender
+
+      api.patch_sender('0789f89b-a2f3-4323-b8cc-c901692889d4', sender_request)
+    rescue Bitpesa::ApiError => e
+      if e.validation_error
+        puts e.response_object("SenderResponse").object.errors
+      else
+        puts "Exception when calling SendersApi#create_sender_example: #{e}"
+      end
+    end
+  end
+
+  def create_transaction_example
+    begin
+      api = Bitpesa::TransactionsApi.new
+      transaction = Bitpesa::Transaction.new
+
+      sender = Bitpesa::Sender.new
+      sender.id = 'ec33484c-4456-4625-a823-9704a3a54e68'
+
+      ngn_bank_details = Bitpesa::PayoutMethodDetails.new
+      ngn_bank_details.bank_account = '123456789'
+      ngn_bank_details.bank_account_type = Bitpesa::PayoutMethodBankAccountTypeEnum::N20
+      ngn_bank_details.bank_code = '082'
+      ngn_bank_details.first_name = 'first'
+      ngn_bank_details.last_name = 'last'
+
+      payout_method = Bitpesa::PayoutMethod.new
+      payout_method.type = 'NGN::Bank'
+      payout_method.details = ngn_bank_details
+
+      recipient = Bitpesa::Recipient.new
+      recipient.requested_amount = 10000
+      recipient.requested_currency = 'NGN'
+      recipient.payout_method = payout_method
+
+      transaction.input_currency = 'GBP'
+      transaction.sender = sender
+      transaction.recipients = [recipient]
+
+      transaction_request = Bitpesa::TransactionRequest.new
+      transaction_request.transaction = transaction
+      transaction_response = api.post_transactions(transaction_request)
+      created_transaction = transaction_response.object
+
+      puts "Transaction created! ID: #{created_transaction.id}"
+      created_transaction.id
+    rescue Bitpesa::ApiError => e
+      if e.validation_error
+        puts e.response_object("TransactionResponse").object.errors
+      else
+        puts e
+      end
+    end
+  end
+
+  def create_and_fund_transaction_example
+    transaction_id = create_transaction_example
+    if transaction_id.nil?
+      puts "Transaction with ID #{transaction_id} does not exist"
+    else
+      debit = Bitpesa::Debit.new
+      debit.currency = 'GBP'
+      debit.to_id = transaction_id
+      debit.to_type = "Transaction"
+
+      debit_request = Bitpesa::DebitRequestWrapper.new
+      debit_request.debit = debit
+
+      debit_api = Bitpesa::AccountDebitsApi.new
+
+      begin
+        debit_response = debit_api.post_accounts_debits(debit_request)
+        puts "Transaction Funded Successfully"
+        debit_response.object
+      rescue Bitpesa::ApiError => e
+        if e.validation_error
+          puts e.response_object("DebitResponse").object.errors
+        else
+          puts e
+        end
+      end
+    end
+  end
+
+  def webhook_parse_example
+    webhook_content = <<-JSON
+      {
+        "webhook": "85d11cf4-d4d6-46e4-ab7d-91355e80392a",
+        "event": "transaction.created",
+        "object": {
+          "input_amount": 21.59,
+          "input_currency": "GBP",
+          "id": "cd390e83-a9de-404d-a660-4da0f1342c04",
+          "metadata": {},
+          "state": "approved",
+          "payin_reference": "WIHGHZTSPOWN",
+          "sender": {
+            "id": "6f15f581-889f-4ae1-9591-cb283add661f",
+            "type": "person",
+            "state": "approved",
+            "state_reason": null,
+            "country": "GB",
+            "street": "Brick Lane",
+            "postal_code": "E1 6QL",
+            "city": "London",
+            "phone_country": "GB",
+            "phone_number": "07123456789",
+            "email": "me@bitpesa.co",
+            "ip": "127.0.0.1",
+            "address_description": null,
+            "first_name": "Test",
+            "middle_name": null,
+            "last_name": "User",
+            "birth_date": "1990-01-01",
+            "occupation": "Tester",
+            "nationality": null,
+            "metadata": {
+              "bitpesa": {
+                "referer": {}
+              }
+            },
+            "providers": {
+              "NGN::Bank": "bitpesa_auto"
+            },
+            "onboarding_status": "completed_first_transaction"
+          },
+          "payin_methods": [
+            {
+              "id": "e78632a8-51de-4b78-892c-31d6c5d0db5c",
+              "type": "GBP::Bank",
+              "out_details": {
+                "style": "info",
+                "BIC": "LHVBEE22",
+                "IBAN": "EE087700771002673049",
+                "Reference": "WIHGHZTSPOWN",
+                "Account Name": "B TRANSFER SERVICES LIMITED",
+                "Bank Address": "Tartu mnt 2, 10145 Tallinn, Estonia.",
+                "Beneficiary Address": "Tax Assist Accountants, 64 Southwark Bridge Road, London SE1 0AS"
+              },
+              "in_details": {},
+              "instructions": {},
+              "provider": "lhv"
+            }
+          ],
+          "paid_amount": 0,
+          "due_amount": 21.59,
+          "recipients": [
+            {
+              "created_at": "2019-03-04T07:41:49.972Z",
+              "editable": true,
+              "id": "4a401c7f-7e38-445f-bb85-7dcad8d22e91",
+              "input_usd_amount": 28.52,
+              "may_cancel": true,
+              "metadata": {},
+              "state": "initial",
+              "transaction_id": "cd390e83-a9de-404d-a660-4da0f1342c04",
+              "transaction_state": "initial",
+              "payout_method": {
+                "id": "b704e560-da50-4ff5-9bd7-b9499dba4b54",
+                "type": "NGN::Bank",
+                "details": {
+                  "bank_code": "082",
+                  "last_name": "Last",
+                  "first_name": "First",
+                  "bank_account": "123456789",
+                  "bank_account_type": "20"
+                },
+                "metadata": {},
+                "provider": "bitpesa_auto",
+                "fields": {
+                  "email": {
+                    "type": "input",
+                    "validations": {
+                      "format": "\\A((\\w+([\\-+.]\\w+)*@[a-zA-Z0-9]+([\\-\\.][a-zA-Z0-9]+)*)*){3,320}\\z"
+                    }
+                  },
+                  "first_name": {
+                    "type": "input",
+                    "validations": {
+                      "presence": true
+                    }
+                  },
+                  "last_name": {
+                    "type": "input",
+                    "validations": {
+                      "presence": true
+                    }
+                  },
+                  "bank_code": {
+                    "type": "select",
+                    "options": {
+                      "214": "FCMB Bank",
+                      "215": "Unity Bank",
+                      "232": "Sterling bank",
+                      "301": "Jaiz Bank",
+                      "044": "Access Bank",
+                      "063": "Diamond Bank",
+                      "050": "EcoBank",
+                      "070": "Fidelity Bank",
+                      "011": "First Bank of Nigeria",
+                      "058": "Guaranty Trust Bank",
+                      "030": "Heritage Bank",
+                      "082": "Keystone",
+                      "076": "Polaris Bank",
+                      "039": "Stanbic IBTC Bank",
+                      "032": "Union Bank",
+                      "033": "United Bank for Africa",
+                      "035": "Wema Bank",
+                      "057": "Zenith International"
+                    },
+                    "validations": {
+                      "presence": true,
+                      "inclusion": {
+                        "in": {
+                          "214": "FCMB Bank",
+                          "215": "Unity Bank",
+                          "232": "Sterling bank",
+                          "301": "Jaiz Bank",
+                          "044": "Access Bank",
+                          "063": "Diamond Bank",
+                          "050": "EcoBank",
+                          "070": "Fidelity Bank",
+                          "011": "First Bank of Nigeria",
+                          "058": "Guaranty Trust Bank",
+                          "030": "Heritage Bank",
+                          "082": "Keystone",
+                          "076": "Polaris Bank",
+                          "039": "Stanbic IBTC Bank",
+                          "032": "Union Bank",
+                          "033": "United Bank for Africa",
+                          "035": "Wema Bank",
+                          "057": "Zenith International"
+                        }
+                      }
+                    }
+                  },
+                  "bank_account": {
+                    "type": "input",
+                    "validations": {
+                      "presence": true
+                    }
+                  },
+                  "bank_account_type": {
+                    "type": "select",
+                    "options": {
+                      "10": "Savings",
+                      "20": "Current",
+                      "00": "Unknown"
+                    }
+                  }
+                }
+              },
+              "exchange_rate": 463.177396943029,
+              "fee_fractional": 64,
+              "requested_amount": 10000,
+              "requested_currency": "NGN",
+              "input_amount": 21.59,
+              "input_currency": "GBP",
+              "output_amount": 10000,
+              "output_currency": "NGN"
+            }
+          ],
+          "created_at": "2019-03-04T07:41:49.972Z",
+          "expires_at": "2019-03-07T07:41:49.972Z",
+          "traits": {}
+        }
+      }
+    JSON
+
+    webhook_api = Bitpesa::ApiClient.new
+    webhook = webhook_api.parse_response(webhook_content, "Webhook")
+
+    if webhook['event'].start_with?('transaction')
+      transaction_webhook = webhook_api.parse_response(webhook_content, 'TransactionWebhook')
+      puts transaction_webhook.object.to_s
+    elsif webhook['event'].start_with?('recipient')
+      recipient_webhook = webhook_api.parse_response(webhook_content, 'RecipientWebhook')
+      puts recipient_webhook.object.to_s
+    elsif webhook['event'].start_with?('payout_method')
+      payout_method_webhook = webhook_api.parse_response(webhook_content, 'PayoutMethodWebhook')
+      puts payout_method_webhook.object.to_s
+    elsif webhook['event'].start_with?('sender')
+      sender_webhook = webhook_api.parse_response(webhook_content, 'SenderWebhook')
+      puts sender_webhook.object.to_s
+    elsif webhook['event'].start_with?('document')
+      document_webhook = webhook_api.parse_response(webhook_content, 'DocumentWebhook')
+      puts document_webhook.object.to_s
+    else
+      puts webhook
+    end
+  end
+end
+
+CLIENT = Client.new(credentials)
+# client.list_currencies_example
+# client.account_validation_example
+# client.create_transaction_example
+# client.create_and_fund_transaction_example
+# client.webhook_parse_example

data/git_push.sh

@@ -0,0 +1,55 @@
+#!/bin/sh
+#
+# Generated by: https://openapi-generator.tech
+#
+# ref: https://help.github.com/articles/adding-an-existing-project-to-github-using-the-command-line/
+#
+# Usage example: /bin/sh ./git_push.sh wing328 openapi-pestore-perl "minor update"
+
+git_user_id=$1
+git_repo_id=$2
+release_note=$3
+
+if [ "$git_user_id" = "" ]; then
+    git_user_id="bitpesa"
+    echo "[INFO] No command line input provided. Set \$git_user_id to $git_user_id"
+fi
+
+if [ "$git_repo_id" = "" ]; then
+    git_repo_id="bitpesa-ruby-sdk"
+    echo "[INFO] No command line input provided. Set \$git_repo_id to $git_repo_id"
+fi
+
+if [ "$release_note" = "" ]; then
+    release_note="Minor update"
+    echo "[INFO] No command line input provided. Set \$release_note to $release_note"
+fi
+
+# Initialize the local directory as a Git repository
+git init
+
+# Adds the files in the local repository and stages them for commit.
+git add .
+
+# Commits the tracked changes and prepares them to be pushed to a remote repository.
+git commit -m "$release_note"
+
+# Sets the new remote
+git_remote=`git remote`
+if [ "$git_remote" = "" ]; then # git remote not defined
+
+    if [ "$GIT_TOKEN" = "" ]; then
+        echo "[INFO] \$GIT_TOKEN (environment variable) is not set. Using the git credential in your environment."
+        git remote add origin https://github.com/${git_user_id}/${git_repo_id}.git
+    else
+        git remote add origin https://${git_user_id}:${GIT_TOKEN}@github.com/${git_user_id}/${git_repo_id}.git
+    fi
+
+fi
+
+git pull origin master
+
+# Pushes (Forces) the changes in the local repository up to the remote repository
+echo "Git pushing to https://github.com/${git_user_id}/${git_repo_id}.git"
+git push origin master 2>&1 | grep -v 'To https'
+