payson_api 0.3.3 → 1.0.2

checksums.yaml

@@ -1,15 +1,7 @@
 ---
-!binary "U0hBMQ==":
-  metadata.gz: !binary |-
-    OTA5MmJiMDRiODYwMTMyMzJkYTUxMmJlYWRmZDk1Njg0ODBhYTU5MQ==
-  data.tar.gz: !binary |-
-    Y2I4YTQ0ZDBjYzUwZDRhYzZiNmMyODU2ZDEwMTFlNjI3YmQ4NWZlZA==
+SHA256:
+  metadata.gz: 4542d9a26a029687326f4a3f7f8fbc196b1c7f1c1c176407aea8f45cf1621346
+  data.tar.gz: 2d0b654fea59184a93827c87e6f57dde0d6194ae8dd81b3d6e7e541415349f6f
 SHA512:
-  metadata.gz: !binary |-
-    NzYwOThkMmExNjI1NzVmNGQ5YmRmZGQ5MWU0ZmQ1ZmRlYjJiYTQyY2ViZjlm
-    ODA1M2YzMmI1MGIyZmU3NDZlYjU1NjQzZTNmMjhlMDE0MjczOTc1OTkwZThl
-    YzRlMjg4OTAwYmM3MzY2NzFiNmM4NDIwMjRhMzBjYjUzZjQ2ZGI=
-  data.tar.gz: !binary |-
-    NzgzZmY5MDlkM2RlM2RlYTU5MDZmNWJiMjc5NGNmNWIyMDkyMjFiZWRmY2Vi
-    NTUwMGQxN2FhMDAzZWU5NmEzYWRkZTExNWE5YmUzYzcwNjFiNWNmZDQ1ZjBk
-    NTBkNjgyM2YwNmM2ZDFiMmYzZmVhOWFiZWVjMmYxZjFlZGQyYWQ=
+  metadata.gz: 741d52cce371302839ce8ff2f68dd4b92c9312724563c22091fed701f5f06f3110ce0596464df6982121d5eaa1daac50ed71e6a4c8b1e0907275ee5a10558746
+  data.tar.gz: ce5ff56b813dbdb555845072de35b872328613ebddc1e5c84204b6999a96cff20c154aa368f53bc464123370c7dcdab61a891c736f94ebd0dfa8bcf88c4578ba

data/MIT-LICENSE

@@ -1,20 +1,19 @@
-Copyright (c) 2012 Christopher Svensson
+Copyright (c) 2021 Christopher Svensson
 
-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:
+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 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.
+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,230 @@
+# Payson API
+
+A zero dependency, pure Ruby utility to handle requests against the Payson payment gateway API.
+
+## Supported Ruby versions
+
+* 2.6
+* 2.7
+* 3.0
+
+## Installation
+
+Put this line in your Gemfile:
+
+    gem 'payson_api'
+
+Then bundle:
+
+    $ bundle
+
+## Usage (v2)
+
+This explains how to use this gem with the [Payson Checkout v2 API](https://tech.payson.se/paysoncheckout2).
+
+### General configuration options
+
+You need to configure the gem with your own Payson credentials through the `PaysonAPI::V2.configure` method:
+
+```ruby
+PaysonAPI::V2.configure do |config|
+  config.api_user_id = 'XXXX'
+  config.api_password = 'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX'
+end
+```
+
+Please note that if `config.api_user_id` is set to 4, the client will go into test mode. Valid test access credentials could be found in their [documentation](https://tech.payson.se/#Testing/sandbox).
+
+For more detailed testing you may create your own test agent for use in the test environment. Use `config.test_mode = true`
+
+### Showing account info
+
+```ruby
+account = PaysonAPI::V2::Client.get_account
+```
+
+### Creating a checkout
+
+```ruby
+request = PaysonAPI::V2::Requests::CreateCheckout.new
+request.merchant.checkout_uri = 'http://localhost/checkout'
+request.merchant.confirmation_uri = 'http://localhost/confirmation'
+request.merchant.notification_uri = 'http://localhost/notification'
+request.merchant.terms_uri = 'http://localhost/terms'
+request.order.currency = 'sek'
+request.order.items << PaysonAPI::V2::Requests::OrderItem.new.tap do |item|
+  item.name = 'My product name'
+  item.unit_price = 1000
+  item.quantity = 3
+  item.reference = 'product-1'
+end
+
+checkout = PaysonAPI::V2::Client.create_checkout(request)
+
+# Continue by rendering the HTML from checkout.snippet.
+```
+
+### Updating a checkout
+
+```ruby
+checkout = PaysonAPI::V2::Client.get_checkout(checkout_id)
+
+request = PaysonAPI::V2::Requests::UpdateCheckout.new
+request.id = checkout.id
+request.status = checkout.status
+request.merchant.checkout_uri = checkout.merchant.checkout_uri
+request.merchant.confirmation_uri = checkout.merchant.confirmation_uri
+request.merchant.notification_uri = checkout.merchant.notification_uri
+request.merchant.terms_uri = checkout.merchant.terms_uri
+request.order.currency = 'eur'
+request.order.items << PaysonAPI::V2::Requests::OrderItem.new.tap do |item|
+  item.name = 'My product name'
+  item.unit_price = 200
+  item.quantity = 3
+  item.reference = 'product-1'
+end
+request.order.items << PaysonAPI::V2::Requests::OrderItem.new.tap do |item|
+  item.name = 'Another product name'
+  item.unit_price = 600
+  item.quantity = 1
+  item.reference = 'product-2'
+end
+
+checkout = PaysonAPI::V2::Client.update_checkout(request)
+```
+
+## Usage (v1)
+
+This explains how to use the [Payson 1.0 API](https://tech.payson.se/paysoncheckout1).
+
+### General configuration options
+
+You need to configure the gem with your own Payson credentials through the `PaysonAPI::V1.configure` method:
+
+```ruby
+PaysonAPI::V1.configure do |config|
+  config.api_user_id = 'XXXX'
+  config.api_password = 'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX'
+end
+```
+
+Please note that if `config.api_user_id` is set to 4, the client will go into test mode. Valid test access credentials could be found in {documentation}[https://tech.payson.se/#Testing/sandbox].
+
+For more detailed testing you may create your own test agent for use in the test environment. Use `config.test_mode = true`
+
+### Initiating a payment
+
+```ruby
+payment = PaysonAPI::V1::Requests::Payment.new
+payment.return_url = 'http://localhost/payson/success'
+payment.cancel_url = 'http://localhost/payson/cancel'
+payment.ipn_url = 'http://localhost/payson/ipn'
+payment.memo = 'Sample order description'
+payment.sender = PaysonAPI::V1::Sender.new.tap do |s|
+  s.email = 'mycustomer@mydomain.com'
+  s.first_name = 'My'
+  s.last_name = 'Customer'
+end
+
+payment.receivers = []
+payment.receivers << PaysonAPI::V1::Receiver.new.tap do |r|
+  r.email = 'me@mydomain.com'
+  r.amount = 100
+  r.first_name = 'Me'
+  r.last_name = 'Just me'
+  r.primary = true
+end
+
+payment.order_items = []
+payment.order_items << PaysonAPI::V1::OrderItem.new.tap do |i|
+  i.description = 'Order item description'
+  i.unit_price = 100
+  i.quantity = 1
+  i.tax = 0
+  i.sku = 'MY-ITEM-1'
+end
+
+response = PaysonAPI::V1::Client.initiate_payment(payment)
+
+if response.success?
+  # Redirect to response.forward_url
+else
+  puts response.errors
+end
+```
+
+### Requesting payment details
+
+```ruby
+token = 'token-received-from-payment-request'
+
+payment_details = PaysonAPI::V1::Requests::PaymentDetails.new(token)
+
+response = PaysonAPI::V1::Client.get_payment_details(payment_details)
+
+if response.success?
+  # Do stuff with response object
+else
+  puts response.errors
+end
+```
+
+### Updating a payment
+
+```ruby
+token = 'token-received-from-payment-request'
+action = 'CANCELORDER'
+
+payment_update = PaysonAPI::V1::Requests::PaymentUpdate.new(token, action)
+
+response = PaysonAPI::V1::Client.update_payment(payment_update)
+
+if response.success?
+  # Do stuff with response object
+else
+  puts response.errors
+end
+```
+
+### Validating an IPN response
+
+This example assumes the use of the Rails web framework.
+
+```ruby
+class Payson < ApplicationController
+  def ipn_responder
+    request_body = request.body.read
+    ipn_response = PaysonAPI::V1::Responses::IPN.new(request_body)
+
+    # Create a new IPN request object containing the raw response from above
+    ipn_request = PaysonAPI::V1::Requests::IPN.new(ipn_response.raw)
+
+    validation = PaysonAPI::V1::Client.validate_ipn(ipn_request)
+
+    unless validation.verified?
+      raise "Something went terribly wrong"
+    end
+
+    # Do business transactions, e.g. update the corresponding order:
+    #   order = Order.find_by_payson_token(ipn_response.token)
+    #   order.payson_status = ipn_response.status
+    #   order.save!
+  end
+end
+```
+
+## Todo
+
+Nothing at the moment.
+
+## Project Status
+
+[![Build Status](https://travis-ci.org/stoffus/payson_api.svg?branch=master)](https://travis-ci.org/stoffus/payson_api) [![Gem Version](https://badge.fury.io/rb/payson_api.svg)](https://badge.fury.io/rb/payson_api)
+
+## Questions, Feedback
+
+Feel free to message me on [GitHub](https://github.com/stoffus).
+
+## Copyright
+
+Copyright (c) 2021 Christopher Svensson.

data/lib/payson_api.rb

@@ -1,25 +1,58 @@
-required_files = [
-  'config',
-  'client',
-  'envelope',
-  'funding',
-  'order_item',
-  'receiver',
-  'remote_error',
-  'request/ipn',
-  'request/payment_details',
-  'request/payment_update',
-  'request/payment',
-  'response/ipn',
-  'response/payment_details',
-  'response/payment_update',
-  'response/payment',
-  'response/validate',
-  'sender',
-  'shipping_address',
-  'version'
+# frozen_string_literal: true
+
+require_relative 'payson_api/version'
+
+required_files_v1 = %w[
+  config
+  client
+  envelope
+  errors/unknown_currency_error
+  errors/unknown_fees_payer_error
+  errors/unknown_funding_constraint_error
+  errors/unknown_guarantee_offering_error
+  errors/unknown_locale_error
+  errors/unknown_payment_action_error
+  funding
+  order_item
+  receiver
+  remote_error
+  requests/ipn
+  requests/payment_details
+  requests/payment_update
+  requests/payment
+  responses/ipn
+  responses/payment_details
+  responses/payment_update
+  responses/payment
+  responses/validate
+  sender
+  shipping_address
+]
+
+required_files_v2 = %w[
+  config
+  client
+  errors/validation_error
+  errors/unauthorized_error
+  models/account
+  models/checkout
+  models/customer
+  models/merchant
+  models/order_item
+  models/order
+  requests/order_item
+  requests/customer
+  requests/merchant
+  requests/order
+  requests/create_checkout
+  requests/update_checkout
+  requests/list_checkouts
 ]
 
-required_files.each do |file|
-  require "payson_api/#{file}"
+required_files_v1.each do |file|
+  require_relative "payson_api/v1/#{file}"
+end
+
+required_files_v2.each do |file|
+  require_relative "payson_api/v2/#{file}"
 end

data/lib/payson_api/v1/client.rb

@@ -0,0 +1,80 @@
+# frozen_string_literal: true
+
+require 'net/https'
+
+module PaysonAPI
+  module V1
+    class Client
+      def self.initiate_payment(payment_data)
+        response = payson_request(
+          PAYSON_API_PAY_ACTION,
+          payment_data.to_hash
+        )
+        response_hash = params_to_hash(response.body)
+        PaysonAPI::V1::Responses::Payment.new(response_hash)
+      end
+
+      def self.get_payment_details(payment_details_data)
+        response = payson_request(
+          PAYSON_API_PAYMENT_DETAILS_ACTION,
+          payment_details_data.to_hash
+        )
+        response_hash = params_to_hash(response.body)
+        PaysonAPI::V1::Responses::PaymentDetails.new(response_hash)
+      end
+
+      def self.update_payment(payment_update_data)
+        response = payson_request(
+          PAYSON_API_PAYMENT_DETAILS_ACTION,
+          payment_update_data.to_hash
+        )
+        response_hash = params_to_hash(response.body)
+        PaysonAPI::V1::Responses::PaymentUpdate.new(response_hash)
+      end
+
+      def self.validate_ipn(ipn_data)
+        response = payson_request(
+          PAYSON_API_PAYMENT_VALIDATE_ACTION,
+          ipn_data.to_s
+        )
+        PaysonAPI::V1::Responses::Validate.new(response.body)
+      end
+
+      def self.hash_to_params(hash)
+        hash.map { |k, v| "#{k}=#{URI.encode_www_form_component(v.to_s)}" }.join('&')
+      end
+
+      def self.params_to_hash(params)
+        {}.tap do |hash|
+          params.split('&').each do |param|
+            key, val = param.split('=')
+            hash[key] = URI.decode_www_form_component(val)
+          end
+        end
+      end
+
+      def self.payson_request(action, data)
+        path = format('/%<api_version>s/%<action>s/', api_version: PAYSON_API_VERSION, action: action)
+        url = PaysonAPI::V1.api_base_url + path
+        headers = {
+          'PAYSON-SECURITY-USERID' => PaysonAPI::V1.config.api_user_id,
+          'PAYSON-SECURITY-PASSWORD' => PaysonAPI::V1.config.api_password,
+          'Content-Type' => 'application/x-www-form-urlencoded'
+        }
+        post(url, data, headers)
+      end
+
+      def self.post(url, data, headers)
+        uri = URI.parse(url)
+        http = Net::HTTP.new(uri.host, uri.port)
+        http.use_ssl = uri.scheme == 'https'
+        req = Net::HTTP::Post.new(uri.request_uri)
+        req.body = data.is_a?(Hash) ? hash_to_params(data) : data
+        headers.each do |name, value|
+          req[name] = value
+        end
+        http.request(req)
+      end
+    end
+  end
+end