gmo 0.2.4 → 0.5.0

data/lib/gmo/shop_api.rb

@@ -6,7 +6,9 @@
 # gmo = GMO::Payment::ShopAPI.new({
 #   shop_id:     "foo",
 #   shop_pass:   "bar",
-#   host:  "mul-pay.com"
+#   host:        "mul-pay.com",
+#   locale:      "ja"
+
 # })
 # result = gmo.post_request("EntryTran.idPass", options)
 module GMO
@@ -18,11 +20,12 @@ module GMO
         @shop_id   = options[:shop_id]
         @shop_pass = options[:shop_pass]
         @host      = options[:host]
+        @locale    = options.fetch(:locale, GMO::Const::DEFAULT_LOCALE)
         unless @shop_id && @shop_pass && @host
           raise ArgumentError, "Initialize must receive a hash with :shop_id, :shop_pass and either :host! (received #{options.inspect})"
         end
       end
-      attr_reader :shop_id, :shop_pass, :host
+      attr_reader :shop_id, :shop_pass, :host, :locale
 
       ## 2.1.2.1.取引登録
       # これ以降の決済取引で必要となる取引 ID と取引パスワードの発行を行い、取引を開始します。
@@ -50,7 +53,6 @@ module GMO
         post_request name, options
       end
 
-
       # 【コンビニ払い】
       #  2.1.2.1. 取引登録
       #  これ以降の決済取引で必要となる取引IDと取引パスワードの発行を行い、取引を開始します。
@@ -61,6 +63,51 @@ module GMO
         post_request name, options
       end
 
+      # 【Pay-easy決済】
+      #  5.1.2.1. 取引登録
+      #  これ以降の決済取引で必要となる取引IDと取引パスワードの発行を行い、取引を開始します。
+      def entry_tran_pay_easy(options = {})
+        name = "EntryTranPayEasy.idPass"
+        required = [:order_id, :amount]
+        assert_required_options(required, options)
+        post_request name, options
+      end
+
+      # 【LINE Pay決済】
+      #  20.1.2.1. 取引登録
+      #  これ以降の決済取引で必要となる取引IDと取引パスワードの発行を行い、取引を開始します。
+      def entry_tran_linepay(options = {})
+        name = "EntryTranLinepay.idPass"
+        required = [:order_id, :job_cd, :amount]
+        assert_required_options(required, options)
+        post_request name, options
+      end
+
+      ### @params ###
+      # OrderID
+      # JobCd
+      # Amount
+      # ItemCode
+      # Tax
+      ### @return ###
+      # AccessID
+      # AccessPass
+      ### example ###
+      # gmo.entry_tran_brandtoken({
+      #   order_id: "ord12345",
+      #   job_cd: "AUTH",
+      #   item_code: "1000001",
+      #   tax: "0001001",
+      #   amount: 100
+      # })
+      # => {"AccessID"=>"139f8ec33a07c55f406937c52ce4473d", "AccessPass"=>"2689b204d2c17192fa35f9269fa7e744"}
+      def entry_tran_brandtoken(options = {})
+        name = "EntryTranBrandtoken.idPass"
+        required = [:order_id, :job_cd, :amount]
+        assert_required_options(required, options)
+        post_request name, options
+      end
+
       ## 2.2.2.2.決済実行
       # 指定されたサイトに会員を登録します。
       # return
@@ -125,7 +172,11 @@ module GMO
         #   "ClientField3"    => options[:client_field_3],
         #   "ClientFieldFlag" => client_field_flg
         # }
-        required = [:access_id, :access_pass, :order_id, :card_no, :expire]
+        if options[:token].nil?
+          required = [:access_id, :access_pass, :order_id, :card_no, :expire]
+        else
+          required = [:access_id, :access_pass, :token]
+        end
         assert_required_options(required, options)
         post_request name, options
       end
@@ -135,7 +186,70 @@ module GMO
       # お客様が入力した情報で後続の決済センターと通信を行い決済を実施し、結果を返します。
       def exec_tran_cvs(options = {})
         name = "ExecTranCvs.idPass"
-        required = [:access_id, :access_pass, :order_id, :convenience, :customer_name, :tel_no, :receipts_disp_11, :receipts_disp_12, :receipts_disp_13]
+        required = [:access_id, :access_pass, :order_id, :convenience, :customer_name, :customer_kana, :tel_no, :receipts_disp_11, :receipts_disp_12, :receipts_disp_13]
+        assert_required_options(required, options)
+        post_request name, options
+      end
+
+      # 【Pay-easy決済】
+      # 5.1.2.2. 決済実行
+      # お客様が入力した情報で後続の決済センターと通信を行い決済を実施し、結果を返します。
+      def exec_tran_pay_easy(options = {})
+        name = "ExecTranPayEasy.idPass"
+        required = [:access_id, :access_pass, :order_id, :customer_name, :customer_kana, :tel_no, :receipts_disp_11, :receipts_disp_12, :receipts_disp_13]
+        assert_required_options(required, options)
+        post_request name, options
+      end
+
+      # 【LINE Pay決済】
+      # 20.1.2.2. 決済実行
+      def exec_tran_linepay(options = {})
+        name = "ExecTranLinepay.idPass"
+        required = [:access_id, :access_pass, :order_id, :ret_url, :error_rcv_url, :product_name]
+        assert_required_options(required, options)
+        post_request name, options
+      end
+
+      ### @params ###
+      # AccessID
+      # AccessPass
+      # OrderID
+      # TokenType
+      # Token
+      # MemberID
+      # SeqMode
+      # TokenSeq
+      # ClientField1
+      # ClientField2
+      # ClientField3
+      ### @return ###
+      # Status
+      # OrderID
+      # Forward
+      # Approve
+      # TranID
+      # TranDate
+      # ClientField1
+      # ClientField2
+      # ClientField3
+      ### example ###
+      # gmo.exec_tran_brandtoken({
+      #   order_id: "597ae8c36120b23a3c00014e",
+      #   access_id: "139f8ec33a07c55f406937c52ce4473d",
+      #   access_pass: "2689b204d2c17192fa35f9269fa7e744",
+      #   token_type: :apple_pay,
+      #   token: <Base64 encoded payment data>,
+      #   seq_mode: "1",
+      #   token_seq: 1001,
+      #   client_field_1: "Custom field value 1",
+      #   client_field_2: "Custom field value 2",
+      #   client_field_3: "Custom field value 3"
+      # })
+      # => {"Status"=>"CAPTURE", "OrderID"=>"597ae8c36120b23a3c00014e", "Forward"=>"2a99663", "Approve"=>"5487394", "TranID"=>"1707281634111111111111771216", "TranDate"=>"20170728163453", "ClientField1"=>"Custom field value 1", "ClientField2"=>"Custom field value 2", "ClientField3"=>"Custom field value 3"}
+      def exec_tran_brandtoken(options = {})
+        name = "ExecTranBrandtoken.idPass"
+        options[:token_type] = GMO::Const::TOKEN_TYPES_MAP[options[:token_type]]
+        required = [:access_id, :access_pass, :order_id]
         assert_required_options(required, options)
         post_request name, options
       end
@@ -184,8 +298,8 @@ module GMO
       # gmo.change_tran({
       #   access_id:    "a41d83f1f4c908baeda04e6dc03e300c",
       #   access_pass:  "d72eca02e28c88f98b9341a33ba46d5d",
-      #   JobCd: 100,
-      #   Amount: 100
+      #   job_cd: "CAPTURE",
+      #   amount: 100
       # })
       def change_tran(options = {})
         name = "ChangeTran.idPass"
@@ -194,6 +308,133 @@ module GMO
         post_request name, options
       end
 
+      ### @params ###
+      # AccessID
+      # AccessPass
+      # OrderID
+      # JobCd
+      # Amount
+      # Tax
+      ### @return ###
+      # AccessID
+      # AccessPass
+      # Status
+      # Forward
+      # Approve
+      # TranID
+      # TranDate
+      ### example ###
+      # gmo.change_tran_brandtoken({
+      #   access_id: "21170701482c86c3b88ff72b83bfd363",
+      #   access_pass: "51f36feba120de1e6e29532e5a3a5e3e",
+      #   order_id: "ord10001",
+      #   job_cd: "CAPTURE",
+      #   amount: 2000
+      # })
+      # => {"AccessID"=>"21170701482c86c3b88ff72b83bfd363", "AccessPass"=>"51f36feba120de1e6e29532e5a3a5e3e", "Status"=>"CAPTURE", "Forward"=>"2a99663", "Approve"=>"5538477", "TranID"=>"1707311633111111111111771224", "TranDate"=>"20170731163343"}
+      def change_tran_brandtoken(options = {})
+        name = "ChangeTranBrandtoken.idPass"
+        required = [:access_id, :access_pass, :order_id, :job_cd, :amount]
+        assert_required_options(required, options)
+        post_request name, options
+      end
+
+      ### @params ###
+      # AccessID
+      # AccessPass
+      # OrderID
+      ### @return ###
+      # AccessID
+      # AccessPass
+      # Status
+      # Forward
+      # Approve
+      # TranID
+      # TranDate
+      ### example ###
+      # gmo.void_tran_brandtoken({
+      #   access_id: "139f8ec33a07c55f406937c52ce4473d",
+      #   access_pass: "2689b204d2c17192fa35f9269fa7e744",
+      #   order_id: "597ae8c36120b23a3c00014e"
+      # })
+      # => {"AccessID"=>"139f8ec33a07c55f406937c52ce4473d", "AccessPass"=>"2689b204d2c17192fa35f9269fa7e744", "Status"=>"VOID", "Forward"=>"2a99663", "Approve"=>"5537590", "TranID"=>"1707311610111111111111771219", "TranDate"=>"20170731161007"}
+      def void_tran_brandtoken(options = {})
+        name = "VoidTranBrandtoken.idPass"
+        required = [:access_id, :access_pass, :order_id]
+        assert_required_options(required, options)
+        post_request name, options
+      end
+
+      ### @params ###
+      # AccessID
+      # AccessPass
+      # OrderID
+      # Amount
+      # Tax
+      ### @return ###
+      # AccessID
+      # AccessPass
+      # Status
+      # Forward
+      # Approve
+      # TranID
+      # TranDate
+      ### example ###
+      # gmo.sales_tran_brandtoken({
+      #   access_id: "139f8ec33a07c55f406937c52ce4473d",
+      #   access_pass: "2689b204d2c17192fa35f9269fa7e744",
+      #   order_id: "597ae8c36120b23a3c00014e",
+      #   amount: 1000,
+      #   tax: "0001001"
+      # })
+      # => {"AccessID"=>"139f8ec33a07c55f406937c52ce4473d", "AccessPass"=>"2689b204d2c17192fa35f9269fa7e744", "Status"=>"SALES", "Forward"=>"2a99663", "Approve"=>"5537883", "TranID"=>"1707311620111111111111771220", "TranDate"=>"20170731162256"}
+      def sales_tran_brandtoken(options = {})
+        name = "SalesTranBrandtoken.idPass"
+        required = [:access_id, :access_pass, :order_id, :amount]
+        assert_required_options(required, options)
+        post_request name, options
+      end
+
+      ### @params ###
+      # AccessID
+      # AccessPass
+      # OrderID
+      # Amount
+      # Tax
+      ### @return ###
+      # AccessID
+      # AccessPass
+      # Status
+      # Forward
+      # Approve
+      # TranID
+      # TranDate
+      ### example ###
+      # gmo.refund_tran_brandtoken({
+      #   access_id: "139f8ec33a07c55f406937c52ce4473d",
+      #   access_pass: "2689b204d2c17192fa35f9269fa7e744",
+      #   order_id: "597ae8c36120b23a3c00014e",
+      #   amount: 1000,
+      #   tax: "0001001"
+      # })
+      # => {"AccessID"=>"139f8ec33a07c55f406937c52ce4473d", "AccessPass"=>"2689b204d2c17192fa35f9269fa7e744", "Status"=>"RETURN", "Forward"=>"2a99663", "Approve"=>"5537883", "TranID"=>"1707311620111111111111771220", "TranDate"=>"20170731162256"}
+      def refund_tran_brandtoken(options = {})
+        name = "RefundTranBrandtoken.idPass"
+        required = [:access_id, :access_pass, :order_id, :amount]
+        assert_required_options(required, options)
+        post_request name, options
+      end
+
+      # 【コンビニ払い】
+      ## 2.2.2.1. 支払停止
+      # コンビニ決済センターとの通信を行い取引の支払停止処理を行います。
+      def cvs_cancel(options = {})
+        name = "CvsCancel.idPass"
+        required = [:access_id, :access_pass, :order_id]
+        assert_required_options(required, options)
+        post_request name, options
+      end
+
       ## 2.16.2.1.取引状態参照
       # 指定したオーダーID の取引情報を取得します。
       def search_trade(options = {})
@@ -205,6 +446,38 @@ module GMO
 
       # 13.1.2.1.取引状態参照
       # 指定したオーダーIDの取引情報を取得します。
+      ### @params ###
+      # OrderID
+      # PayType
+      ### @return ###
+      # OrderID
+      # Status
+      # ProcessDate
+      # JobCd
+      # AccessID
+      # AccessPass
+      # ItemCode
+      # Amount
+      # Tax
+      # SiteID
+      # MemberID
+      # CardNoToken
+      # Expire
+      # Method
+      # PayTimes
+      # Forward
+      # TranID
+      # Approve
+      # ClientField1
+      # ClientField2
+      # ClientField3
+      # PayType
+      ### example ###
+      # gmo.search_trade_multi({
+      #   order_id: '598066176120b2235300020b',
+      #   pay_type: 27
+      # })
+      # => {"OrderID"=>"598066176120b2235300020b", "Status"=>"CAPTURE", "ProcessDate"=>"20170801202929", "JobCd"=>"CAPTURE", "AccessID"=>"228fc5bc02da46943300c12706d325a2", "AccessPass"=>"090a50ec2f77d92184a18018f07906e5", "ItemCode"=>"0000990", "Amount"=>"557", "Tax"=>"0", "SiteID"=>"", "MemberID"=>"", "CardNoToken"=>"************1111", "Expire"=>"2212", "Method"=>"1", "PayTimes"=>"", "Forward"=>"2a99663", "TranID"=>"1708012029111111111111771228", "Approve"=>"5689128", "ClientField1"=>"", "ClientField2"=>"", "ClientField3"=>"", "PayType"=>"27"}
       def search_trade_multi(options = {})
         name = "SearchTradeMulti.idPass"
         required = [:order_id, :pay_type]
@@ -216,12 +489,11 @@ module GMO
 
         def api_call(name, args = {}, verb = "post", options = {})
           args.merge!({ "ShopID" => @shop_id, "ShopPass" => @shop_pass })
-          response = api(name, args, verb, options) do |response|
+          api(name, args, verb, options) do |response|
             if response.is_a?(Hash) && !response["ErrInfo"].nil?
-              raise APIError.new(response)
+              raise APIError.new(response, locale)
             end
           end
-          response
         end
 
     end

data/lib/gmo/site_api.rb

@@ -6,7 +6,9 @@
 # gmo = GMO::Payment::SiteAPI.new({
 #   site_id:     "foo",
 #   site_pass:   "bar",
-#   host:  "mul-pay.com"
+#   host:        "mul-pay.com",
+#   locale:      "ja"
+
 # })
 # result = gmo.post_request("EntryTran.idPass", options)
 module GMO
@@ -18,14 +20,24 @@ module GMO
         @site_id   = options[:site_id]
         @site_pass = options[:site_pass]
         @host      = options[:host]
+        @locale    = options.fetch(:locale, GMO::Const::DEFAULT_LOCALE)
         unless @site_id && @site_pass && @host
           raise ArgumentError, "Initialize must receive a hash with :site_id, :site_pass and either :host! (received #{options.inspect})"
         end
       end
-      attr_reader :site_id, :site_pass, :host
+      attr_reader :site_id, :site_pass, :host, :locale
 
       ## 2.3.2.1.会員登録
       # 指定されたサイトに会員を登録します。
+      ### @params ###
+      # MemberID
+      ### @return ###
+      # MemberID
+      ### example ###
+      # gmo.save_member({
+      #   member_id: 'mem10001'
+      # })
+      # => {"MemberID"=>"mem10001"}
       def save_member(options = {})
         name = "SaveMember.idPass"
         required = [:member_id]
@@ -64,7 +76,11 @@ module GMO
       # 指定した会員にカード情報を登録します。尚、サイトに設定されたショップ ID を使用してカード会社と通信を行い有効性の確認を行います。
       def save_card(options = {})
         name = "SaveCard.idPass"
-        required = [:member_id, :card_no, :expire]
+        if options[:token].nil?
+          required = [:member_id, :card_no, :expire]
+        else
+          required = [:member_id, :token]
+        end
         assert_required_options(required, options)
         post_request name, options
       end
@@ -88,6 +104,51 @@ module GMO
         post_request name, options
       end
 
+      ### @params ###
+      # MemberID
+      # SeqMode
+      # TokenSeq
+      ### @return ###
+      # TokenSeq
+      # DefaultFlag
+      # CardName
+      # CardNoToken
+      # Expire
+      # HolderName
+      # DeleteFlag
+      ### example ###
+      # gmo.search_brandtoken({
+      #   member_id: '598066176120b2235300020b',
+      #   seq_mode: 0
+      # })
+      # => {"TokenSeq"=>"0", "DefaultFlag"=>"0", "CardName"=>"", "CardNoToken"=>"*************111", "Expire"=>"2212", "HolderName"=>"", "DeleteFlag"=>"0"}
+      def search_brandtoken(options = {})
+        name = "SearchBrandtoken.idPass"
+        required = [:member_id, :seq_mode]
+        assert_required_options(required, options)
+        post_request name, options
+      end
+
+      ### @params ###
+      # MemberID
+      # SeqMode
+      # TokenSeq
+      ### @return ###
+      # TokenSeq
+      ### example ###
+      # gmo.delete_brandtoken({
+      #   member_id: '598066176120b2235300020b',
+      #   seq_mode: 0,
+      #   token_seq: 0
+      # })
+      # => {"TokenSeq"=>"0"}
+      def delete_brandtoken(options = {})
+        name = "DeleteBrandtoken.idPass"
+        required = [:member_id, :seq_mode, :token_seq]
+        assert_required_options(required, options)
+        post_request name, options
+      end
+
       ## 2.11.2.3. 決済実行
       # お客様が選択したカード登録連番のカード情報を取得します。
       # カード情報が本人認証サービスに対応していない場合は、カード会社との通信を行い決済を実行します。その際の出力パラメータは「2.10.2.3決済実行」の出力パラメータと同じになります。
@@ -99,19 +160,28 @@ module GMO
         post_request name, options
       end
 
+      ## 2.19.2.1.カード属性照会（サイトID+会員ID(+カード登録連番モード・カード登録連番)を指定して呼び出す場合）
+      # 指定したクレジットカードの属性情報を取得します。
+      # /payment/SearchCardDetail.idPass
+      def search_card_detail_by_member_id(options = {})
+        name = "SearchCardDetail.idPass"
+        required = [:member_id, :seq_mode]
+        assert_required_options(required, options)
+        post_request name, options
+      end
+
       private
 
         def api_call(name, args = {}, verb = "post", options = {})
           args.merge!({ "SiteID" => @site_id, "SitePass" => @site_pass })
-          response = api(name, args, verb, options) do |response|
+          api(name, args, verb, options) do |response|
             if response.is_a?(Hash) && !response["ErrInfo"].nil?
-              raise APIError.new(response)
+              raise APIError.new(response, locale)
             end
           end
-          response
         end
 
     end
 
   end
-end
+end