paymob_accept 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml ADDED
@@ -0,0 +1,7 @@
1
+ ---
2
+ SHA256:
3
+ metadata.gz: 519375883a2c35dd6406dc2aee7e471f3525905ded1faee4c286d9d4518014aa
4
+ data.tar.gz: dbb89c1765419b3114e0366302494097dae654d13fc9d0bdf20794420230b07e
5
+ SHA512:
6
+ metadata.gz: 0e9bb8812b46f509a9ccbb96bfc97a140726fb360e044980eec42bad30828575e457361ba5a61df608324021bdf58424815c7ef828dad7909322b20ffdaae3a4
7
+ data.tar.gz: 7d2811bd93ee7c9a43492c984fa8a5c237929b64ad1f3393bb528f24f489d666427fccff34d15d914f55002e8e52cbce7501b7efa1aad9006b03467fafde577d
data/.gitignore ADDED
@@ -0,0 +1,11 @@
1
+ /.bundle/
2
+ /.yardoc
3
+ /_yardoc/
4
+ /coverage/
5
+ /doc/
6
+ /pkg/
7
+ /spec/reports/
8
+ /tmp/
9
+
10
+ # rspec failure tracking
11
+ .rspec_status
data/.rspec ADDED
@@ -0,0 +1,3 @@
1
+ --format documentation
2
+ --color
3
+ --require spec_helper
data/.travis.yml ADDED
@@ -0,0 +1,6 @@
1
+ ---
2
+ language: ruby
3
+ cache: bundler
4
+ rvm:
5
+ - 2.7.2
6
+ before_install: gem install bundler -v 2.1.4
@@ -0,0 +1,74 @@
1
+ # Contributor Covenant Code of Conduct
2
+
3
+ ## Our Pledge
4
+
5
+ In the interest of fostering an open and welcoming environment, we as
6
+ contributors and maintainers pledge to making participation in our project and
7
+ our community a harassment-free experience for everyone, regardless of age, body
8
+ size, disability, ethnicity, gender identity and expression, level of experience,
9
+ nationality, personal appearance, race, religion, or sexual identity and
10
+ orientation.
11
+
12
+ ## Our Standards
13
+
14
+ Examples of behavior that contributes to creating a positive environment
15
+ include:
16
+
17
+ * Using welcoming and inclusive language
18
+ * Being respectful of differing viewpoints and experiences
19
+ * Gracefully accepting constructive criticism
20
+ * Focusing on what is best for the community
21
+ * Showing empathy towards other community members
22
+
23
+ Examples of unacceptable behavior by participants include:
24
+
25
+ * The use of sexualized language or imagery and unwelcome sexual attention or
26
+ advances
27
+ * Trolling, insulting/derogatory comments, and personal or political attacks
28
+ * Public or private harassment
29
+ * Publishing others' private information, such as a physical or electronic
30
+ address, without explicit permission
31
+ * Other conduct which could reasonably be considered inappropriate in a
32
+ professional setting
33
+
34
+ ## Our Responsibilities
35
+
36
+ Project maintainers are responsible for clarifying the standards of acceptable
37
+ behavior and are expected to take appropriate and fair corrective action in
38
+ response to any instances of unacceptable behavior.
39
+
40
+ Project maintainers have the right and responsibility to remove, edit, or
41
+ reject comments, commits, code, wiki edits, issues, and other contributions
42
+ that are not aligned to this Code of Conduct, or to ban temporarily or
43
+ permanently any contributor for other behaviors that they deem inappropriate,
44
+ threatening, offensive, or harmful.
45
+
46
+ ## Scope
47
+
48
+ This Code of Conduct applies both within project spaces and in public spaces
49
+ when an individual is representing the project or its community. Examples of
50
+ representing a project or community include using an official project e-mail
51
+ address, posting via an official social media account, or acting as an appointed
52
+ representative at an online or offline event. Representation of a project may be
53
+ further defined and clarified by project maintainers.
54
+
55
+ ## Enforcement
56
+
57
+ Instances of abusive, harassing, or otherwise unacceptable behavior may be
58
+ reported by contacting the project team at hesham_magdy97@hotmail.com. All
59
+ complaints will be reviewed and investigated and will result in a response that
60
+ is deemed necessary and appropriate to the circumstances. The project team is
61
+ obligated to maintain confidentiality with regard to the reporter of an incident.
62
+ Further details of specific enforcement policies may be posted separately.
63
+
64
+ Project maintainers who do not follow or enforce the Code of Conduct in good
65
+ faith may face temporary or permanent repercussions as determined by other
66
+ members of the project's leadership.
67
+
68
+ ## Attribution
69
+
70
+ This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
71
+ available at [https://contributor-covenant.org/version/1/4][version]
72
+
73
+ [homepage]: https://contributor-covenant.org
74
+ [version]: https://contributor-covenant.org/version/1/4/
data/Gemfile ADDED
@@ -0,0 +1,7 @@
1
+ source "https://rubygems.org"
2
+
3
+ # Specify your gem's dependencies in paymob.gemspec
4
+ gemspec
5
+
6
+ gem "rake", "~> 12.0"
7
+ gem "rspec", "~> 3.0"
data/Gemfile.lock ADDED
@@ -0,0 +1,46 @@
1
+ PATH
2
+ remote: .
3
+ specs:
4
+ paymob_accept (0.1.0)
5
+ faraday
6
+ json-schema
7
+
8
+ GEM
9
+ remote: https://rubygems.org/
10
+ specs:
11
+ addressable (2.8.0)
12
+ public_suffix (>= 2.0.2, < 5.0)
13
+ diff-lcs (1.5.0)
14
+ faraday (2.5.2)
15
+ faraday-net_http (>= 2.0, < 3.1)
16
+ ruby2_keywords (>= 0.0.4)
17
+ faraday-net_http (3.0.0)
18
+ json-schema (3.0.0)
19
+ addressable (>= 2.8)
20
+ public_suffix (4.0.7)
21
+ rake (12.3.3)
22
+ rspec (3.11.0)
23
+ rspec-core (~> 3.11.0)
24
+ rspec-expectations (~> 3.11.0)
25
+ rspec-mocks (~> 3.11.0)
26
+ rspec-core (3.11.0)
27
+ rspec-support (~> 3.11.0)
28
+ rspec-expectations (3.11.0)
29
+ diff-lcs (>= 1.2.0, < 2.0)
30
+ rspec-support (~> 3.11.0)
31
+ rspec-mocks (3.11.1)
32
+ diff-lcs (>= 1.2.0, < 2.0)
33
+ rspec-support (~> 3.11.0)
34
+ rspec-support (3.11.0)
35
+ ruby2_keywords (0.0.5)
36
+
37
+ PLATFORMS
38
+ ruby
39
+
40
+ DEPENDENCIES
41
+ paymob_accept!
42
+ rake (~> 12.0)
43
+ rspec (~> 3.0)
44
+
45
+ BUNDLED WITH
46
+ 2.1.4
data/LICENSE.txt ADDED
@@ -0,0 +1,21 @@
1
+ The MIT License (MIT)
2
+
3
+ Copyright (c) 2022 Hesham Ghaith
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in
13
+ all copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
21
+ THE SOFTWARE.
data/README.md ADDED
@@ -0,0 +1,116 @@
1
+
2
+ # PaymobAccept
3
+
4
+ `paymob_accept` is a Ruby gem created by [OneOrder](https://www.oneorder.net/) for integrating [Paymob](https://paymob.com/en) payment solutions with your Ruby application.
5
+
6
+ ## Installation
7
+
8
+ Add this line to your application's Gemfile:
9
+
10
+ ```ruby
11
+ gem 'paymob_accept'
12
+ ```
13
+
14
+ And then execute:
15
+
16
+ `$ bundle install`
17
+
18
+ Or install it yourself as:
19
+
20
+ `$ gem install paymob_accept`
21
+
22
+ ## Usage
23
+
24
+ ### Configuration
25
+
26
+ Configure the gem with your `api_key`
27
+
28
+ ```ruby
29
+ PaymobAccept.configure do |config|
30
+ config.api_key = YOUR_API_KEY
31
+ end
32
+ ```
33
+
34
+ Also you can pass the api_key to the constructor when initializing your payment service
35
+
36
+ :raised_back_of_hand: You get your API_KEY from Settings -> Account info -> API Key in your Paymob portal
37
+
38
+ ### Creating the payment service
39
+
40
+ When performing a payment we expect to have two hashes (customer, address)
41
+
42
+ - Customer schema
43
+
44
+
45
+ ## Payment service
46
+
47
+ - Initialize your payment service
48
+ ```ruby
49
+ service = PaymobAccept::Api::Pay.new(api_key: api_key)
50
+ ```
51
+
52
+ - To charge:
53
+ ```ruby
54
+ customer_data = {name: "test", email: "test@test.com", phone_number: "01000000000"}
55
+ address_data = {address_line1: "10 street name", address_line2: "apt x. floor x", region: "region", city: "Cairo", country: "EG"}
56
+ service.charge(customer: customer, address: address, integration_id: 'xxxxx', method: :online, iframe_id: 'xxxxx', amount_cents: 1000, amount_currency: 'EGP', order_id: order_id)
57
+ ```
58
+ If order_id is not provided, an order is created then linked to this payment_intent
59
+
60
+ ---
61
+ ### Also, You can do it step by step
62
+
63
+ - Step #1 Get auth_token
64
+ ```ruby
65
+ token = service.get_auth_token
66
+ ```
67
+
68
+ - Step #2 Create_order
69
+ ```ruby
70
+ service.create_order(auth_token: auth_token, amount_cents: 1000, amount_currency: 'EGP', items: [])
71
+ ```
72
+
73
+ auth_token is optional if not passed, it will be automatically generated.
74
+ </br>
75
+ - Items are optional
76
+
77
+ ```ruby
78
+ items = [{
79
+ "name": "xxxxxxx-1",
80
+ "amount_cents": "5000",
81
+ "description": "Smart Watch",
82
+ "quantity": "10"
83
+ }]
84
+ ```
85
+
86
+ </br>
87
+
88
+ - Step #3 Create payment key
89
+
90
+ ```ruby
91
+ generate_payment_intent(customer: customer, address: address, integration_id: "xxxxx", amount_cents: amount_cents, amount_currency: "EGP", iframe_id: "xxxxxx", order_id: "xxxxxx")
92
+ ```
93
+ ---
94
+ ## Dealing with charges
95
+ - retrieve transaction `PaymobAccept::Api::Charge.new.charge(transaction_id: transaction_id)`
96
+ - refund transaction `PaymobAccept::Api::Charge.new.refund!(transaction_id: transaction_id, amount_cents: amount_cents)`
97
+ - void a transaction using `PaymobAccept::Api::Charge.new.void!(transaction_id: transaction_id)`
98
+
99
+ ## Development
100
+
101
+ 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.
102
+
103
+ 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).
104
+
105
+ ## Contributing
106
+
107
+ Bug reports and pull requests are welcome on [GitHub](https://github.com/HeshamMagdy97/paymob).
108
+ This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/HeshamMagdy97/paymob/blob/master/CODE_OF_CONDUCT.md).
109
+
110
+ ## License
111
+
112
+ The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
113
+
114
+ ## Code of Conduct
115
+
116
+ Everyone interacting in the PaymobAccept project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/HeshamMagdy97/paymob/blob/master/CODE_OF_CONDUCT.md).
data/Rakefile ADDED
@@ -0,0 +1,6 @@
1
+ require "bundler/gem_tasks"
2
+ require "rspec/core/rake_task"
3
+
4
+ RSpec::Core::RakeTask.new(:spec)
5
+
6
+ task :default => :spec
data/bin/console ADDED
@@ -0,0 +1,14 @@
1
+ #!/usr/bin/env ruby
2
+
3
+ require "bundler/setup"
4
+ require "paymob"
5
+
6
+ # You can add fixtures and/or initialization code here to make experimenting
7
+ # with your gem easier. You can also use a different console, if you like.
8
+
9
+ # (If you use this, don't forget to add pry to your Gemfile!)
10
+ # require "pry"
11
+ # Pry.start
12
+
13
+ require "irb"
14
+ IRB.start(__FILE__)
data/bin/setup ADDED
@@ -0,0 +1,8 @@
1
+ #!/usr/bin/env bash
2
+ set -euo pipefail
3
+ IFS=$'\n\t'
4
+ set -vx
5
+
6
+ bundle install
7
+
8
+ # Do any other automated setup that you need to do here
@@ -0,0 +1,129 @@
1
+ module PaymobAccept
2
+ module Api
3
+ class Base
4
+ attr_reader :integration_id, :method, :customer, :address
5
+ attr_accessor :api_key, :iframe_id
6
+
7
+ def initialize(api_key: PaymobAccept.configuration.api_key)
8
+ @client = PaymobAccept::Api::Client.new
9
+ @api_key = api_key
10
+ @address = address
11
+ end
12
+
13
+ # STEP #!
14
+ def get_auth_token
15
+ response = @client.request('/auth/tokens', { api_key: api_key })
16
+ response['token']
17
+ end
18
+
19
+ # 2. Order Registration API
20
+ def create_order(amount_cents:, amount_currency: 'EGP', auth_token: get_auth_token,
21
+ delivery_needed: false, items: [])
22
+ body = {
23
+ "auth_token": auth_token,
24
+ "delivery_needed": delivery_needed,
25
+ "amount_cents": amount_cents.to_i,
26
+ "currency": amount_currency,
27
+ "items": items
28
+ }
29
+ @client.request('/ecommerce/orders', body)
30
+ end
31
+
32
+ def generate_payment_intent(customer:, address:, integration_id:, amount_cents:, amount_currency:, iframe_id: nil, order_id: nil, auth_token: get_auth_token)
33
+ if order_id.nil?
34
+ order = create_order(amount_cents: amount_cents, amount_currency: amount_currency)
35
+ order_id = order['id']
36
+ end
37
+ payment_token = generate_payment_key(auth_token: auth_token, customer: customer, address: address, order_id: order_id, amount_cents: amount_cents, amount_currency: amount_currency,
38
+ integration_id: integration_id)
39
+
40
+ format_bill_reference(payment_token, iframe_id)
41
+ end
42
+
43
+ # 3. Payment Key Request
44
+
45
+ private
46
+
47
+ def generate_payment_key(customer:, address:, amount_cents:, amount_currency:, integration_id:, order_id: nil, auth_token: get_auth_token)
48
+ body = {
49
+ "auth_token": auth_token,
50
+ "amount_cents": amount_cents.to_i,
51
+ "currency": amount_currency,
52
+ "expiration": 36_000,
53
+ "order_id": order_id, # Remote
54
+ "billing_data": {
55
+ "first_name": customer&.dig(:first_name) || customer&.dig(:name)&.split(/\s/, 2)&.first,
56
+ "last_name": customer&.dig(:last_name) || customer&.dig(:name)&.split(/\s/, 2)&.last,
57
+ "email": customer[:email],
58
+ "phone_number": customer&.dig(:phone_number),
59
+ "street": address&.dig(:address_line1) || 'NA',
60
+ "building": address&.dig(:address_line2) || 'NA',
61
+ "floor": address&.dig(:address_clarification) || 'NA',
62
+ "apartment": 'NA',
63
+ "postal_code": address&.dig(:postal_code) || 'NA',
64
+ "city": address&.dig(:region) || 'NA',
65
+ "state": address&.dig(:city) || 'NA',
66
+ "country": address&.dig(:country) || 'NA',
67
+ "shipping_method": 'PKG'
68
+ },
69
+ "integration_id": integration_id
70
+ }
71
+ body['token'] = customer[:cc_token] unless customer[:cc_token].nil?
72
+
73
+ response = @client.request('/acceptance/payment_keys', body)
74
+
75
+ response['token']
76
+ end
77
+
78
+ def format_bill_reference(payment_token, iframe_id)
79
+ iframe_id.nil? ? payment_token : "#{Api::Client::API_ENDPOINT}/acceptance/iframes/#{iframe_id}?payment_token=#{payment_token}"
80
+ end
81
+
82
+ def customer_validator(customer)
83
+ JSON::Validator.validate!(customer_schema, customer)
84
+ rescue JSON::Schema::ValidationError => e
85
+ raise ArgumentError, "Customer field has the following error: #{e.message}"
86
+ end
87
+
88
+ def address_validator(address)
89
+ JSON::Validator.validate!(address_schema, address)
90
+ rescue JSON::Schema::ValidationError => e
91
+ raise ArgumentError, "Address field has the following error: #{e.message}"
92
+ end
93
+
94
+ def customer_schema
95
+ {
96
+ "type": 'object',
97
+ "$schema": 'http://json-schema.org/draft-04/schema',
98
+ "properties": {
99
+ "name": { "type": 'string' },
100
+ "first_name": { "type": 'string' },
101
+ "last_name": { "type": 'string' },
102
+ "email": { "type": 'string' },
103
+ "phone_number": { "type": 'string' },
104
+ "cc_token": { "type": 'string' },
105
+ "wallet_mobile_number": { "type": 'string' }
106
+ },
107
+ "required": %w[email phone_number]
108
+ }
109
+ end
110
+
111
+ def address_schema
112
+ {
113
+ "type": 'object',
114
+ "$schema": 'http://json-schema.org/draft-04/schema',
115
+ "properties": {
116
+ "address_line1": { "type": 'string' },
117
+ "address_line2": { "type": 'string' },
118
+ "postal_code": { "type": 'string' },
119
+ "region": { "type": 'string' },
120
+ "city": { "type": 'string' },
121
+ "country": { "type": 'string' },
122
+ "address_clarification": { "type": 'string' }
123
+ },
124
+ "required": %w[address_line1 address_line2 region city country]
125
+ }
126
+ end
127
+ end
128
+ end
129
+ end
@@ -0,0 +1,43 @@
1
+ module PaymobAccept
2
+ module Api
3
+ class Charge < Base
4
+ attr_reader :transaction_id
5
+
6
+ def initialize(api_key: PaymobAccept.configuration.api_key)
7
+ super(api_key: api_key)
8
+ end
9
+
10
+ def charge(transaction_id:)
11
+ response = @client.get(endpoint: "/acceptance/transactions/#{transaction_id}", headers: auth_headers)
12
+ JSON.parse(response.body).to_h
13
+ end
14
+
15
+ def capture!(transaction_id:, amount_cents:)
16
+ body = {
17
+ auth_token: get_auth_token,
18
+ transaction_id: transaction_id,
19
+ amount_cents: amount_cents
20
+ }
21
+ @client.request('/acceptance/capture', body)
22
+ end
23
+
24
+ def void!(transaction_id:)
25
+ body = { auth_token: get_auth_token, transaction_id: transaction_id }
26
+ response = @client.request('/acceptance/void_refund/void', body)
27
+ ['true', true].include? response['success']
28
+ end
29
+
30
+ def refund!(transaction_id:, amount_cents:)
31
+ body = { auth_token: get_auth_token, transaction_id: transaction_id, amount_cents: amount_cents }
32
+ response = @client.request('/acceptance/void_refund/refund', body)
33
+ ['true', true].include? response['success']
34
+ end
35
+
36
+ private
37
+
38
+ def auth_headers
39
+ { 'Authorization' => "Bearer #{get_auth_token}" }
40
+ end
41
+ end
42
+ end
43
+ end
@@ -0,0 +1,60 @@
1
+ module PaymobAccept
2
+ module Api
3
+ class Client
4
+ API_ENDPOINT = 'https://accept.paymobsolutions.com/api'.freeze
5
+ def initialize; end
6
+
7
+ def get(endpoint:, params: {}, headers: {})
8
+ response = Faraday.get(
9
+ "#{API_ENDPOINT}/#{endpoint}",
10
+ params,
11
+ headers
12
+ )
13
+ raise StandardError, "code: #{response.status}, response: #{response.body}" unless response.success?
14
+
15
+ response
16
+ end
17
+
18
+ def request(endpoint, body = {})
19
+ response = Faraday.post(
20
+ "#{API_ENDPOINT}/#{endpoint.gsub(%r{^/+}, '')}",
21
+ body.to_json,
22
+ 'Content-Type' => 'application/json'
23
+ )
24
+
25
+ begin
26
+ parsed_body = JSON.parse(response.body).to_h
27
+ rescue StandardError => e
28
+ # Manually send the error to Sentry
29
+ end
30
+
31
+ unless response.success?
32
+ # TODO: Instead of setting the status to failed, this payment intent could be destroyed
33
+
34
+ message = parsed_body&.dig('message') || response.body || default_error_message
35
+ raise PaymobAccept::Errors::BadGateway.new(message: "code: #{response.status}, gateway response: #{message}")
36
+ end
37
+
38
+ handle_paymob_request_errors unless paymob_request_successful?(parsed_body)
39
+
40
+ parsed_body
41
+ end
42
+
43
+ def handle_paymob_request_errors
44
+ raise PaymobAccept::Errors::BadGateway.new(message: default_error_message)
45
+ end
46
+
47
+ def default_error_message
48
+ 'Gateway could not handle your request properly. Please try again later.'
49
+ end
50
+
51
+ def paymob_request_successful?(response)
52
+ !response.key?('success') || (response.key?('success') && ([true,
53
+ 'true'].include?(response['success']) || ([false,
54
+ 'false'].include?(response['success']) && [
55
+ true, 'true'
56
+ ].include?(response['pending']))))
57
+ end
58
+ end
59
+ end
60
+ end
@@ -0,0 +1,91 @@
1
+ # frozen_string_literal: true
2
+
3
+ module PaymobAccept
4
+ module Api
5
+ class Pay < Base
6
+ def initialize(api_key: PaymobAccept.configuration.api_key)
7
+ super(api_key: api_key)
8
+ end
9
+
10
+ def charge(customer:, address:, amount_cents:, integration_id:, method:, amount_currency: 'EGP', order_id: nil, iframe_id: nil, auth_token: get_auth_token)
11
+ raise ArgumentError, "unsupported payment method #{method}" unless %i[online moto kiosk cash auth
12
+ wallet].include? method
13
+
14
+ send("pay_#{method}".to_sym,
15
+ { auth_token: auth_token, customer: customer, address: address, amount_cents: amount_cents, amount_currency: amount_currency,
16
+ integration_id: integration_id, iframe_id: iframe_id, order_id: order_id })
17
+ end
18
+
19
+ private
20
+
21
+ def request_auth(customer:, address:, amount_cents:, amount_currency:, integration_id:, iframe_id:, order_id:, auth_token:)
22
+ generate_payment_intent(customer: customer, address: address, amount_cents: amount_cents, amount_currency: amount_currency,
23
+ integration_id: integration_id, iframe_id: iframe_id, order_id: order_id, auth_token: auth_token)
24
+ end
25
+
26
+ # Returns iFrame URL. The iframe will be prepoulated if the credit card token is provided
27
+ def pay_online(customer:, address:, amount_cents:, amount_currency:, integration_id:, iframe_id:, order_id:, auth_token:)
28
+ generate_payment_intent(customer: customer, address: address, amount_cents: amount_cents, amount_currency: amount_currency,
29
+ integration_id: integration_id, iframe_id: iframe_id, order_id: order_id, auth_token: auth_token)
30
+ end
31
+
32
+ def pay_moto(customer:, address:, amount_cents:, amount_currency:, integration_id:, iframe_id:, order_id:, auth_token:)
33
+ if customer[:cc_token].nil?
34
+ raise ArgumentError,
35
+ 'You need to provide a credit card token for moto payments'
36
+ end
37
+
38
+ bill_reference = generate_payment_intent(customer: customer, address: address, amount_cents: amount_cents, amount_currency: amount_currency,
39
+ integration_id: integration_id, iframe_id: iframe_id, order_id: order_id, auth_token: auth_token)
40
+ body = {
41
+ "source": { "subtype": 'TOKEN', "identifier": cc_token },
42
+ "payment_token": bill_reference
43
+ }
44
+ @client.request('/acceptance/payments/pay', body)
45
+ end
46
+
47
+ def pay_wallet(customer:, address:, amount_cents:, amount_currency:, integration_id:, iframe_id:, order_id:, auth_token:)
48
+ if customer[:wallet_mobile_number].nil?
49
+ raise ArgumentError,
50
+ 'You need to provide a mobile number for wallet payments'
51
+ end
52
+
53
+ bill_reference = generate_payment_intent(customer: customer, address: address, amount_cents: amount_cents, amount_currency: amount_currency,
54
+ integration_id: integration_id, iframe_id: iframe_id, order_id: order_id, auth_token: auth_token)
55
+ body = {
56
+ "source": { "subtype": 'WALLET', "identifier": wallet_mobile_number },
57
+ "payment_token": bill_reference
58
+ }
59
+ @client.request('/acceptance/payments/pay', body)
60
+ end
61
+
62
+ def pay_cash(customer:, address:, amount_cents:, amount_currency:, integration_id:, iframe_id:, order_id:, auth_token:)
63
+ if address.nil?
64
+ raise ArgumentError,
65
+ "Please provide a valid address in options. You must provide those keys: #{address_schema[:required]}"
66
+ end
67
+
68
+ address_validator(address)
69
+
70
+ bill_reference = generate_payment_intent(customer: customer, address: address, amount_cents: amount_cents, amount_currency: amount_currency,
71
+ integration_id: integration_id, iframe_id: iframe_id, order_id: order_id, auth_token: auth_token)
72
+ body = {
73
+ "source": { "subtype": 'CASH', "identifier": 'cash' },
74
+ "payment_token": bill_reference
75
+ }
76
+ @client.request('/acceptance/payments/pay', body)
77
+ end
78
+
79
+ def pay_kiosk(customer:, address:, amount_cents:, amount_currency:, integration_id:, iframe_id:, order_id:, auth_token:)
80
+ bill_reference = generate_payment_intent(customer: customer, address: address, amount_cents: amount_cents, amount_currency: amount_currency,
81
+ integration_id: integration_id, iframe_id: iframe_id, order_id: order_id, auth_token: auth_token)
82
+ body = {
83
+ "source": { "subtype": 'AGGREGATOR', "identifier": 'aggregator' },
84
+ "payment_token": bill_reference
85
+ }
86
+
87
+ @client.request('/acceptance/payments/pay', body)
88
+ end
89
+ end
90
+ end
91
+ end
@@ -0,0 +1,14 @@
1
+ # require 'erb'
2
+ # require 'yaml'
3
+
4
+ module PaymobAccept
5
+ class Configuration
6
+ attr_accessor :api_key, :amount_currency
7
+
8
+ def initialize
9
+ @amount_currency = 'EGP'
10
+ end
11
+ end
12
+
13
+ class ConfigurationMissingError < StandardError; end
14
+ end
@@ -0,0 +1,13 @@
1
+ module PaymobAccept
2
+ module Errors
3
+ class BadGateway < StandardError
4
+ def initialize(message:)
5
+ super(
6
+ title: 'Bad Gateway',
7
+ status: 502,
8
+ detail: message || 'An error has occured communicating with the external gateway',
9
+ )
10
+ end
11
+ end
12
+ end
13
+ end
@@ -0,0 +1,3 @@
1
+ module PaymobAccept
2
+ VERSION = "0.1.0"
3
+ end
@@ -0,0 +1,25 @@
1
+ require 'paymob_accept'
2
+ require 'paymob_accept/api/base'
3
+ require 'paymob_accept/api/pay'
4
+ require 'paymob_accept/api/client'
5
+ require 'paymob_accept/api/charge'
6
+ require 'paymob_accept/configuration'
7
+
8
+ require 'json'
9
+ require 'faraday'
10
+ require 'faraday/net_http'
11
+ require 'paymob_accept/errors/bad_gateway'
12
+ require 'json-schema'
13
+
14
+ module PaymobAccept
15
+ class Error < StandardError; end
16
+ class << self
17
+ def configure
18
+ yield configuration
19
+ end
20
+
21
+ def configuration
22
+ @configuration ||= Configuration.new
23
+ end
24
+ end
25
+ end
data/paymob.gemspec ADDED
@@ -0,0 +1,31 @@
1
+ lib = File.expand_path('lib', __dir__)
2
+ $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
3
+ require_relative 'lib/paymob_accept/version'
4
+
5
+ Gem::Specification.new do |spec|
6
+ spec.name = 'paymob_accept'
7
+ spec.version = PaymobAccept::VERSION
8
+ spec.authors = ['Hesham Magdy']
9
+ spec.email = ['hesham_magdy97@hotmail.com']
10
+
11
+ spec.summary = 'Easy integration of Paymob payment gateway'
12
+ spec.description = 'Paymob is a Ruby gem created by OneOrder tech team for integrating Paymob payment solutions with your Ruby application.'
13
+ spec.homepage = "https://github.com/oneorder-tech/paymob"
14
+ spec.license = 'MIT'
15
+ spec.homepage = 'https://github.com/oneorder-tech/paymob'
16
+ spec.required_ruby_version = Gem::Requirement.new('>= 2.6.0')
17
+
18
+
19
+ spec.metadata['homepage_uri'] = spec.homepage
20
+ spec.metadata['source_code_uri'] = 'https://github.com/oneorder-tech/paymob'
21
+ spec.metadata['changelog_uri'] = 'https://github.com/oneorder-tech/paymob'
22
+
23
+ spec.files = Dir.chdir(File.expand_path(__dir__)) do
24
+ `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
25
+ end
26
+ spec.bindir = 'exe'
27
+ spec.executables = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
28
+ spec.require_paths = ['lib']
29
+ spec.add_dependency 'faraday'
30
+ spec.add_dependency 'json-schema'
31
+ end
metadata ADDED
@@ -0,0 +1,95 @@
1
+ --- !ruby/object:Gem::Specification
2
+ name: paymob_accept
3
+ version: !ruby/object:Gem::Version
4
+ version: 0.1.0
5
+ platform: ruby
6
+ authors:
7
+ - Hesham Magdy
8
+ autorequire:
9
+ bindir: exe
10
+ cert_chain: []
11
+ date: 2022-08-18 00:00:00.000000000 Z
12
+ dependencies:
13
+ - !ruby/object:Gem::Dependency
14
+ name: faraday
15
+ requirement: !ruby/object:Gem::Requirement
16
+ requirements:
17
+ - - ">="
18
+ - !ruby/object:Gem::Version
19
+ version: '0'
20
+ type: :runtime
21
+ prerelease: false
22
+ version_requirements: !ruby/object:Gem::Requirement
23
+ requirements:
24
+ - - ">="
25
+ - !ruby/object:Gem::Version
26
+ version: '0'
27
+ - !ruby/object:Gem::Dependency
28
+ name: json-schema
29
+ requirement: !ruby/object:Gem::Requirement
30
+ requirements:
31
+ - - ">="
32
+ - !ruby/object:Gem::Version
33
+ version: '0'
34
+ type: :runtime
35
+ prerelease: false
36
+ version_requirements: !ruby/object:Gem::Requirement
37
+ requirements:
38
+ - - ">="
39
+ - !ruby/object:Gem::Version
40
+ version: '0'
41
+ description: Paymob is a Ruby gem created by OneOrder tech team for integrating Paymob
42
+ payment solutions with your Ruby application.
43
+ email:
44
+ - hesham_magdy97@hotmail.com
45
+ executables: []
46
+ extensions: []
47
+ extra_rdoc_files: []
48
+ files:
49
+ - ".gitignore"
50
+ - ".rspec"
51
+ - ".travis.yml"
52
+ - CODE_OF_CONDUCT.md
53
+ - Gemfile
54
+ - Gemfile.lock
55
+ - LICENSE.txt
56
+ - README.md
57
+ - Rakefile
58
+ - bin/console
59
+ - bin/setup
60
+ - lib/paymob_accept.rb
61
+ - lib/paymob_accept/api/base.rb
62
+ - lib/paymob_accept/api/charge.rb
63
+ - lib/paymob_accept/api/client.rb
64
+ - lib/paymob_accept/api/pay.rb
65
+ - lib/paymob_accept/configuration.rb
66
+ - lib/paymob_accept/errors/bad_gateway.rb
67
+ - lib/paymob_accept/version.rb
68
+ - paymob.gemspec
69
+ homepage: https://github.com/oneorder-tech/paymob
70
+ licenses:
71
+ - MIT
72
+ metadata:
73
+ homepage_uri: https://github.com/oneorder-tech/paymob
74
+ source_code_uri: https://github.com/oneorder-tech/paymob
75
+ changelog_uri: https://github.com/oneorder-tech/paymob
76
+ post_install_message:
77
+ rdoc_options: []
78
+ require_paths:
79
+ - lib
80
+ required_ruby_version: !ruby/object:Gem::Requirement
81
+ requirements:
82
+ - - ">="
83
+ - !ruby/object:Gem::Version
84
+ version: 2.6.0
85
+ required_rubygems_version: !ruby/object:Gem::Requirement
86
+ requirements:
87
+ - - ">="
88
+ - !ruby/object:Gem::Version
89
+ version: '0'
90
+ requirements: []
91
+ rubygems_version: 3.1.4
92
+ signing_key:
93
+ specification_version: 4
94
+ summary: Easy integration of Paymob payment gateway
95
+ test_files: []