t2_airtime 0.1.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: c6e8d1b5cfa93a9f398cc58bd1089bfc128a0dd0
+  data.tar.gz: e75396f390b165e992e87e37d75557fb82a7c427
+SHA512:
+  metadata.gz: ae9a53249041d93c36146080f8cefa03052c5d90b32afe117d097f0333b68c835672a0aad09aefe1bdf0a61204a328371c52331a6bb1eb1010569aee16c2ff1d
+  data.tar.gz: 764234e7bfbfd290da1effb363c223ad7c21193df6e30c10ed5c200b674db654324ea18d2d2505cbf2e66adb5cf0032b9a3c0c50abc1e7b8ff010d82d8b40f99

data/.gitignore

@@ -0,0 +1,15 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+/bin/
+
+# rspec failure tracking
+.rspec_status
+
+.env

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/.travis.yml

@@ -0,0 +1,5 @@
+sudo: false
+language: ruby
+rvm:
+  - 2.3.3
+before_install: gem install bundler -v 1.15.4

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,74 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as
+contributors and maintainers pledge to making participation in our project and
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, gender identity and expression, level of experience,
+nationality, personal appearance, race, religion, or sexual identity and
+orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment
+include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or
+advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic
+  address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community. Examples of
+representing a project or community include using an official project e-mail
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event. Representation of a project may be
+further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project team at TODO: Write your email address. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. The project team is
+obligated to maintain confidentiality with regard to the reporter of an incident.
+Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
+available at [http://contributor-covenant.org/version/1/4][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/4/

data/Gemfile

@@ -0,0 +1,6 @@
+source "https://rubygems.org"
+
+git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
+
+# Specify your gem's dependencies in t2_airtime.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2017 matteolc
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,83 @@
+# TransferTo Airtime API
+
+TransferTo helps businesses offer airtime top-ups, goods and services, and mobile money around the world in real time.
+This API enables developers to integrate TransferTo Top-up service into their system. If you are building 
+application that leverages international recharge services, then this is the API for you. 
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 't2_airtime'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install t2_airtime
+
+## Usage
+
+### Retrieve your API Token
+Once  you  have  received  your  account  credentials  (login,  password)  to  access  the  TransferTo  web 
+interface, you must log in and retrieve your API token to be used with the TransferTo API.
+To activate access  to your API account, enable Two Factor Authentication  (2FA). 
+
+    TSHOP_USER=
+    TSHOP_SECRET=
+
+## Test
+
+Execute:
+
+    $ rspec
+
+    T2Airtime
+    has a version number
+    has the correct API URL
+    has 7 test numbers
+    responds to ping
+    checks wallet
+    checks number information
+    reserves a transaction id
+    returns a countries list
+    returns a country operators
+    returns an operator products
+    returns error code 0 for PIN based Top-up (successful transaction)
+    returns error code 0 for PIN less Top-up (successful transaction)
+    returns error code 204 (destination number is not a valid prepaid phone number) (FAILED - 1)
+    returns error code 301 (input value out of range or invalid product) (FAILED - 2)
+    returns error code 214 (transaction refused by the operator) (FAILED - 3)
+    returns error code 998 (system not available, please retry later) (FAILED - 4)
+    returns error code 999 (unknown error, please contact support) (FAILED - 5)
+    returns a transaction list    
+
+    Failed examples:
+
+    rspec ./spec/t2_airtime_spec.rb:99 # T2Airtime returns error code 204 (destination number is not a valid prepaid phone number)
+    rspec ./spec/t2_airtime_spec.rb:108 # T2Airtime returns error code 301 (input value out of range or invalid product)
+    rspec ./spec/t2_airtime_spec.rb:117 # T2Airtime returns error code 214 (transaction refused by the operator)
+    rspec ./spec/t2_airtime_spec.rb:126 # T2Airtime returns error code 998 (system not available, please retry later)
+    rspec ./spec/t2_airtime_spec.rb:135 # T2Airtime returns error code 999 (unknown error, please contact support)
+    
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/t2_airtime. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
+
+## Code of Conduct
+
+Everyone interacting in the T2Airtime project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/t2_airtime/blob/master/CODE_OF_CONDUCT.md).

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/lib/t2_airtime/api.rb

@@ -0,0 +1,290 @@
+module T2Airtime
+  class API < Base
+
+    # Test the connection to the Airtime API. Can be used for keep-alive.
+    def ping
+      run_action :ping
+    end
+
+    # Returns the balance in your TransferTo account. 
+    # This method shall not be used more than 24 times per day.     
+    def check_wallet
+      run_action :check_wallet
+    end    
+
+    # This method is used to recharge a destination number with a specified
+    # denomination (“product” field).
+    # This is the API’s most important action as it is required when sending
+    # a topup to a prepaid account phone numberin a live! environment.
+    #
+    # parameters
+    # ==========
+    # msisdn
+    # ------
+    # The international phone number of the user requesting to credit
+    # a TransferToAPI phone number. The format must contain the country code,
+    # and will be valid with or without the ‘+’ or ‘00’ placed before it. For
+    # example: “6012345678” or “+6012345678” or “006012345678” (Malaysia) are
+    # all valid.
+    #
+    # product
+    # -------
+    # This field is used to define the remote product(often, the same as the
+    # amount in destination currency) to use in the request.
+    #
+    # destination
+    # -----------
+    # This is the destination phone number that will be credited with the
+    # amount transferred. Format is similar to “msisdn”.
+    #
+    # operator_id
+    # -----------
+    # It defines the operator id of the destination MSISDN that must be used
+    # when treating the request. If set, the platform will be forced to use
+    # this operatorID and will not identify the operator of the destination
+    # MSISDN based on the numbering plan. It must be very useful in case of
+    # countries with number portability if you are able to know the destination
+    # operator. 
+
+    # Most receiving operators (or carriers) are PIN less (direct top-up), meaning that the mobile phone of the 
+    # recipient is recharged in real time. A few operators are however PIN based (mostly in the USA and UK). 
+    # For  these  PIN  based  operators, a  PIN  code is  sent  by SMS  to  the  recipient, who  then  has  to manually 
+    # complete the recharge process (usually by calling an IVR to redeem the PIN).
+
+    # Name Type Description
+    # pin_based String Returns “Yes” if PIN-based transactions. Else “No”.
+    # pin_option_1 String Additional information. For example, it can describe how to use 
+    # the PIN directly from handset (by entering a dedicated USSD code).
+    # pin_option_2 String Additional information. For example, it can provide the operator refill website.
+    # pin_option_3 String Additional information. For example, it can provide the operator refill call center.
+    # pin_value Integer Value of the PIN.
+    # pin_code Alphanumeric String Code of the PIN.
+    # pin_ivr Integer IVR number of the PIN.
+    # pin_serial Alphanumeric String Serial number of the PIN.
+    # pin_validity String Validity of the PIN
+    
+    # By default, an SMS notification is sent to the recipient after every successful Top-up.
+    # The default originating address for the SMS is “8888”.
+    # The following is the default SMS which is translated into local languages for most of recipient countries:
+    # Congratulations! You've received 
+    # AMOUNT_CURRENCY from SENDER. Thank you for using
+    # TransferTo. FREE_TEXT. 
+    # • AMOUNT  CURRENCY  is  the  amount  that  has 
+    # been sent with the currency.
+    # • SENDER can be a name or a phone number.
+    # • FREE_TEXT  is  the  content  of  the  field  named 
+    # “sms” of the topup method.     
+
+    def topup(msisdn, destination_msisdn, product, method='topup',
+              reserved_id=nil, send_sms=true, sms=nil, sender_text=nil, operator_id=nil, 
+              return_service_fee=1, delivered_amount_info=1, return_timestamp=1, return_version=1,
+              return_promo=0)
+
+      @params     = { 
+          msisdn: msisdn, 
+          destination_msisdn: destination_msisdn, 
+          product: product 
+      }
+      self.oid = operator_id
+
+      @params.merge({
+        cid1: "", cid2: "", cid3: "",
+        reserved_id: reserved_id,
+        sender_sms: (sender_text ? "yes" : "no"),
+        send_sms: (send_sms ? "yes" : "no"),
+        sms: sms,
+        sender_text: sender_text,
+        delivered_amount_info: delivered_amount_info,
+        return_service_fee: return_service_fee,
+        return_timestamp: return_timestamp,
+        return_version: return_version,
+        return_promo: return_promo
+      })
+
+      run_action method
+      #{
+      #  requesting_msisdn:         response[:msisdn],
+      #  destination_msisdn:        response[:destination_msisdn],       
+      #  product_sent:              response[:actual_product_sent].to_i,
+      #  local_amount:              response[:local_info_amount],
+      #  local_value:               response[:local_info_value],
+      #  local_currency_code:       response[:local_info_currency],       
+      #  transaction_status:        response[:error_txt], 
+      #  operation_result:          response[:error_code],
+      #  operation_info:            response[:info_txt],       
+      #  transaction_api_id:        response[:transactionid].to_i,
+      #  country_api_id:            response[:countryid].to_i,
+      #  operator_api_id:           response[:operatorid].to_i,
+      #  product_api_id:            response[:product_requested].to_i,       
+      #  originator_currency_code:  response[:originating_currency],
+      #  destination_currency_code: response[:destination_currency],       
+      #  wholesale_price:           response[:wholesale_price],
+      #  retail_price:              response[:retail_price],
+      #  service_fee:               response[:service_fee]
+      #}       
+    end
+
+    # This method is used to retrieve various information of a specific MSISDN
+    # (operator, country…) as well as the list of all products configured for
+    # your specific account and the destination operator of the MSISDN.
+    # Returns relevant information on a MSISDN (operator, country…) as well as the 
+    # list of products configured for your account and the destination operator 
+    # linked to that MSISDN. Allows to check if a MSISDN is subjected to a promotion
+    #
+    # destination_msisdn
+    # Destination MSISDN (usually recipient phone number). This is the destination phone number that will 
+    # be credited with the amount transferred. Format is similar to “msisdn” and restricted to international phone number only.     
+    # delivered_amount_info
+    # Setting this to “1” will return the fields local_info_amount_list,local_info_currency and local_info_value_list in the API response. 
+    # Blank or “no” if you do not want this returned.
+    # return_service_fee 
+    # Setting this to “1” will return the field service_fee_list in the API response. Blank or “0” if you do not want it returned.
+    # operatorid
+    # Operator ID of the receiving operator that must be used when treating the request. If 
+    # set, the platform will be forced to use this operator ID and will not identify the operator of 
+    # the destination MSISDN based on the numbering plan. It is very useful in case of countries with number
+    # portability if you are able to know the destination operator.        
+    # return_promo
+    # Setting this to “1” will return the current  promotion related to the transaction’s operator.    
+    def msisdn_info(destination_msisdn, operator_id=nil, 
+                    delivered_amount_info=1, return_service_fee=1, return_promo=1)
+      @params = {
+        destination_msisdn: destination_msisdn,
+        delivered_amount_info: delivered_amount_info,
+        return_service_fee: return_service_fee,
+        return_promo: return_promo
+      }
+      self.oid = operator_id
+      run_action :msisdn_info
+    end
+
+    # Get information about a phone number
+    def phone_search(number, operator_id=nil)
+      information = msisdn_info(number, operator_id).information
+      information[:product_list] = information[:product_list].split(",")
+      information
+    end    
+    
+    # This method is used to reserve an ID in the system. This ID can then be
+    # used in the “topup” or “simulation” requests.
+    # This way, your system knows the ID of the transaction before sending the
+    # request to TransferTo (else it will only be displayed in the response).   
+    def reserve_id
+      run_action :reserve_id
+    end    
+
+    # This method is used to retrieve the list of transactions performed within
+    # the date range by the MSISDN if set. Note that both dates are included
+    # during the search.
+    #
+    # parameters
+    # ==========
+    # msisdn
+    # ------
+    # The format must be international with or without the ‘+’ or ‘00’:
+    # “6012345678” or “+6012345678” or “006012345678” (Malaysia)
+    #
+    # destination_msisdn
+    # ------------------
+    # The format must be international with or without the ‘+’ or ‘00’:
+    # “6012345678” or “+6012345678” or “006012345678” (Malaysia)
+    #
+    # code
+    # ----
+    # The error_code of the transactions to search for. E.g “0” to search for
+    # only all successful transactions. If left empty, all transactions will be
+    # returned(Failed and successful).
+    #
+    # start_date
+    # ----------
+    # Defines the start date of the search. Format must be YYYY-MM-DD.
+    #
+    # stop_date
+    # ---------
+    # Defines the end date of the search (included). Format must be YYYY-MM-DD.
+    def trans_list(start, stop, msisdn = nil, destination = nil, code = nil)
+      @params[:code]               = code unless code
+      @params[:msisdn]             = msisdn unless msisdn
+      @params[:stop_date]          = to_yyyymmdd(stop)
+      @params[:start_date]         = to_yyyymmdd(start)
+      @params[:destination_msisdn] = destination unless destination
+      run_action :trans_list
+    end
+
+    # Retrieve available information on a specific transaction. Please note that values of “input_value” and
+    # “debit_amount_validated” are rounded to 2 digits after the comma but are
+    # the same as the values returned in the fields “input_value” and
+    # “validated_input_value” of the “topup” method response.        
+    def trans_info(id)
+      @params = { transactionid: id }
+      run_action :trans_info
+    end    
+
+    # This method is used to retrieve the ID of a transaction previously
+    # performed based on the key used in the request at that time.
+    def get_id_from_key(key)
+      @params = { from_key: key }
+      run_action :get_id_from_key
+    end    
+
+    # These methods are used to retrieve coverage and pricelist offered to you.
+    # parameters
+    # ==========
+    # info_type
+    # ---------
+    #   i) “countries”: Returns a list of all countries offered to you
+    #  ii) “country”  : Returns a list of operators in the country
+    # iii) “operator” : Returns a list of wholesale and retail price for the operator
+    #
+    # content
+    # -------
+    #   i) Not used if info_type = “countries”
+    #  ii) countryid of the requested country if info_type = “country”
+    # iii) operatorid of the requested operator if info_type = “operator”
+
+    def price_list(info_type, content=nil)
+      @params[:info_type] = info_type
+      content && @params[:content] = content
+      run_action :pricelist
+    end
+
+    def country_list
+      price_list('countries')           
+    end
+
+    def operator_list(country_api_id)
+      price_list('country', country_api_id)       
+    end 
+        
+    def product_list(operator_api_id)
+      price_list('operator', operator_api_id)       
+    end 
+
+    # Operator Logo URL
+    def operator_logo_url(operator_id, size=1)
+      "#{T2Airtime::PROTOCOL}://#{T2Airtime::OPLOGO_DN}.#{T2Airtime::DOMAIN}/logo-#{operator_id}-#{size}.png"    
+    end     
+
+    private
+
+    def oid=(operator_id)
+      @params[:operatorid] = operator_id.to_i if operator_id.is_a?(Integer)
+    end
+
+    def to_time(time)
+      case time.class.name
+      when "String"  then return Time.parse(time)
+      when "Integer" then return Time.at(time)
+      when "Time"    then return time
+      else raise ArgumentError
+      end
+    rescue
+      Time.now
+    end
+
+    def to_yyyymmdd(time)
+      to_time(time).strftime("%Y-%m-%d")
+    end    
+
+  end
+end

data/lib/t2_airtime/base.rb

@@ -0,0 +1,26 @@
+module T2Airtime
+  class Base
+
+    def initialize(user, password, url)      
+      @user, @password, @url, @params = user, password, url, {}
+    end
+
+    def self.api
+        @api ||= new(
+          ENV['T2_SHOP_USER'], 
+          ENV['T2_AIRTIME_KEY'],
+          "https://#{T2Airtime::AIRTIME_DN}.#{T2Airtime::DOMAIN}/#{T2Airtime::ENDPOINT}"
+        )
+    end
+
+    def run_action(name, method=:get)
+      request = T2Airtime::Request.new(@user, @password, @url, name, @params)
+      request.run(method).on_complete do |reply|
+        reply = T2Airtime::Reply.new(reply)
+        #raise ::T2Airtime::Error.new @reply.error_code, @reply.error_message unless @reply.success?
+        return reply.data
+      end
+    end
+    
+  end
+end

data/lib/t2_airtime/errors.rb

@@ -0,0 +1,89 @@
+module T2Airtime
+  # 0 	  Transaction successful	 											    Indicates the Top-up was successfully delivered to the recipient.
+  # 101 	Destination MSISDN out of range 									Numbering plan not recognized: the destination/recipient number was not identified as to belonging to any operators covered by TransferTo. Re-check recipient number and/or escalate the case to the TransferTo Support Team for further investigation.
+  # 104 	MSISDN in blacklist 												      Here MSISDN refers to both sender and recipient phone numbers which are blacklisted due to fraudulent activities.
+  # 105 	Not enough credit on your account									Transaction failed due to insufficient funds in your account's prepaid balance. Please reload balance and try again.
+  # 200 	Transaction canceled by Customer	                				
+  # 202 	Transaction canceled by TransferTo	                				
+  # 203 	Transaction incomplete 												    Transaction failed due to a technical issue. Please contact TransferTo Support Team for further investigation.
+  # 204 	Destination Account is not prepaid or not valid		Transaction refused by the operator because the recipient phone number is not a valid prepaid account.
+  # 207 	Transaction amount limit exceeded									Here limit refers to maximum amount defined for the destination MSISDN. There are some limitations set on the operator's side, not controlled by TransferTo. When one of these limits is reached, error code 207 will be returned. Some examples: 
+  #           •	Indosat Indonesia operator's end, the customer must wait at least 5 mins before sending another transfer to the same recipient account. 
+  #           •	Indian operators' end, the customer must wait 3 mins before sending another transfer of the same amount to the same recipient account. 
+  #           •	Orange Africa, the recipient account is limited to a maximum rechargeable amount of 30 Euros per week and 60 Euros per month.
+  # 213 	Duplicated transaction 												    Transaction refused because it was submitted too closely after a preceding Top-up attempt.
+  # 214 	Topup refused 														        Transaction refused by the operator for a reason that was not specified. Common reasons for these types of failures are: Recipient number not valid for recharge. Service outage temporarily faced on the operator. Please try again at a later time and/or contact the TransferTo Support Team if the problem persists.
+  # 215 	Service to this destination operator is        		Transaction failed due to an outage and/or connection issue with the operator. Please try again at a later time and/or contact the TransferTo Support Team if the problem persists.
+  #       temporarily unavailable
+  # 216 	Destination number not activated									Transaction refused by the operator because the recipient number has not been activated.
+  # 217 	Destination number expired 											  Transaction refused by the operator because the recipient number is no longer an active account.
+  # 218 	Request timeout 													        Transaction timed-out and failed because of the long processing duration. Please try again at a later time and/or contact the TransferTo Support Team if the problem persists.
+  # 219 	Key does not exist 													      Request failed because the key provided does not exist (error returned for get_id_from_key method requests only).
+  # 221 	Fraud suspicion 													        Transaction refused and the recipient number flagged for suspicion of fraud, due to the number of consecutive Top-up requests within a short gap of time. The recipient phone number will be locked out from receiving any Top-up for a certain period of time, after which, the restriction will be automatically released.
+  # 222 	Number barred from refill 											  This error code is returned when the recipient has been blocked from refill directly by the recipient's operator. It prevents TransferTo system from reloading his account. Recipient must call the operator’s customer service to unblock it.
+  # 223 	ID not reserved 													        Transaction failed because the transaction ID specified in the request was not previously reserved.
+  # 224 	Invalid length of destination MSISDN							Transaction failed because the recipient number length does not match (shorter or longer) the mobile number format of the country.
+  # 230 	Recipient reached maximum topup number						This error is returned when a recipient reaches the maximum number of Top-up allowable in a certain gap of time. 
+  #           •	01 Day(s) => 10 
+  #           •	07 Day(s) => 15
+  #           •	30 Day(s) => 40
+  # 231 	Recipient reached maximum topup amount						This error is returned when a recipient reaches the maximum amount (in USD) of Top-up allowable in a certain gap of time. 
+  #           •	01 Day(s) => max 100 USD                    					
+  #           •	07 Day(s) => max 150 USD                    					 
+  #           •	30 Day(s) => max 200 USD                    					
+  # 232 	Account reached maximum topup number							This error is returned when your account has reached its maximum number of Top-up allowable in a certain gap of time.
+  # 233 	Account reached maximum topup amount							This error is returned when your account has reached its maximum amount (in USD) of Top-up allowable in a certain gap of time.
+  # 241 	Account reached maximum daily topup amount				This error is returned when your account has reached its maximum amount (in USD) of Top-up allowable within a day.
+  # 242 	Account reached maximum daily topup number				This error is returned when your account has reached its maximum number of Top-up allowable within a day. 
+  # 243 	Account reached maximum weekly topup amount				This error is returned when your account has reached its maximum amount (in USD) of Top-up allowable within a week.
+  # 244	  Account reached maximum weekly topup number				This error is returned when your account has reached its maximum number of Top-up allowable within a week.
+  # 245 	Account reached maximum monthly topup amount			This error is returned when your account has reached its maximum amount (in USD) of Top-up allowable within a month.
+  # 246 	Account reached maximum monthly topup number			This error is returned when your account has reached its maximum number of Top-up allowable within a month.
+  # 251 	Sender reached maximum daily topup amount					This error is returned when the sender has reached its maximum amount (in USD) of Top-up allowable within a day.
+  # 252 	Sender reached maximum daily topup number					This error is returned when the sender has reached its maximum number of Top-up allowable within a day.
+  # 253 	Sender reached maximum weekly topup amount				This error is returned when the sender has reached its maximum amount (in USD) of Top-up allowable within a week.
+  # 254 	Sender reached maximum weekly topup number				This error is returned when the sender has reached its maximum number of Top-up allowable within a week.
+  # 255 	Sender reached maximum monthly topup amount				This error is returned when the sender has reached its maximum amount (in USD) of Top-up allowable within a month.
+  # 256 	Sender reached maximum monthly topup number				This error is returned when the sender has reached its maximum number of Top-up allowable within a day month.
+  # 301 	Denomination not available 											  Denomination not available for this destination.
+  # 310 	Denomination blocked 												      Transaction failed because the Top-up is no longer available on the operator's offer or on the account.
+  # 320 	Requested amount out of range 										Transaction failed because the Top-amount request was not within the range of valid amounts.
+  # 321 	Requested currency not allowed for this account		Transaction failed because the currency specified is not valid for the account.
+  # 401 	Transaction ID not found or was not made     			No transaction was found with the ID specified (error returned for trans_info method requests only).
+  #       by your account
+  # 777 	Insufficient balance in your master account				Transaction failed because there are not enough funds in your master account.
+  # 888 	Insufficient balance in your subaccount						Transaction failed because there are not enough funds in your sub-account.
+  # 900 	Not enough information to process the topup				Transaction failed because some of the required fields in your Top-up request are missing/empty.
+  # 901 	Invalid action 												        		Transaction failed because the action specified in <action> field of the request is not valid.
+  # 902 	Invalid input_currency	
+  # 903 	Invalid output_currency	
+  # 904 	Invalid input_value	
+  # 905 	Invalid start_date	
+  # 906 	Invalid stop_date	
+  # 907 	Invalid transaction ID 											    	Transaction ID specified in the <reserved_id> of the Top-up request is not valid.
+  # 908 	Account not configured for this service						Transaction failed because the account is not configured to carry out the requested action.
+  # 909 	Invalid flag 											          			Transaction failed because the request included an invalid field/parameter.
+  # 919 	All required argument not received								Transaction failed because the request is missing a mandatory field/parameter.
+  # 921 	Wrong MD5 encoding 													      Transaction failed because the MD5 hash was not correct. Typically indicates that the password is incorrect.
+  # 922 	Originating IP not allowed 							  				Transaction failed because the request originated from an IP that is not whitelisted for the account.
+  # 923 	Key already used or invalid key value							Transaction failed because the key value included in the request was not unique and greater than the previous key used.
+  # 926 	Account not active	 											      	Please contact your Account Manager.	
+  # 995 	Account not found	  												      Please enter and use a correct login.	
+  # 998 	System not available. Please retry later.					Transaction failed due to technical issues. Please contact TransferTo Support Team for further investigation.
+  # 999 	Unknown error 												        		To be escalated to the TransferTo Support Team for further investigation.
+    
+  
+  class Error < StandardError
+
+    attr_reader :code
+    
+    def initialize(code, message=nil)
+      @code = code.to_i
+      super(message)    
+    end        
+      
+  end
+
+  class ConfigurationError < StandardError; end
+
+end

data/lib/t2_airtime/reply.rb

@@ -0,0 +1,58 @@
+module T2Airtime
+  class Reply
+    
+    def initialize(reply)
+      @response = reply.to_hash
+    end
+
+    def data
+      hash = {}
+      @response[:body].lines.each do |line|
+        key, value = line.strip.split "="
+        hash[key.to_sym] = (key == "error_code") ? value.to_i : value
+      end; hash
+    end
+
+    def status
+      @response[:status]
+    end
+
+    def error_code
+      data[:error_code]
+    end
+
+    def error_message
+      data[:error_txt]
+    end
+
+    def success?
+      status == 200 && error_code == 0
+    end
+
+    def url
+      @response[:url].to_s
+    end
+
+    def information
+      data.reject do |key, value|
+        [:authentication_key, :error_code, :error_txt].include?(key)
+      end
+    end
+
+    def message
+      information[:info_txt]
+    end
+
+    def auth_key
+      data[:authentication_key]
+    end
+
+    def headers
+      @response[:response_headers]
+    end
+
+    def raw
+      @response[:body]
+    end
+  end
+end

data/lib/t2_airtime/request.rb

@@ -0,0 +1,73 @@
+module T2Airtime
+  class Request
+
+    def initialize(user, password, url, name, params)
+      @user   = user
+      @pass   = password
+      @conn = Faraday.new(url: url) do |faraday|
+        faraday.request  :url_encoded
+        faraday.adapter  :net_http        
+      end
+      reset
+      @name = name
+      add_param :action, name
+      @params.merge!(params)     
+    end
+
+    def reset
+      @params = {}
+      authenticate
+    end
+
+    def authenticate
+      time = Time.now.to_i.to_s
+      add_param :key,   time
+      add_param :md5,   md5_hash(@user + @pass + time)
+      add_param :login, @user
+    end
+
+    def add_param(key, value)
+      @params[key.to_sym] = value
+    end
+
+    def key
+      @params[:key]
+    end
+
+    def get?
+      @params[:method] == :get
+    end
+
+    def post?
+      @params[:method] == :post
+    end
+
+    # More than 99.5% of the transactions are currently processed within a few seconds. 
+    # However, it may happen in some rare cases that a transaction takes longer to be processed by the receiving
+    # operator due to congested system on their end for instance.
+    # TransferTo guarantees that transactions not processed within 600 seconds will not be charged, whatever 
+    # the final status of the transaction (successful or not). In addition, TransferTo is operating a real time system;
+    # therefore, the status returned in the Top-up response is final and will not change.
+    # To  ensure  that  your  system  captures  successfully  the  status  of  all  transactions  especially  the  longest 
+    # ones, it is advised to either set up a high timeout value of 600seconds to be on the safe side (TCP connection
+    # could potentially be opened for a long time in this case) or to set up a mechanism to check on 
+    # the status (to do so, you can call the trans_info method to retrieve the final status of a transaction).
+    # In case of timeout, both methods reserve_id and get_id_from_key of the API could be useful to identify 
+    # the ID of the transaction (we recommend to either send a reserve_id request and to use the ID returned 
+    # in the response in the subsequent top-up request so that you know in advance the ID of the transaction).    
+    def run(method = :get)
+      add_param :method, method
+      @conn.send(method, "/#{T2Airtime::ENDPOINT}", @params) do |req|
+        req.options = { timeout: 600, open_timeout: 600 }
+      end
+    end
+
+    private
+
+    def md5_hash(str)
+      (Digest::MD5.new << str).to_s
+    end
+
+
+  end
+end

data/lib/t2_airtime/rest.rb

@@ -0,0 +1,67 @@
+module T2Airtime
+
+  class Country
+
+    def self.all
+        serialize_reply(T2Airtime::API.api.country_list)
+    end
+
+    def self.serialize_reply(reply)
+        names = reply[:country].split(",") 
+        ids = reply[:countryid].split(",")
+        ids.each_with_index.map{|id, n| {
+          name: names[n], 
+          aid: Integer(id)
+        }}
+    end
+    
+  end
+
+  class Operator
+
+    def self.all
+        countries = T2Airtime::Country.all
+        countries.flat_map{|country| serialize_reply(T2Airtime::API.api.operator_list(country[:aid]))}        
+    end
+
+    def self.serialize_reply(reply)
+         names = reply[:operator].split(",") 
+         ids = reply[:operatorid].split(",")
+         ids.each_with_index.map{|id, n| {
+           country: reply[:country], 
+           country_aid: Integer(reply[:countryid]),
+           name: names[n], 
+           aid: Integer(id)
+         }}
+    end
+    
+  end
+
+  class Product
+
+    def self.all
+        operators = T2Airtime::Operator.all
+        operators.flat_map{|operator| serialize_reply(T2Airtime::API.api.product_list(operator[:aid]))}        
+    end
+
+    def self.serialize_reply(reply)
+         currency = reply[:destination_currency]
+         retail_prices = reply[:retail_price_list].split(",") 
+         wholesale_prices = reply[:wholesale_price_list].split(",")
+         ids = reply[:product_list].split(",")
+         ids.each_with_index.map{|id, n| {
+           country: reply[:country], 
+           country_aid: Integer(reply[:countryid]),
+           operator: reply[:operator], 
+           operator_aid: Integer(reply[:operatorid]),           
+           name: "#{id}#{currency}", 
+           currency: currency,
+           retail_price: retail_prices[n],
+           wholesale_price: wholesale_prices[n],
+           aid: Integer(id)
+         }}
+    end
+    
+  end  
+  
+end

data/lib/t2_airtime/test.rb

@@ -0,0 +1,21 @@
+module T2Airtime
+  class Test
+
+    # A few fake phone numbers in Indonesia have been created and set up with available products of IDR 5000, 10000, 20000, 50000 and 100000:  
+    # 628123456710: error code 0 for PIN based Top-up (successful transaction).
+    # 628123456770: error code 0 for PIN less Top-up (successful transaction).
+    # 628123456780: error code 204 (destination number is not a valid prepaid phone number).
+    # 628123456781: error code 301 (input value out of range or invalid product).
+    # 628123456790: error code 214 (transaction refused by the operator).
+    # 628123456798: error code 998 (system not available, please retry later).
+    # 628123456799: error code 999 (unknown error, please contact support).
+
+    def self.numbers(num=0)
+      numbers = [ "628123456710", "628123456770", "628123456780",
+                  "628123456781", "628123456790", "628123456798",
+                  "628123456799" ]
+      num > 0 && num < 8 ? numbers[num-1] : numbers
+    end 
+
+  end
+end

data/lib/t2_airtime/url.rb

@@ -0,0 +1,6 @@
+module T2Airtime
+  DOMAIN = "transferto.com"
+  AIRTIME_DN = "airtime"
+  OPLOGO_DN = "operator-logo"
+  ENDPOINT = "cgi-bin/shop/topup"
+end

data/lib/t2_airtime/version.rb

@@ -0,0 +1,3 @@
+module T2Airtime
+  VERSION = "0.1.2"
+end

data/lib/t2_airtime.rb

@@ -0,0 +1,16 @@
+require 'dotenv'
+Dotenv.load
+require "faraday"
+require "net/http"
+
+require "t2_airtime/version"
+require "t2_airtime/url"
+require "t2_airtime/errors"
+require "t2_airtime/request"
+require "t2_airtime/reply"
+require "t2_airtime/base"
+require "t2_airtime/api"
+require "t2_airtime/test"
+require "t2_airtime/rest"
+
+module T2Airtime; end

data/t2_airtime.gemspec

@@ -0,0 +1,31 @@
+# coding: utf-8
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "t2_airtime/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "t2_airtime"
+  spec.version       = T2Airtime::VERSION
+  spec.authors       = ["matteolc"]
+  spec.email         = ["matteo@voxbox.io"]
+
+  spec.summary       = "Wrapper methods to interface with [TransferTo](https://www.transfer-to.com/home) Airtime API"
+  spec.description   = "Wrapper methods to interface with [TransferTo](https://www.transfer-to.com/home) Airtime API"
+  spec.homepage      = "https://github.com/matteolc/t2_airtime"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.15"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec", "~> 3.0"
+
+  spec.add_runtime_dependency 'dotenv-rails', '~> 2.2', '>= 2.2.1'
+  spec.add_dependency "faraday", "0.9.1"
+
+end

metadata

@@ -0,0 +1,141 @@
+--- !ruby/object:Gem::Specification
+name: t2_airtime
+version: !ruby/object:Gem::Version
+  version: 0.1.2
+platform: ruby
+authors:
+- matteolc
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2017-08-26 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.15'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.15'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: dotenv-rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.2'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.2.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.2'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.2.1
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.9.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.9.1
+description: Wrapper methods to interface with [TransferTo](https://www.transfer-to.com/home)
+  Airtime API
+email:
+- matteo@voxbox.io
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- CODE_OF_CONDUCT.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/t2_airtime.rb
+- lib/t2_airtime/api.rb
+- lib/t2_airtime/base.rb
+- lib/t2_airtime/errors.rb
+- lib/t2_airtime/reply.rb
+- lib/t2_airtime/request.rb
+- lib/t2_airtime/rest.rb
+- lib/t2_airtime/test.rb
+- lib/t2_airtime/url.rb
+- lib/t2_airtime/version.rb
+- t2_airtime.gemspec
+homepage: https://github.com/matteolc/t2_airtime
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.5.2
+signing_key: 
+specification_version: 4
+summary: Wrapper methods to interface with [TransferTo](https://www.transfer-to.com/home)
+  Airtime API
+test_files: []