smartpay 0.2.3 → 0.2.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0c6d6af18ab67f641631f6e67525ae39c64286ae716819fa2d96658b0571f83b
-  data.tar.gz: 64a89a61dd9cfec7fffad3735bea54ad22c5387e2b68bc8caa54148803aea394
+  metadata.gz: 56d3e609ce7f1842742670dff4b7eac351f6e653e199362cdd75b6715ec60501
+  data.tar.gz: 35b80a47568eee0755b4335d3aa68922b5b68767ed8e2371c7a45949783b3269
 SHA512:
-  metadata.gz: 7f2ca92bd0867e03a3f2ab3f2c964bfdb1ead71ade148ea753b28aec3ee57aed4d7ab394041620bba30a02055839b214f164e562ed6281e96bf53968a958e6b4
-  data.tar.gz: 1426c5205f369b614791c2b8277df030f8f693e31b1caf9ac36f8cfef017a95570599ee957c2f615401fb57a6b95f38720d9cdf4296b3cdf8563dc4a5110dde0
+  metadata.gz: 32ce2b368f3a40956d8fea8929fcf54f3a442688bdc5cb49d3fcb5d1a5b81bb5ba43adcaebd30c0dd1d004fdefa56aeb7e38687bb9912d23157f5d3ead0a33d7
+  data.tar.gz: db3ed60db92f3246636eb173025aefc1aa0f3153e38f67a3a690e4ad381183f6b916d59cc0f88871d0c69544c2f479a85da9eba9d04d06124e9acc1a32b98434

data/README.md

@@ -2,6 +2,11 @@
 
 The Smartpay Ruby library offers easy access to Smartpay API from applications written in Ruby.
 
+## Documentation
+
+- [Payment Flow](https://docs.smartpay.co/#payment_flow)
+- [API Document](https://api-doc.smartpay.co)
+
 ## Requirements
 
 - Ruby 2.6+
@@ -33,6 +38,66 @@ source 'https://rubygems.org'
 gem 'smartpay'
 ```
 
+## Usage
+
+The package needs to be configured with your own API keys, you can find them on your [dashboard](https://dashboard.smartpay.co/settings/credentials).
+
+```ruby
+Smartpay.configure do |config|
+  config.public_key = '<YOUR_PUBLIC_KEY>' # the one starts with pk_test_
+  config.secret_key = '<YOUR_SECRET_KEY>' # the one starts with sk_test_
+end
+```
+
+### Create Checkout session
+
+You can find the description and requirement for request payload in [API Document](https://api-doc.smartpay.co/#8a3538b1-530c-448c-8bae-4a41cdf0b8fd).
+
+```ruby
+payloaad = {
+  "customerInfo": {
+    "emailAddress": "success@smartpay.co",
+  },
+  "orderData": {
+    "amount": 250,
+    "currency": "JPY",
+    "shippingInfo": {
+      "address": {
+        "line1": "line1",
+        "locality": "locality",
+        "postalCode": "123",
+        "country": "JP"
+      },
+    },
+    "lineItemData": [{
+      "priceData": {
+        "productData": {
+          "name": "レブロン 18 LOW",
+        },
+        "amount": 250,
+        "currency": "JPY",
+      },
+      "quantity": 1
+    }]
+  },
+  "reference": "order_ref_1234567",
+  "successUrl": "https://docs.smartpay.co/example-pages/checkout-successful",
+  "cancelUrl": "https://docs.smartpay.co/example-pages/checkout-canceled"
+}
+```
+
+Create a checkout session by using `Smartpay::Api.create_checkout_session` with your request payload.
+
+```ruby
+session = Smartpay::Api.create_checkout_session(payload)
+```
+
+Then, you can redirect your customer to the session url by calling `redirect_url`:
+
+```ruby
+session.redirect_url
+```
+
 ## Use with your favorite frameworks
 
 ### Ruby on Rails (RoR)
@@ -64,7 +129,7 @@ bundle exec rails generate smartpay:install
 
 This introduces 4 changes for a pre-built Smartpay Checkout example:
 
-> 1. A new initializer - `config/initializers/smartpay.rb`. You will have to update the `config.public_api_key` and `config.private_api_key` with your own credentials to make this work.
+> 1. A new initializer - `config/initializers/smartpay.rb`. You will have to update the `config.public_key` and `config.secret_key` with your own credentials to make this work.
 > 2. A new controller - `app/controllers/smartpays_controller.rb`. This is where you can see how a Checkout session is configured & created.
 > 3. A new view - `app/views/smartpays/index.html.erb`. The minimum frontend required.
 > 4. A new route in config/routes.rb.
@@ -75,8 +140,8 @@ Edit the keys with your own credentials in `config/initializers/smartpay.rb`.
 
 ```ruby
   ...
-  config.public_api_key = '<YOUR_PUBLIC_API_KEY>' # the one starts with pk_test_
-  config.private_api_key = '<YOUR_PRIVATE_API_KEY>' # the one starts with sk_test_
+  config.public_key = '<YOUR_PUBLIC_KEY>' # the one starts with pk_test_
+  config.secret_key = '<YOUR_SECRET_KEY>' # the one starts with sk_test_
   ...
 ```
 

data/lib/generators/smartpay/templates/controller.rb

@@ -3,66 +3,43 @@ class SmartpaysController < ApplicationController
   end
 
   def create
-    session = Smartpay::Api.create_checkout_session(
-      {
-        "customerInfo": {
-          "emailAddress": "success@smartpay.co",
-          "firstName": nil,
-          "lastName": nil,
-          "firstNameKana": nil,
-          "lastNameKana": nil,
-          "address": nil,
-          "phoneNumber": nil,
-          "dateOfBirth": nil,
-          "legalGender": nil,
-          "reference": nil
+    session = Smartpay::Api.create_checkout_session({
+      items: [{
+        name: "オリジナルス STAN SMITH",
+        amount: 250,
+        currency: "JPY",
+        quantity: 1
+      }],
+      customer: {
+        accountAge: 20,
+        email: "merchant-support@smartpay.co",
+        firstName: "田中",
+        lastName: "太郎",
+        firstNameKana: "たなか",
+        lastNameKana: "たろう",
+        address: {
+          line1: "3-6-7",
+          line2: "青山パラシオタワー 11階",
+          subLocality: "",
+          locality: "港区北青山",
+          administrativeArea: "東京都",
+          postalCode: "107-0061",
+          country: "JP"
         },
-        "orderData": {
-          "amount": 250,
-          "currency": "JPY",
-          "captureMethod": nil,
-          "confirmationMethod": nil,
-          "coupons": nil,
-          "shippingInfo": {
-            "address": {
-              "line1": "line1",
-              "line2": nil,
-              "line3": nil,
-              "line4": nil,
-              "line5": nil,
-              "subLocality": nil,
-             "locality": "locality",
-              "administrativeArea": nil,
-              "postalCode": "123",
-              "country": "JP"},
-              "addressType": nil},
-              "lineItemData": [{
-                "price": nil,
-                "priceData": {
-                  "productData": {
-                    "name": "レブロン 18 LOW",
-                    "brand": nil,
-                    "categories": nil,
-                    "description": nil,
-                    "gtin": nil,
-                    "images": nil,
-                    "reference": nil,
-                    "url": nil,
-                    "metadata": nil},
-                    "amount": 250,
-                    "currency": "JPY",
-                    "metadata": nil},
-                    "quantity": 1,
-                    "description": nil,
-                    "metadata": nil
-              }]
-        },
-        "reference": "order_ref_1234567",
-        "metadata": nil,
-        "successUrl": "https://docs.smartpay.co/example-pages/checkout-successful",
-        "cancelUrl": "https://docs.smartpay.co/example-pages/checkout-canceled",
-        "test": true
-      })
+        dateOfBirth: "1985-06-30",
+        gender: "male"
+      },
+      shipping: {
+        line1: "line1",
+        locality: "locality",
+        postalCode: "123",
+        country: "JP"
+      },
+      reference: "order_ref_1234567",
+      successURL: "https://docs.smartpay.co/example-pages/checkout-successful",
+      cancelURL: "https://docs.smartpay.co/example-pages/checkout-canceled",
+      test: true
+    })
     redirect_to session.redirect_url
   end
 end

data/lib/generators/smartpay/templates/initializer.rb

@@ -3,6 +3,6 @@
 Smartpay.configure do |config|
   config.api_url = 'https://api.smartpay.co/smartpayments'
   config.checkout_url = 'https://checkout.smartpay.co'
-  config.public_api_key = 'pk_test_'
-  config.private_api_key = 'sk_test_'
+  config.public_key = 'pk_test_'
+  config.secret_key = 'sk_test_'
 end

data/lib/smartpay/api.rb

@@ -4,7 +4,9 @@ module Smartpay
   class Api
     class << self
       def create_checkout_session(payload)
-        Responses::CheckoutSession.new(Client.post('/checkout/sessions', payload))
+        Responses::CheckoutSession.new(
+          Client.post('/checkout/sessions', Requests::CheckoutSession.new(payload).as_hash)
+        )
       end
     end
   end

data/lib/smartpay/client.rb

@@ -24,12 +24,12 @@ module Smartpay
         {
           accept: :json,
           content_type: :json,
-          Authorization: "Basic #{private_api_key}"
+          Authorization: "Basic #{secret_key}"
         }
       end
 
-      def private_api_key
-        Smartpay.configuration.private_api_key
+      def secret_key
+        Smartpay.configuration.secret_key
       end
     end
   end

data/lib/smartpay/configuration.rb

@@ -3,7 +3,7 @@
 module Smartpay
   class Configuration
     attr_accessor :post_timeout
-    attr_accessor :public_api_key, :private_api_key, :api_url, :checkout_url
+    attr_accessor :public_key, :secret_key, :api_url, :checkout_url
 
     DEFAULT_TIMEOUT_SETTING = 30
     DEFAULT_API_URL = 'https://api.smartpay.co'

data/lib/smartpay/errors/invalid_request_payload_error.rb

@@ -0,0 +1,16 @@
+module Smartpay
+  module Errors
+    class InvalidRequestPayloadError < ArgumentError
+      attr_accessor :key_name
+
+      def initialize(key_name)
+        @key_name = key_name
+        super
+      end
+
+      def message
+        "#{key_name} can't be blank."
+      end
+    end
+  end
+end

data/lib/smartpay/requests/checkout_session.rb

@@ -0,0 +1,187 @@
+# frozen_string_literal: true
+
+module Smartpay
+  module Requests
+    class CheckoutSession
+      attr_accessor :payload
+
+      REQUIREMENT_KEY_NAME = [:successURL, :cancelURL, :customerInfo, :orderData].freeze
+      CAN_FALLBACK_KEYS = [:customerInfo, :orderData].freeze
+
+      def initialize(raw_payload)
+        @payload = raw_payload.transform_keys(&:to_sym)
+      end
+
+      def as_hash
+        check_requirement!
+        normalize_payload
+      end
+
+      private
+
+      def check_requirement!
+        REQUIREMENT_KEY_NAME.each do |key_name|
+          next if CAN_FALLBACK_KEYS.include?(key_name)
+          raise Errors::InvalidRequestPayloadError, key_name unless payload.include?(key_name)
+        end
+      end
+
+      def normalize_payload
+        currency = get_currency
+        total_amount = get_total_amount
+
+        {
+          customerInfo: normalize_customer_info(payload.dig(:customerInfo) || payload.dig(:customer) || {}),
+          orderData: normalize_order_data(payload.dig(:orderData) || {
+            amount: total_amount,
+            currency: currency,
+            captureMethod: payload.dig(:captureMethod),
+            confirmationMethod: payload.dig(:confirmationMethod),
+            coupons: payload.dig(:coupons),
+            shippingInfo: payload.dig(:shippingInfo) || normalize_shipping(payload.dig(:shipping)),
+            lineItemData: payload.dig(:orderData, :lineItemData) || payload.dig(:items),
+            description: payload.dig(:orderDescription),
+            metadata: payload.dig(:orderMetadata)
+          }),
+          reference: payload.dig(:reference),
+          metadata: payload.dig(:metadata),
+          successUrl: payload.dig(:successURL),
+          cancelUrl: payload.dig(:cancelURL),
+          test: payload.dig(:test) || false
+        }
+      end
+
+      def normalize_customer_info(info)
+        return if info.nil?
+        customer = info.transform_keys(&:to_sym)
+        {
+          accountAge: customer.dig(:accountAge),
+          emailAddress: customer.dig(:emailAddress) || customer.dig(:email),
+          firstName: customer.dig(:firstName),
+          lastName: customer.dig(:lastName),
+          firstNameKana: customer.dig(:firstNameKana),
+          lastNameKana: customer.dig(:lastNameKana),
+          address: customer.dig(:address),
+          phoneNumber: customer.dig(:phoneNumber) || customer.dig(:phone),
+          dateOfBirth: customer.dig(:dateOfBirth),
+          legalGender: customer.dig(:legalGender) || customer.dig(:gender),
+          reference: customer.dig(:reference)
+        }
+      end
+
+      def normalize_shipping(shipping)
+        return if shipping.nil?
+        {
+          address: shipping.dig(:address) || {
+            line1: shipping.dig(:line1),
+            line2: shipping.dig(:line2),
+            line3: shipping.dig(:line3),
+            line4: shipping.dig(:line4),
+            line5: shipping.dig(:line5),
+            subLocality: shipping.dig(:subLocality),
+            locality: shipping.dig(:locality),
+            administrativeArea: shipping.dig(:administrativeArea),
+            postalCode: shipping.dig(:postalCode),
+            country: shipping.dig(:country),
+          },
+          addressType: shipping.dig(:addressType)
+        }
+      end
+
+      def normalize_order_data(order)
+        return if order.nil?
+        order = order.transform_keys(&:to_sym)
+        {
+          amount: order.dig(:amount),
+          currency: order.dig(:currency),
+          captureMethod: order.dig(:captureMethod),
+          confirmationMethod: order.dig(:confirmationMethod),
+          coupons: order.dig(:coupons),
+          shippingInfo: order.dig(:shippingInfo),
+          lineItemData: normalize_line_items(order.dig(:lineItemData) || order.dig(:items))
+        }
+      end
+
+      def normalize_line_items(data)
+        return [] if data.nil?
+
+        data.map do |item|
+          line_item = item.transform_keys(&:to_sym)
+          {
+            price: line_item.dig(:price),
+            priceData: normalize_price_data(line_item.dig(:priceData) || {
+              productData: {
+                name: line_item.dig(:name),
+                brand: line_item.dig(:brand),
+                categories: line_item.dig(:categories),
+                gtin: line_item.dig(:gtin),
+                images: line_item.dig(:images),
+                reference: line_item.dig(:reference),
+                url: line_item.dig(:url),
+                description: line_item.dig(:productDescription),
+                metadata: line_item.dig(:productMetadata)
+              },
+              amount: line_item.dig(:amount),
+              currency: line_item.dig(:currency),
+              label: line_item.dig(:label),
+              description: line_item.dig(:priceDescription),
+              metadata: line_item.dig(:priceMetadata)
+            }),
+            quantity: line_item.dig(:quantity),
+            description: line_item.dig(:description),
+            metadata: line_item.dig(:metadata)
+          }
+        end
+      end
+
+      def normalize_price_data(data)
+        return if data.nil?
+        data = data.transform_keys(&:to_sym)
+        {
+          productData: normalize_product_data(data.dig(:productData) || {}),
+          amount: data.dig(:amount),
+          currency: data.dig(:currency),
+          metadata: data.dig(:metadata)
+        }
+      end
+
+      def normalize_product_data(product)
+        return if product.nil?
+        product = product.transform_keys(&:to_sym)
+        {
+          name: product.dig(:name),
+          brand: product.dig(:brand),
+          categories: product.dig(:categories),
+          description: product.dig(:description),
+          gtin: product.dig(:gtin),
+          images: product.dig(:images),
+          reference: product.dig(:reference),
+          url: product.dig(:url),
+          metadata: product.dig(:metadata)
+        }
+      end
+
+      def get_currency
+        currency = payload.dig(:orderData, :currency) || payload.dig(:orderData, 'currency')
+        if currency.nil?
+          items = payload.dig(:orderData, :lineItemData, :priceData) || payload.dig(:items)
+          if !items.nil? && items.count > 0
+            currency = items.first.dig(:currency)
+          end
+        end
+        currency
+      end
+
+      def get_total_amount
+        total_amount = payload.dig(:orderData, :amount) || payload.dig(:orderData, 'amount')
+        if total_amount.nil?
+          items = payload.dig(:orderData, :lineItemData, :priceData) || payload.dig(:items)
+          if !items.nil? && items.count > 0
+            total_amount = items.inject(0) { |sum, item| sum + (item[:amount] || 0) }
+          end
+        end
+        total_amount
+      end
+    end
+  end
+end

data/lib/smartpay/responses/checkout_session.rb

@@ -10,7 +10,15 @@ module Smartpay
       end
 
       def redirect_url
-        URI.escape("#{checkout_url}/login?session-id=#{response[:id]}&public-key=#{public_api_key}")
+        URI.escape("#{checkout_url}/login?session-id=#{response[:id]}&public-key=#{public_key}")
+      end
+
+      def as_hash
+        @response
+      end
+
+      def as_json
+        @response.to_json
       end
 
       private
@@ -19,8 +27,8 @@ module Smartpay
         Smartpay.configuration.checkout_url
       end
 
-      def public_api_key
-        Smartpay.configuration.public_api_key
+      def public_key
+        Smartpay.configuration.public_key
       end
     end
   end

data/lib/smartpay/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Smartpay
-  VERSION = "0.2.3"
+  VERSION = "0.2.7"
 end

data/lib/smartpay.rb

@@ -6,6 +6,8 @@ require_relative "smartpay/version"
 require_relative 'smartpay/configuration'
 require_relative 'smartpay/client'
 require_relative 'smartpay/api'
+require_relative 'smartpay/errors/invalid_request_payload_error'
+require_relative 'smartpay/requests/checkout_session'
 require_relative 'smartpay/responses/checkout_session'
 
 module Smartpay

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: smartpay
 version: !ruby/object:Gem::Version
-  version: 0.2.3
+  version: 0.2.7
 platform: ruby
 authors:
 - Smartpay
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-10-21 00:00:00.000000000 Z
+date: 2021-10-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rest-client
@@ -64,6 +64,8 @@ files:
 - lib/smartpay/api.rb
 - lib/smartpay/client.rb
 - lib/smartpay/configuration.rb
+- lib/smartpay/errors/invalid_request_payload_error.rb
+- lib/smartpay/requests/checkout_session.rb
 - lib/smartpay/responses/checkout_session.rb
 - lib/smartpay/version.rb
 homepage: https://smartpay.co