frontgo 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 9b5159138bcd6b1ffa3490df458dffab02fc32fbec40e2d1ca4d649e22750594
+  data.tar.gz: 8d4ae77bfd54e8fb53d98396f8232bc098570eb92644bde13bc969fc86b98fb3
+SHA512:
+  metadata.gz: 1e7aff04db3ce6ebafbe883178d8b90b19a72f8a005ad41ac18a2fc7271f7fae4ef42516bf46d43d74b6c08cb4e2673b800cf8c4c04edbe3fa93b17772f887fa
+  data.tar.gz: 5bb2c17a89beb0e435624276229124dd3975375d296112095045f099fb69f0049368375bb06df5030fd6b65b08e0c961ed600f43f5a8dec1f926576928c309dc

data/.editorconfig

@@ -0,0 +1,13 @@
+# top-most EditorConfig file
+root = true
+
+# Unix-style newlines with a newline ending every file
+# Two spaces for indenting
+[*]
+end_of_line = lf
+insert_final_newline = true
+indent_style = space
+indent_size = 2
+charset = utf-8
+trim_trailing_whitespace = true
+max_line_length = 120

data/.standard.yml

@@ -0,0 +1,3 @@
+# For available configuration options, see:
+#   https://github.com/standardrb/standard
+ruby_version: 3.1

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 Stanislav (Stas) Katkov
+
+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 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,46 @@
+# Frontgo
+
+Thin Ruby client for [FrontPayment API](https://docs.frontpayment.no/).
+
+## Installation
+
+Add to your Gemfile:
+
+```ruby
+gem 'frontgo'
+```
+
+And then install
+`bundle install`
+
+## Usage
+
+```ruby
+client = Frontgo::Client.new('https://api.frontpayment.no', key: 'your-api-key')
+
+# Create payment session
+client.create_session_for_one_time_payment_link({
+  products: [{ name: "Product", rate: 1000, tax: 25, amount: 1250 }],
+  orderSummary: { subTotal: 1000, totalTax: 250, grandTotal: 1250 },
+  customerDetails: { name: "John Doe", email: "john@example.com" },
+  submitPayment: { via: "visa", currency: "NOK" },
+  callback: { success: "https://example.com/success", failure: "https://example.com/failure" }
+})
+
+# Get order status
+client.get_order_status_by_uuid("ODR123456789")
+```
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+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 the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/skatkov/frontgo.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "minitest/test_task"
+
+Minitest::TestTask.create
+
+require "standard/rake"
+
+task default: %i[test standard]

data/lib/frontgo/connection.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Frontgo
+  module Connection
+    def post(uri, body, headers: {})
+      request :post, uri, body, headers
+    end
+
+    def get(uri, params = {}, headers: {})
+      response = @connection.get(uri, params, headers)
+      response.body
+    end
+
+    def put(uri, body = {}, headers: {})
+      request :put, uri, body, headers
+    end
+
+    def delete(uri, headers: {})
+      request :delete, uri, nil, headers
+    end
+
+    private
+
+    def request(method, url, body, headers)
+      response = @connection.run_request method, url, body, headers
+      response.body
+    end
+  end
+end

data/lib/frontgo/credit.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Frontgo
+  # @see https://docs.frontpayment.no/books/fpgo-connect/chapter/credit-check
+  module Credit
+    # @example Credit check for private customer
+    #   client.credit_check_private({
+    #     personalId: "ckFXQWJqeFlieE06ZDU3NGJlNTczMGYx",
+    #     countryCode: "+47",
+    #     msisdn: "46567468"
+    #   })
+    # @example Credit check for private customer with minimal data
+    #   client.credit_check_private({
+    #     personalId: "ckFXQWJqeFlieE06ZDU3NGJlNTczMGYx"
+    #   })
+    def credit_check_private(params)
+      post "api/v1/connect/credit/check/private", params
+    end
+
+    # @example Credit check for corporate customer
+    #   client.credit_check_corporate({
+    #     organizationId: "998379342"
+    #   })
+    def credit_check_corporate(params)
+      post "api/v1/connect/credit/check/corporate", params
+    end
+
+    # @example Get credit check history list
+    #   client.get_credit_check_list
+    def get_credit_check_list
+      get "api/v1/connect/credit/check/list"
+    end
+  end
+end

data/lib/frontgo/customers.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+module Frontgo
+  # @see https://docs.frontpayment.no/books/fpgo-connect/chapter/customer-management
+  module Customers
+    # @example Get customer details
+    #   client.get_customer_details_by_uuid("CSRT1511414842")
+    def get_customer_details_by_uuid(uuid)
+      get "api/v1/connect/customers/details/#{uuid}"
+    end
+
+    # @example Update private customer
+    #   client.update_private_customer("CSRT1511414842", {
+    #     name: "Kari Nordmann",
+    #     countryCode: "+47",
+    #     msisdn: "46567468",
+    #     email: "kari@example.com",
+    #     preferredLanguage: "en",
+    #     personalNumber: "12345678901",
+    #     addresses: {
+    #       billing: {
+    #         street: "Luramyrveien 65",
+    #         zip: "4313",
+    #         city: "Sandnes",
+    #         country: "NO"
+    #       },
+    #       shipping: {
+    #         street: "Sjøhusbakken 42",
+    #         zip: "4313",
+    #         city: "Stavanger",
+    #         country: "NO"
+    #       }
+    #     }
+    #   })
+    def update_private_customer(uuid, params)
+      put "api/v1/connect/customers/update/private/#{uuid}", params
+    end
+
+    # @example Update corporate customer
+    #   client.update_corporate_customer("CSRT1511414842", {
+    #     name: "Acme Corporation",
+    #     organizationId: "192933933",
+    #     countryCode: "+47",
+    #     msisdn: "46567468",
+    #     email: "contact@acme.com",
+    #     preferredLanguage: "en",
+    #     addresses: {
+    #       billing: {
+    #         street: "Luramyrveien 65",
+    #         zip: "4313",
+    #         city: "Sandnes",
+    #         country: "NO"
+    #       },
+    #       shipping: {
+    #         street: "Sjøhusbakken 42",
+    #         zip: "4313",
+    #         city: "Oslo",
+    #         country: "NO"
+    #       }
+    #     },
+    #     additionalContact: {
+    #       "0": {
+    #         name: "John Doe",
+    #         email: "john@acme.com",
+    #         designation: "CEO",
+    #         countryCode: "+47",
+    #         msisdn: "12345678",
+    #         note: "Primary contact"
+    #       }
+    #     }
+    #   })
+    def update_corporate_customer(uuid, params)
+      put "api/v1/connect/customers/update/corporate/#{uuid}", params
+    end
+  end
+end

data/lib/frontgo/orders.rb

@@ -0,0 +1,152 @@
+# frozen_string_literal: true
+
+module Frontgo
+  # @see https://docs.frontpayment.no/books/fpgo-connect/chapter/order-management
+  module Orders
+    # @example Create a one-time payment link session
+    #   client.create_session_for_one_time_payment_link({
+    #     products: [{ name: "Router", rate: 4500, tax: 12, amount: 4500 }],
+    #     orderSummary: { subTotal: 4017.86, totalTax: 482.14, grandTotal: 4500.00 },
+    #     customerDetails: { name: "Kari Nordmann", email: "kari@example.com" },
+    #     submitPayment: { via: "visa", currency: "NOK" },
+    #     callback: { success: "https://example.com/success", failure: "https://example.com/failure" }
+    #   })
+    def create_session_for_one_time_payment_link(params)
+      post "api/v1/connect/orders/regular/submit", params
+    end
+
+    # @example Create an invoice order session
+    #   client.create_session_for_invoice_order({
+    #     products: [{ name: "Router", rate: 4500, tax: 12, amount: 4500 }],
+    #     orderSummary: { subTotal: 4017.86, totalTax: 482.14, grandTotal: 4500.00 },
+    #     customerDetails: { name: "Kari Nordmann", email: "kari@example.com" },
+    #     submitPayment: { via: "invoice", currency: "NOK" },
+    #     invoiceInterval: 0,
+    #     separateInvoices: true
+    #   })
+    def create_session_for_invoice_order(params)
+      post "api/v1/connect/orders/regular/submit", params
+    end
+
+    # Can be filtered by status type as query (?type=)
+    # @example Get all order statuses
+    #   client.get_all_order_status
+    # @example Get only paid orders
+    #   client.get_all_order_status(type: 'paid')
+    # @example Get only invoiced orders
+    #   client.get_all_order_status(type: 'invoiced')
+    def get_all_order_status(params = {})
+      get "api/v1/connect/orders/status", params
+    end
+
+    # @example Get order status by UUID
+    #   client.get_order_status_by_uuid("ODR347888404")
+    def get_order_status_by_uuid(uuid)
+      get "api/v1/connect/orders/status/#{uuid}"
+    end
+
+    # @example Get detailed order information
+    #   client.get_order_details_by_uuid("ODR986760186")
+    def get_order_details_by_uuid(uuid)
+      get "api/v1/connect/orders/details/#{uuid}"
+    end
+
+    # @example Send E-Faktura invoice
+    #   client.send_e_faktura({
+    #     products: { "0": { name: "Hair Wash", rate: 51, tax: 0, amount: 51 } },
+    #     customerDetails: { 
+    #       type: "private", 
+    #       name: "Kari Nordmann", 
+    #       email: "kari@example.com",
+    #       personalNumber: "12345678901"
+    #     },
+    #     orderSummary: { subTotal: 51.00, totalTax: 0.00, grandTotal: 51.00 }
+    #   })
+    def send_e_faktura(params)
+      post "api/v1/connect/orders/invoice/create/faktura", params
+    end
+
+    # @example Send EHF invoice for corporate customers
+    #   client.send_ehf_invoice({
+    #     products: { "0": { name: "Hair Wash", rate: 51, tax: 0, amount: 51 } },
+    #     customerDetails: { 
+    #       type: "corporate", 
+    #       name: "Kari Nordmann", 
+    #       email: "kari@example.com",
+    #       organizationId: "123456789"
+    #     },
+    #     orderSummary: { subTotal: 51.00, totalTax: 0.00, grandTotal: 51.00 }
+    #   })
+    def send_ehf_invoice(params)
+      post "api/v1/connect/orders/invoice/create/ehf", params
+    end
+
+    # @example Cancel an order
+    #   client.cancel_order("ODR123456789", { 
+    #     cancellationNote: "Customer requested cancellation" 
+    #   })
+    def cancel_order(order_uuid, params)
+      post "api/v1/connect/orders/cancel/#{order_uuid}", params
+    end
+
+    # @example Send payment link to customer
+    #   client.send_payment_link({
+    #     products: { "0": { name: "Hair Wash", rate: 51, tax: 0, amount: 51 } },
+    #     customerDetails: { 
+    #       type: "private", 
+    #       name: "Kari Nordmann", 
+    #       email: "kari@example.com"
+    #     },
+    #     sendOrderBy: { sms: true, email: false, invoice: false },
+    #     orderSummary: { subTotal: 51.00, totalTax: 0.00, grandTotal: 51.00 }
+    #   })
+    def send_payment_link(params)
+      post "api/v1/connect/orders/payment-link/create", params
+    end
+
+    # @example Send regular invoice
+    #   client.send_invoice({
+    #     products: { "0": { name: "Hair Wash", rate: 51, tax: 0, amount: 51 } },
+    #     customerDetails: { 
+    #       type: "private", 
+    #       name: "Kari Nordmann", 
+    #       email: "kari@example.com"
+    #     },
+    #     sendOrderBy: { sms: false, email: false, invoice: true },
+    #     invoiceInterval: 0,
+    #     separateInvoices: true
+    #   })
+    def send_invoice(params)
+      post "api/v1/connect/orders/invoice/create", params
+    end
+
+    # @example Resend payment link to customer
+    #   client.resend_payment_link("ODR123456789", {
+    #     countryCode: "+47",
+    #     msisdn: "46567468",
+    #     email: "customer@example.com"
+    #   })
+    def resend_payment_link(uuid, params)
+      post "api/v1/connect/orders/resend/#{uuid}", params
+    end
+
+    # @example Refund an order (full or partial)
+    #   client.refund_order("ODR123456789", {
+    #     type: "regular",
+    #     grandTotal: 55,
+    #     products: [
+    #       { id: 451, amount: 30 },
+    #       { id: 452, amount: 25 }
+    #     ]
+    #   })
+    def refund_order(uuid, params)
+      post "api/v1/connect/orders/refund/#{uuid}", params
+    end
+
+    # @example Get invoice number for an order
+    #   client.get_invoice_number_by_uuid("ODR2005869234")
+    def get_invoice_number_by_uuid(uuid)
+      get "api/v1/connect/orders/invoice-number/#{uuid}"
+    end
+  end
+end

data/lib/frontgo/refund.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Frontgo
+  # @see https://docs.frontpayment.no/books/fpgo-connect/chapter/refund-management
+  module Refund
+    # @example Request refund approval for regular order
+    #   client.request_refund_approval("ODR123456789", {
+    #     type: "regular",
+    #     grandTotal: 55,
+    #     message: "refundRejectionForWeeklyThresholdExceed",
+    #     products: [
+    #       { id: 451, amount: 30 },
+    #       { id: 452, amount: 25 }
+    #     ]
+    #   })
+    # @example Request refund approval for reservation
+    #   client.request_refund_approval("ODR123456789", {
+    #     type: "reservation",
+    #     grandTotal: 100,
+    #     message: "refundRejectionForWeeklyThresholdExceed",
+    #     products: [
+    #       { id: 451, amount: 60 },
+    #       { id: 452, amount: 40 }
+    #     ],
+    #     source: "charged",
+    #     reference: "CHA3852658817"
+    #   })
+    def request_refund_approval(order_uuid, params)
+      post "api/v1/orders/refund/request/approval/#{order_uuid}", params
+    end
+  end
+end

data/lib/frontgo/reservations.rb

@@ -0,0 +1,130 @@
+# frozen_string_literal: true
+
+module Frontgo
+  # @see https://docs.frontpayment.no/books/fpgo-connect/chapter/reservation-management
+  module Reservations
+    # @example Submit a new reservation
+    #   client.submit_reservation({
+    #     customerDetails: {
+    #       type: "private",
+    #       name: "Kari Nordmann",
+    #       email: "kari@example.com",
+    #       countryCode: "+47",
+    #       msisdn: "46567468"
+    #     },
+    #     products: { "0": { name: "Test", rate: 1000, tax: 0, amount: 1000 } },
+    #     orderSummary: { subTotal: 1000.00, totalTax: 0, grandTotal: 1000.00 },
+    #     chargeValidity: "55",
+    #     settings: { isChargePartiallyRefundable: true }
+    #   })
+    def submit_reservation(params)
+      post "api/v1/connect/reservations/submit", params
+    end
+
+    # @example Get reservation details by UUID
+    #   client.get_reservation_details_by_uuid("RES3633019929")
+    def get_reservation_details_by_uuid(uuid)
+      get "api/v1/connect/reservations/details/#{uuid}"
+    end
+
+    # @example Cancel a reservation
+    #   client.cancel_reservation("RES123456789", {
+    #     note: "Customer requested cancellation"
+    #   })
+    def cancel_reservation(uuid, params)
+      post "api/v1/connect/reservations/cancel/#{uuid}", params
+    end
+
+    # @example Capture funds from a reservation
+    #   client.capture_reservation("RES123456789", {
+    #     products: {
+    #       "0": { id: 298, amount: 500 },
+    #       "1": { id: 299, amount: 1500 }
+    #     },
+    #     grandTotal: 2000,
+    #     additionalText: "Capture for services rendered"
+    #   })
+    def capture_reservation(uuid, params)
+      post "api/v1/connect/reservations/capture/#{uuid}", params
+    end
+
+    # @example Charge additional amount from reservation
+    #   client.charge_reservation("RES123456789", {
+    #     products: {
+    #       "0": {
+    #         name: "Additional Service",
+    #         rate: 1500,
+    #         tax: 0,
+    #         amount: 1500
+    #       }
+    #     },
+    #     grandTotal: 1500,
+    #     additionalText: "Extra service charge"
+    #   })
+    def charge_reservation(uuid, params)
+      post "api/v1/connect/reservations/charge/#{uuid}", params
+    end
+
+    # @example Complete a reservation
+    #   client.complete_reservation("RES123456789", {
+    #     note: "Service completed successfully"
+    #   })
+    def complete_reservation(uuid, params)
+      post "api/v1/connect/reservations/complete/#{uuid}", params
+    end
+
+    # @example Resend reservation payment link
+    #   client.resend_reservation("RES123456789", {
+    #     countryCode: "+47",
+    #     msisdn: "46567468",
+    #     email: "customer@example.com"
+    #   })
+    def resend_reservation(uuid, params)
+      post "api/v1/connect/reservations/resend/#{uuid}", params
+    end
+
+    # @example Refund a reservation (from captured or charged amounts)
+    #   client.refund_reservation("RES123456789", {
+    #     type: "reservation",
+    #     grandTotal: 500,
+    #     products: [
+    #       { id: 451, amount: 300 },
+    #       { id: 452, amount: 200 }
+    #     ],
+    #     source: "charged",
+    #     reference: "CHA3852658817"
+    #   })
+    def refund_reservation(uuid, params)
+      post "api/v1/connect/reservations/refund/#{uuid}", params
+    end
+
+    # @example Create reservation session for checkout
+    #   client.create_session_for_reservation({
+    #     customerDetails: {
+    #       type: "private",
+    #       name: "Kari Nordmann",
+    #       email: "kari@example.com",
+    #       countryCode: "+47",
+    #       msisdn: "46567468"
+    #     },
+    #     products: { "0": { name: "Test", rate: 1000, tax: 0, amount: 1000 } },
+    #     submitPayment: { via: "visa" },
+    #     callback: {
+    #       success: "https://example.com/success",
+    #       failure: "https://example.com/failure"
+    #     },
+    #     settings: { isChargePartiallyRefundable: true }
+    #   })
+    def create_session_for_reservation(params)
+      post "api/v1/connect/reservations/create", params
+    end
+
+    # @example Get reservation history by time frame
+    #   client.get_reservation_history_by_time_frame("1706674723", "1706761123")
+    # @example Get last 24 hours (when no timestamps provided, defaults to last 24 hours)
+    #   client.get_reservation_history_by_time_frame("", "")
+    def get_reservation_history_by_time_frame(start_timestamp, end_timestamp)
+      get "api/v1/connect/reservations/history/#{start_timestamp}/#{end_timestamp}"
+    end
+  end
+end

data/lib/frontgo/subscription.rb

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+
+module Frontgo
+  # @see https://docs.frontpayment.no/books/fpgo-connect/chapter/subscription-management
+  module Subscription
+    # @example Create a new subscription
+    #   client.create_subscription({
+    #     products: { "0": { name: "Monthly Service", rate: 2000, tax: 0, amount: 2000 } },
+    #     billingFrequency: "month",
+    #     numberOfRepeats: 12,
+    #     customerDetails: { name: "John Doe", email: "john@example.com" }
+    #   })
+    def create_subscription(params)
+      post "api/v1/connect/subscription/submit", params
+    end
+
+    # @example Create subscription session for checkout
+    #   client.create_session_for_subscription_payment({
+    #     products: { "0": { name: "Premium Plan", rate: 1500, tax: 0, amount: 1500 } },
+    #     billingFrequency: "month",
+    #     submitPayment: { via: "visa" },
+    #     callback: { success: "https://example.com/success", failure: "https://example.com/failure" }
+    #   })
+    def create_session_for_subscription_payment(params)
+      post "api/v1/connect/subscription/create", params
+    end
+
+    # @example Get all subscriptions
+    #   client.get_subscription_list
+    # @example Get ongoing subscriptions with pagination
+    #   client.get_subscription_list('ongoing', { page: 2, customerName: 'John' })
+    # @example Filter by phone and date range
+    #   client.get_subscription_list(nil, { phone: '+47123456789', startDate: '2023-01-01', endDate: '2023-12-31' })
+    def get_subscription_list(status = nil, params = {})
+      endpoint = status ? "api/v1/connect/subscriptions/list/#{status}" : "api/v1/connect/subscriptions/list"
+      get endpoint, params
+    end
+
+    # @example Get all failed payments
+    #   client.get_failed_payment_list
+    # @example Get invoiced failed payments with pagination
+    #   client.get_failed_payment_list('invoiced', { page: 1, phone: '+47123456789' })
+    # @example Filter by subscription UUID
+    #   client.get_failed_payment_list(nil, { subscriptionUuid: 'SUB123456789' })
+    def get_failed_payment_list(status = nil, params = {})
+      endpoint = status ? "api/v1/connect/subscriptions/failed/list/#{status}" : "api/v1/connect/subscriptions/failed/list"
+      get endpoint, params
+    end
+
+    # @example Get subscription details
+    #   client.get_subscription_details_by_uuid('SUB123456789')
+    def get_subscription_details_by_uuid(uuid)
+      get "api/v1/connect/subscriptions/details/#{uuid}"
+    end
+
+    # @example Get failed payment details
+    #   client.get_failed_payment_details('ODR123456789')
+    def get_failed_payment_details(order_uuid)
+      get "api/v1/connect/subscriptions/failed/details/#{order_uuid}"
+    end
+
+    # @example Resend subscription payment link
+    #   client.resend_subscription('SUB123456789', {
+    #     orderUuid: 'ODR123456789',
+    #     countryCode: '+47',
+    #     msisdn: '46567468',
+    #     email: 'customer@example.com'
+    #   })
+    def resend_subscription(uuid, params)
+      post "api/v1/connect/subscriptions/resend/#{uuid}", params
+    end
+
+    # @example Cancel subscription
+    #   client.cancel_subscription('SUB123456789', { note: 'Customer requested cancellation' })
+    def cancel_subscription(uuid, params)
+      post "api/v1/connect/subscriptions/cancel/#{uuid}", params
+    end
+
+    # @example Refund specific subscription cycles
+    #   client.refund_subscription_cycle('SUB123456789', {
+    #     cycles: ['Cycle 1', 'Cycle 2'],
+    #     amount: 200.00
+    #   })
+    def refund_subscription_cycle(uuid, params)
+      post "api/v1/connect/subscriptions/cycles/refund/#{uuid}", params
+    end
+  end
+end

data/lib/frontgo/terminal.rb

@@ -0,0 +1,83 @@
+# frozen_string_literal: true
+
+module Frontgo
+  # @see https://docs.frontpayment.no/books/fpgo-connect/chapter/terminal-management
+  module Terminal
+    # @example Get terminal lists for organization
+    #   client.get_terminal_lists("ORG2074299506")
+    def get_terminal_lists(organization_uuid)
+      get "api/v1/connect/terminal/lists/#{organization_uuid}"
+    end
+
+    # @example Create terminal order with callback
+    #   client.create_terminal_order({
+    #     products: { "0": { name: "Hair Wash", productId: "VFDDF", quantity: 1, rate: 42, tax: 0, amount: 42 } },
+    #     orderSummary: { subTotal: 42.00, totalTax: 0.00, totalDiscount: 0.00, grandTotal: 42.00 },
+    #     orderDate: "07 Apr, 2024",
+    #     terminalUuid: "TRML1216693970",
+    #     receiptPrint: false,
+    #     sendOrderBy: { sms: false, email: true },
+    #     customerDetails: {
+    #       type: "private",
+    #       name: "Kari Nordmann",
+    #       email: "kari@example.com",
+    #       countryCode: "+47",
+    #       msisdn: "46567468",
+    #       preferredLanguage: "en",
+    #       address: { street: "Luramyrveien 65", zip: "4313", city: "Sandnes", country: "NO" }
+    #     },
+    #     callbackUrl: "https://example-callback.com"
+    #   })
+    def create_terminal_order(params)
+      post "api/v1/connect/terminal/orders/create", params
+    end
+
+    # @example Cancel terminal order payment
+    #   client.cancel_terminal_order("ODR123456789", { type: "payment" })
+    def cancel_terminal_order(order_uuid, params)
+      post "api/v1/connect/terminal/orders/cancel/#{order_uuid}", params
+    end
+
+    # @example Resend terminal order to terminal
+    #   client.resend_terminal_order("ODR123456789")
+    def resend_terminal_order(order_uuid)
+      post "api/v1/connect/terminal/orders/resend/#{order_uuid}", {}
+    end
+
+    # @example Check payment status
+    #   client.get_payment_status("ODR123456789")
+    def get_payment_status(order_uuid)
+      get "api/v1/connect/terminal/orders/payment-status/#{order_uuid}"
+    end
+
+    # @example Refund terminal order
+    #   client.refund_terminal_order("ODR123456789", {
+    #     type: "regular",
+    #     grandTotal: 42,
+    #     products: [{ id: 12, amount: 42 }],
+    #     isReversal: false
+    #   })
+    # @example Reverse terminal payment
+    #   client.refund_terminal_order("ODR123456789", {
+    #     type: "regular",
+    #     grandTotal: 42,
+    #     products: [{ id: 12, amount: 42 }],
+    #     isReversal: true
+    #   })
+    def refund_terminal_order(order_uuid, params)
+      post "api/v1/connect/terminal/orders/refund/#{order_uuid}", params
+    end
+
+    # @example Check refund status
+    #   client.get_refund_status("ODR123456789")
+    def get_refund_status(order_uuid)
+      get "api/v1/connect/terminal/orders/refund-status/#{order_uuid}"
+    end
+
+    # @example Cancel refund request
+    #   client.cancel_refund_request("ODR123456789", { type: "refund" })
+    def cancel_refund_request(order_uuid, params)
+      post "api/v1/connect/terminal/orders/cancel/#{order_uuid}", params
+    end
+  end
+end

data/lib/frontgo/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Frontgo
+  VERSION = "0.1.0"
+end

data/lib/frontgo.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+require_relative "frontgo/version"
+require_relative "frontgo/connection"
+require_relative "frontgo/orders"
+require_relative "frontgo/reservations"
+require_relative "frontgo/subscription"
+require_relative "frontgo/customers"
+require_relative "frontgo/refund"
+require_relative "frontgo/terminal"
+require_relative "frontgo/credit"
+require 'faraday'
+
+
+module Frontgo
+  class Error < StandardError; end
+
+  class Client
+    include Connection
+    include Orders
+    include Reservations
+    include Subscription
+    include Customers
+    include Refund
+    include Terminal
+    include Credit
+
+    def initialize(base_url, key:)
+      @connection = Faraday.new(base_url) do |conn|
+        conn.headers['Authorization'] = "Bearer #{key}"
+        conn.request :json
+        conn.response :json
+        conn.response :raise_error
+      end
+    end
+  end
+end

data/sig/frontgo.rbs

@@ -0,0 +1,4 @@
+module Frontgo
+  VERSION: String
+  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+end

metadata

@@ -0,0 +1,77 @@
+--- !ruby/object:Gem::Specification
+name: frontgo
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Stanislav (Stas) Katkov
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2025-07-28 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: A Ruby wrapper for the FrontPayment API supporting orders, customers,
+  subscriptions, refunds, and terminal operations.
+email:
+- contact@skatkov.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".editorconfig"
+- ".standard.yml"
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/frontgo.rb
+- lib/frontgo/connection.rb
+- lib/frontgo/credit.rb
+- lib/frontgo/customers.rb
+- lib/frontgo/orders.rb
+- lib/frontgo/refund.rb
+- lib/frontgo/reservations.rb
+- lib/frontgo/subscription.rb
+- lib/frontgo/terminal.rb
+- lib/frontgo/version.rb
+- sig/frontgo.rbs
+homepage: https://github.com/skatkov/frontgo
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/skatkov/frontgo
+  source_code_uri: https://github.com/skatkov/frontgo
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.1.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.19
+signing_key:
+specification_version: 4
+summary: Ruby client for FrontPayment API
+test_files: []