openpay 0.9.8

data/.idea/dictionaries/ronnie.xml

@@ -0,0 +1,7 @@
+<component name="ProjectDictionaryState">
+  <dictionary name="ronnie">
+    <words>
+      <w>openpay</w>
+    </words>
+  </dictionary>
+</component>

data/.idea/encodings.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="Encoding" useUTFGuessing="true" native2AsciiForPropertiesFiles="false" />
+</project>
+

data/.idea/misc.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectRootManager" version="2" project-jdk-name="RVM: ruby-1.9.3-p362 [refinery]" project-jdk-type="RUBY_SDK" />
+</project>
+

data/.idea/modules.xml

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/OpenPay.iml" filepath="$PROJECT_DIR$/.idea/OpenPay.iml" />
+    </modules>
+  </component>
+</project>
+

data/.idea/runConfigurations/Run_spec__bankaccounts_spec___OpenPay.xml

@@ -0,0 +1,37 @@
+<component name="ProjectRunConfigurationManager">
+  <configuration default="false" name="Run spec 'bankaccounts_spec': OpenPay" type="RSpecRunConfigurationType" factoryName="RSpec">
+    <predefined_log_file id="RUBY_RSPEC" enabled="true" />
+    <module name="OpenPay" />
+    <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="RUBY_ARGS" VALUE="-e $stdout.sync=true;$stderr.sync=true;load($0=ARGV.shift)" />
+    <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="WORK DIR" VALUE="$MODULE_DIR$/test/spec" />
+    <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="SHOULD_USE_SDK" VALUE="false" />
+    <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="ALTERN_SDK_NAME" VALUE="" />
+    <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="myPassParentEnvs" VALUE="true" />
+    <envs>
+      <env name="JRUBY_OPTS" value="-X+O" />
+    </envs>
+    <EXTENSION ID="BundlerRunConfigurationExtension" bundleExecEnabled="true" />
+    <EXTENSION ID="JRubyRunConfigurationExtension" NailgunExecEnabled="false" />
+    <EXTENSION ID="RubyCoverageRunConfigurationExtension" enabled="false" sample_coverage="true" track_test_folders="true" runner="rcov">
+      <COVERAGE_PATTERN ENABLED="true">
+        <PATTERN REGEXPS="/.rvm/" INCLUDED="false" />
+      </COVERAGE_PATTERN>
+    </EXTENSION>
+    <EXTENSION ID="org.jetbrains.plugins.ruby.motion.run.MotionSimulatorRunExtension" />
+    <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="TESTS_FOLDER_PATH" VALUE="" />
+    <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="TEST_SCRIPT_PATH" VALUE="$MODULE_DIR$/test/spec/bankaccounts_spec.rb" />
+    <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="SPEC_RUNNER_PATH" VALUE="" />
+    <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="TEST_FILE_MASK" VALUE="**/*_spec.rb" />
+    <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="SPEC_EXAMPLE_NAME" VALUE="" />
+    <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="TEST_TEST_TYPE" VALUE="TEST_SCRIPT" />
+    <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="SPEC_ARGS" VALUE="" />
+    <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="RUNNER_VERSION" VALUE="" />
+    <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="USE_CUSTOM_SPEC_RUNNER" VALUE="false" />
+    <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="DRB" VALUE="false" />
+    <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="ZEUS" VALUE="false" />
+    <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="FULL_BACKTRACE" VALUE="false" />
+    <RunnerSettings RunnerId="RubyRunner" />
+    <ConfigurationWrapper RunnerId="RubyRunner" />
+    <method />
+  </configuration>
+</component>

data/.idea/runConfigurations/Run_spec__customers_spec___OpenPay.xml

@@ -0,0 +1,37 @@
+<component name="ProjectRunConfigurationManager">
+  <configuration default="false" name="Run spec 'customers_spec': OpenPay" type="RSpecRunConfigurationType" factoryName="RSpec">
+    <predefined_log_file id="RUBY_RSPEC" enabled="true" />
+    <module name="OpenPay" />
+    <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="RUBY_ARGS" VALUE="-e $stdout.sync=true;$stderr.sync=true;load($0=ARGV.shift)" />
+    <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="WORK DIR" VALUE="$MODULE_DIR$/test/spec" />
+    <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="SHOULD_USE_SDK" VALUE="false" />
+    <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="ALTERN_SDK_NAME" VALUE="" />
+    <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="myPassParentEnvs" VALUE="true" />
+    <envs>
+      <env name="JRUBY_OPTS" value="-X+O" />
+    </envs>
+    <EXTENSION ID="BundlerRunConfigurationExtension" bundleExecEnabled="true" />
+    <EXTENSION ID="JRubyRunConfigurationExtension" NailgunExecEnabled="false" />
+    <EXTENSION ID="RubyCoverageRunConfigurationExtension" enabled="false" sample_coverage="true" track_test_folders="true" runner="rcov">
+      <COVERAGE_PATTERN ENABLED="true">
+        <PATTERN REGEXPS="/.rvm/" INCLUDED="false" />
+      </COVERAGE_PATTERN>
+    </EXTENSION>
+    <EXTENSION ID="org.jetbrains.plugins.ruby.motion.run.MotionSimulatorRunExtension" />
+    <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="TESTS_FOLDER_PATH" VALUE="" />
+    <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="TEST_SCRIPT_PATH" VALUE="$MODULE_DIR$/test/spec/customers_spec.rb" />
+    <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="SPEC_RUNNER_PATH" VALUE="" />
+    <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="TEST_FILE_MASK" VALUE="**/*_spec.rb" />
+    <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="SPEC_EXAMPLE_NAME" VALUE="" />
+    <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="TEST_TEST_TYPE" VALUE="TEST_SCRIPT" />
+    <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="SPEC_ARGS" VALUE="" />
+    <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="RUNNER_VERSION" VALUE="" />
+    <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="USE_CUSTOM_SPEC_RUNNER" VALUE="false" />
+    <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="DRB" VALUE="false" />
+    <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="ZEUS" VALUE="false" />
+    <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="FULL_BACKTRACE" VALUE="false" />
+    <RunnerSettings RunnerId="RubyRunner" />
+    <ConfigurationWrapper RunnerId="RubyRunner" />
+    <method />
+  </configuration>
+</component>

data/.idea/runConfigurations/all_specs.xml

@@ -0,0 +1,41 @@
+<component name="ProjectRunConfigurationManager">
+  <configuration default="false" name="all_specs" type="RSpecRunConfigurationType" factoryName="RSpec">
+    <predefined_log_file id="RUBY_RSPEC" enabled="true" />
+    <module name="OpenPay" />
+    <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="RUBY_ARGS" VALUE="-e $stdout.sync=true;$stderr.sync=true;load($0=ARGV.shift)" />
+    <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="WORK DIR" VALUE="$MODULE_DIR$/test/spec" />
+    <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="SHOULD_USE_SDK" VALUE="false" />
+    <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="ALTERN_SDK_NAME" VALUE="" />
+    <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="myPassParentEnvs" VALUE="true" />
+    <envs>
+      <env name="JRUBY_OPTS" value="-X+O" />
+    </envs>
+    <EXTENSION ID="BundlerRunConfigurationExtension" bundleExecEnabled="true" />
+    <EXTENSION ID="JRubyRunConfigurationExtension" NailgunExecEnabled="false" />
+    <EXTENSION ID="RubyCoverageRunConfigurationExtension" enabled="false" sample_coverage="true" track_test_folders="true" runner="rcov">
+      <COVERAGE_PATTERN ENABLED="true">
+        <PATTERN REGEXPS="/.rvm/" INCLUDED="false" />
+      </COVERAGE_PATTERN>
+    </EXTENSION>
+    <EXTENSION ID="org.jetbrains.plugins.ruby.motion.run.MotionSimulatorRunExtension" />
+    <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="TESTS_FOLDER_PATH" VALUE="$MODULE_DIR$/test/spec" />
+    <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="TEST_SCRIPT_PATH" VALUE="" />
+    <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="SPEC_RUNNER_PATH" VALUE="" />
+    <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="TEST_FILE_MASK" VALUE="**/*_spec.rb" />
+    <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="SPEC_EXAMPLE_NAME" VALUE="" />
+    <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="TEST_TEST_TYPE" VALUE="ALL_IN_FOLDER" />
+    <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="SPEC_ARGS" VALUE="" />
+    <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="RUNNER_VERSION" VALUE="" />
+    <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="USE_CUSTOM_SPEC_RUNNER" VALUE="false" />
+    <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="DRB" VALUE="false" />
+    <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="ZEUS" VALUE="false" />
+    <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="FULL_BACKTRACE" VALUE="false" />
+    <RunnerSettings RunnerId="RubyCover" />
+    <RunnerSettings RunnerId="RubyDebugRunner" />
+    <RunnerSettings RunnerId="RubyRunner" />
+    <ConfigurationWrapper RunnerId="RubyCover" />
+    <ConfigurationWrapper RunnerId="RubyDebugRunner" />
+    <ConfigurationWrapper RunnerId="RubyRunner" />
+    <method />
+  </configuration>
+</component>

data/.idea/scopes/scope_settings.xml

@@ -0,0 +1,5 @@
+<component name="DependencyValidationManager">
+  <state>
+    <option name="SKIP_IMPORT_STATEMENTS" value="false" />
+  </state>
+</component>

data/.idea/vcs.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="$PROJECT_DIR$" vcs="Git" />
+  </component>
+</project>
+

data/Gemfile

@@ -0,0 +1,11 @@
+source 'https://rubygems.org'
+
+gem 'cucumber'
+gem 'rspec'
+gem 'rest-client'
+gem 'factory_girl'
+gem 'json_spec'
+
+
+# Specify your gem's dependencies in Openpay.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,13 @@
+Copyright 2014   Openpay SAPI de C.V.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

data/OpenPay.gemspec

@@ -0,0 +1,24 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'openpay/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "openpay"
+  spec.version       = Openpay::VERSION
+  spec.authors       = ["ronnie_bermejo"]
+  spec.email         =  ["ronnie.bermejo.mx@gmail.com"]
+  spec.description   = %q{ruby client for Openpay API services (version 1.0.0)}
+  spec.summary       = %q{ruby api for openpay resources}
+  spec.homepage      = "http://openpay.mx/"
+  spec.license       = "Apache"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec)/})
+  spec.require_paths = ["lib","lib/openpay"]
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+  spec.post_install_message = "Thanks for installing openpay. Enjoy !"
+end

data/README.md

@@ -0,0 +1,370 @@
+# openpay
+
+
+##Description
+
+ruby client for *Openpay api* services (version 1.0.0)
+
+This is a ruby client implementing the payment services for *Openpay* at openpay.mx
+
+For more information about Openpay visit:
+ - http://openpay.mx/
+
+For the full *Openpay api* documentation take a look at:
+ - http://docs.openpay.mx/
+
+## Installation
+
+   Add the following line to your Gem file
+
+   # gem install --source https://code.stripe.com stripe
+
+    gem 'openpay'
+
+Update your bundle:
+
+    $ bundle
+
+Or install it from the command line:
+
+    $ gem install openpay-1.0.0.gem
+
+###Requirements
+
+    * ruby 1.8.7 or higher
+
+## Usage
+
+
+### Initialization
+```ruby
+require 'openpay'
+
+
+#merchant and private key
+merchant_id='mywvupjjs9xdnryxtplq'
+private_key='sk_92b25d3baec149e6b428d81abfe37006'
+
+
+#An openpay resource factory instance is created out of the OpenpayApi
+#it  points to the development environment  by default.
+openpay=OpenpayApi.new(merchant_id,private_key)
+
+#To enable production mode you should pass a third argument as true.
+#openpay_prod=OpenPayApi.new(merchant_id,private_key,true)
+ ```
+
+The openpay factory instance is in charge to generate the required resources through a factory method (create).
+Resource classes should be initialized using the factory method as described below.
+
+ ```ruby
+#creating an instance for each available resource
+bankaccounts=openpay.create(:bankaccounts)
+cards=openpay.create(:cards)
+charges=openpay.create(:charges)
+customers=openpay.create(:customers)
+fees=openpay.create(:fees)
+payouts=openpay.create(:payouts)
+plans=openpay.create(:plans)
+subscriptions=openpay.create(:subscriptions)
+transfers=openpay.create(:transfers)
+```
+
+According to the current version of the *Openpay api* the available resources are:
+
+- *bankaccounts*
+- *cards*
+- *charges*
+- *customers*
+- *fees*
+- *payouts*
+- *plans*
+- *subscriptions*
+- *transfers*
+
+Each rest resource exposed in the rest *Openpay api* is represented by a class in this ruby API, being **OpenpayResource** the base class.
+
+
+### Implementation
+ Each resource depending of its structure and available methods, will have one or more of the methods described under the methods subsection.
+ Below a short description about the implementation high level details. For detailed documentation take a look a the openpay api documentation.
+
+
+#### Arguments
+Given most resources belong, either to a merchant or a customer, the api was designed taking this in consideration, so:
+
+The first argument represent the json/hash object, while the second argument which is optional represents the **customer_id**.
+So if  just one argument is provided the action will be performed at the merchant level,
+but if the second argument is provided passing the **customer_id**, the action will be performed at the customer level.
+
+
+The following illustrates the api design.
+
+ ```ruby
+#Merchant
+hash_out=open_pay_resource.create(hash_in)
+json_out=open_pay_resource.create(json_in)
+
+
+#Customer
+hash_out=open_pay_resource.create(hash_in,customer_id)
+json_out=open_pay_resource.create(json_in,customer_id)
+
+ ```
+
+
+####  Methods Inputs/Outputs
+
+This api supports both ruby hashes and json strings as inputs and outputs. (See previous example)
+If a ruby hash is passed in as in input, a hash will be returned as the method output.
+if a json string is passed in as an input, a json string will be returned as the method function output.
+
+This code excerpt from a specification demonstrates how you can use hashes and json strings  interchangeably.
+
+Methods without inputs will return a ruby hash.
+
+```ruby
+it 'creates a fee using a json message' do
+  #create new customer
+  customer_hash= FactoryGirl.build(:customer)
+  customer=@customers.create(customer_hash)
+
+  #create customer card   , using factory girl to build the hash for us
+  card_hash=FactoryGirl.build(:valid_card)
+  card=@cards.create(card_hash, customer['id'])
+
+  #create charge
+  charge_hash=FactoryGirl.build(:card_charge, source_id: card['id'], order_id: card['id'], amount: 4000)
+  charge=@charges.create(charge_hash, customer['id'])
+
+  #create customer fee , using json as input, we get json as ouput
+  fee_json =%^{"customer_id":"#{customer['id']}","amount":"12.50","description":"Cobro de Comisión"}^
+  expect(@fees.create(fee_json)).to have_json_path('amount')
+end
+```
+
+Here you can see how the **card_hash** representation looks like.
+
+```ruby
+require 'pp'
+pp card_hash   =>
+
+{:bank_name=>"visa",
+:holder_name=>"Vicente Olmos",
+:expiration_month=>"09",
+:card_number=>"4111111111111111",
+:expiration_year=>"14",
+:bank_code=>"bmx",
+:cvv2=>"111",
+:address=>
+{:postal_code=>"76190",
+:state=>"QRO",
+:line1=>"LINE1",
+:line2=>"LINE2",
+:line3=>"LINE3",
+:country_code=>"MX",
+:city=>"Queretaro"}}
+```
+
+Next, how we can construct  the preceding hash using **FactoryGirl**.
+**FactoryGirl** was used in our test suite to facilitate hash construction.
+It  may help you  as well at your final implementation if you decide to use hashes.
+(more examples at *test/Factories.rb*)
+
+```ruby
+
+FactoryGirl.define do
+  factory :valid_card, class:Hash do
+        bank_name  'visa'
+        holder_name 'Vicente Olmos'
+        expiration_month '09'
+        card_number '4111111111111111'
+        expiration_year '14'
+        bank_code 'bmx'
+        cvv2  '111'
+       address {{
+           postal_code: '76190',
+           state: 'QRO',
+           line1: 'LINE1',
+           line2: 'LINE2',
+           line3: 'LINE3',
+           country_code: 'MX',
+           city: 'Queretaro',
+       }}
+    initialize_with { attributes }
+  end
+```
+
+
+####API Methods
+
+This ruby API standardize the method names across all different resources using the **create**,**get**,**update** and **delete** verbs.
+
+For full method documentation take a look at:
+  - http://docs.openpay.mx/
+
+The test suite at *test/spec* is a good source of reference.
+
+#####create
+
+   Creates the given resource
+ ```ruby
+     open_pay_resource.create(representation,customer_id=nil)
+ ```
+
+#####get
+
+   Gets an instance of a  given resource
+
+```ruby
+open_pay_resource.get(object_id,customer_id=nil)
+```
+
+#####update
+
+   Updates an instance of a given resource
+
+```ruby
+open_pay_resource.update(representation,customer_id=nil)
+```
+
+#####delete
+
+  Deletes an instance of the given resource
+
+```ruby
+open_pay_resource.delete(object_id,customer_id=nil)
+```
+
+#####all
+   Returns an array of all instances of a resource
+```ruby
+open_pay_resource.all(customer_id=nil)
+```
+
+#####each
+   Returns a block for each instance resource
+```ruby
+open_pay_resource.each(customer_id=nil)
+ ```
+
+#####delete_all(available only under the development environment)
+
+   Deletes all instances of the given resource
+
+```ruby
+#in case this method is executed under the production environment an OpenpayException will be raised.
+open_pay_resource.delete_all(customer_id=nil)
+```
+
+
+#### Exceptions
+
+This API generates 3 different Exception classes.
+
+
+-  **OpenpayApiError**: Generic base api exception class, for generic api exceptions.
+
+     - Internal server error (500 Internal Server Error)
+     - OpenpayApi factory method, invalid resource name.
+
+    Example:
+
+     ```ruby
+      #production mode
+      openpayprod=OpenpayApi.new(@merchant_id,@private_key,true)
+      cust.delete_all # will raise an OpenpayException
+     ```
+
+-  **OpenpayApiConnectionError**: Exception class for connection related issues, errors happening prior  the server connection.
+
+     - Authentication Error (401 Unauthorized)
+     - Connection Errors.
+     - SSL Errors.
+
+    Example:
+     ```ruby
+     #invalid id and key
+     merchant_id='santa'
+     private_key='invalid'
+
+     openpay=OpenpayApi.new(merchant_id, private_key)
+     customers=openpay.create(:customers)
+
+      begin
+         customers.get('23444422211')
+      rescue OpenpayApiConnectionError => e
+         e.http_code  #  => 401
+         e.error_code # => 1002
+         e.description# => 'The api key or merchant id are invalid.'
+         e.json_body #  {"category":"request","description":"The api key or merchant id are invalid.","http_code":401,"error_code":1002,"request_id":null}
+       end
+     ```
+
+- **OpenpayApiTransactionError**: Errors happening after the initial connection has been initiated, errors during transactions.
+
+   - Bad Request (e.g. Malformed json,Invalid data)
+   - Unprocessable Entity (e.g. invalid data)
+   - Resource not found (404 Not Found)
+   - Conflict (e.g. resource already exists)
+   - PaymentRequired (e.g. insufficient funds)
+   - UnprocessableEntity ( e.g. stolen card )
+
+ *Bad Request* Example:
+
+```ruby
+email='foo'
+customer_hash = FactoryGirl.build(:customer, email: email)
+begin
+    customers.create(customer_hash)
+rescue OpenpayApiTransactionError => e
+    e.http_code# => 400
+    e.error_code# => 1001
+    e.description# => 'email\' not a well-formed email address'
+end
+  ```
+
+  *Resource not found* Example:
+
+```ruby
+begin
+  #non existing customer
+  customers.delete('1111')
+rescue OpenpayApiTransactionError => e
+  e.http_code# => 404
+  e.error_code# =>1005
+  e.description# =>"The customer with id '1111' does not exist"
+end
+```
+
+
+###These exceptions have the following attributes:
+
+- *category*
+- *description*
+- *http_code*
+- *error_code*
+- *json_message*
+
+For more information about categories, descriptions and codes take a look at:
+- http://docs.openpay.mx/#errores
+- http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html
+
+
+##Debug
+
+In the Openpay dashboard you are able to see every request and its corresponding request/response.
+    - https://sandbox-dashboard.openpay.mx
+
+
+##Developer Notes
+
+-  bank accounts for merchant cannot be created using the api. It should be done through the dashboard.
+
+
+
+## More information
+
+For more use cases take a look at the *test/spec* folder
+
+1.  http://docs.openpay.mx/