checkout_sdk 0.1.3 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f0cc02510133333f0aa24e032494518e76e1545d895d0bc80ee042685f53a1b8
-  data.tar.gz: 66b207f7ab757b17d4ec673ed369cfc7bd55caafce56fcfab37f7863fac99936
+  metadata.gz: 26f117e315cedf6293b15fabeca2736d00a5e59a98257e0f6af6c111e1d4ca7b
+  data.tar.gz: 17935194ff3650b305c3f2795c6932cb61a2b07e84259683397785367bb4d8fe
 SHA512:
-  metadata.gz: 9169313cb4facab9f0bee3ae7308b88a72f3e44f30bcc56e30aca876a91e74bfc4a16571b1cea010741591fbdebe27b970491bdae204f09ad5804981642dcd34
-  data.tar.gz: 311981be44e7d73bac6d9e1a60532941e406f926e6b738e5660e6666cb5afc6e8b946827b57421a4f5ee4a1ed6bdcd86587768a0fe3dc4ae26761b882e65f9a1
+  metadata.gz: e76a36a2f4ffabace3f0911192b63eeda2119ee39bc0b1fad7792afdd81222b6e6a3acc42f85d2209510cb15fbe5893988e88c69c65dc51cf171824f74fbb14c
+  data.tar.gz: 36767831e67555237bf1f2f8ed28ff861693bd32737c3b7f5d7f0a1579a2ba8c53e7280ad13cfa02937a48f2e5dd80a1fe06a1fdf8986f17736c1c050d94f2c5

data/Gemfile.lock

@@ -1,45 +1,45 @@
 PATH
   remote: .
   specs:
-    checkout_sdk (0.1.2)
-      excon (~> 0.66.0)
+    checkout_sdk (0.3.2)
+      excon (>= 0.66, <= 0.88.0)
       multi_json (~> 1.0)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    coderay (1.1.2)
-    diff-lcs (1.3)
-    excon (0.66.0)
+    coderay (1.1.3)
+    diff-lcs (1.4.4)
+    excon (0.88.0)
     method_source (0.9.2)
-    multi_json (1.13.1)
+    multi_json (1.15.0)
     pry (0.11.3)
       coderay (~> 1.1.0)
       method_source (~> 0.9.0)
     rake (10.5.0)
-    rspec (3.8.0)
-      rspec-core (~> 3.8.0)
-      rspec-expectations (~> 3.8.0)
-      rspec-mocks (~> 3.8.0)
-    rspec-core (3.8.2)
-      rspec-support (~> 3.8.0)
-    rspec-expectations (3.8.4)
+    rspec (3.10.0)
+      rspec-core (~> 3.10.0)
+      rspec-expectations (~> 3.10.0)
+      rspec-mocks (~> 3.10.0)
+    rspec-core (3.10.1)
+      rspec-support (~> 3.10.0)
+    rspec-expectations (3.10.1)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.8.0)
-    rspec-mocks (3.8.1)
+      rspec-support (~> 3.10.0)
+    rspec-mocks (3.10.2)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.8.0)
-    rspec-support (3.8.2)
+      rspec-support (~> 3.10.0)
+    rspec-support (3.10.2)
 
 PLATFORMS
   ruby
 
 DEPENDENCIES
-  bundler (~> 1.16)
+  bundler (~> 2.0)
   checkout_sdk!
   pry (~> 0.11.3)
   rake (~> 10.0)
-  rspec (~> 3.0)
+  rspec (~> 3.5)
 
 BUNDLED WITH
-   1.17.3
+   2.2.31

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2019 Checkout.com
+
+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

@@ -1,8 +1,10 @@
-# CheckoutSdk
+[![GitHub license](https://img.shields.io/github/license/checkout/checkout-sdk-ruby.svg)](https://github.com/checkout/checkout-sdk-ruby/blob/master/LICENSE) [![GitHub release](https://img.shields.io/github/release/checkout/checkout-sdk-ruby.svg)](https://GitHub.com/checkout/checkout-sdk-ruby/releases/)
 
-You are reading documentation for version: 0.1.3
+<p align="center"><img src="https://i.ibb.co/5Mx7ZsS/Screenshot-2020-07-30-at-17-20-31.png" width="20%"></p>
 
-## Installation
+# Checkout.com Ruby SDK
+
+# :rocket: Install
 
 Add this line to your application's Gemfile:
 
@@ -12,13 +14,17 @@ gem 'checkout_sdk'
 
 And then execute:
 
-    $ bundle
+```bash
+$ bundle
+```
 
 Or install it yourself as:
 
-    $ gem install checkout_sdk
+```bash
+$ gem install checkout_sdk
+```
 
-## Configuration
+# :wrench: Configure
 
 API keys must be configured in the gem setup. You can do this anywhere in your application before you make API calls using the gem.
 
@@ -27,37 +33,118 @@ CheckoutSdk.configure do |config|
   config.secret_key = ENV['SECRET_KEY']
   config.public_key = ENV['PUBLIC_KEY']
   config.base_url   = ENV['BASE_URL']
+  config.persistent = true|false # default: true
 end
 ```
 
-## Usage
+# :book: Documentation
+
+You can see the [SDK documentation here](https://checkout.github.io/checkout-sdk-ruby/getting_started/).
+
+# :dash: Quickstart
+
+#### Source Type: `token`
+A card token can be obtained using one of Checkout.com's JavaScript frontend solutions such as [Frames](https://docs.checkout.com/docs/frames "Frames") or any of the [mobile SDKs](https://docs.checkout.com/docs/sdks#section-mobile-sdk-libraries "Mobile SDKs")
+
+```ruby
+payment_request_source = CheckoutSdk::PaymentRequestSource.new
+payment_request_source.type = "token"
+payment_request_source.token = "tok_..."
+payment_request_source.amount = 2022
+payment_request_source.currency = "GBP"
+
+api_resource = CheckoutSdk::ApiResource.new
+
+# Send API call
+response = api_resource.request_payment(payment_request_source)
+
+# response parsing
+response.data           # => {...}
+response.body           # => "..."
+response.headers        # => {...}
+response.remote_ip      # => "..."
+response.status         # => 200
+response.remote_ip      # => "..."
+response.local_port     # => 51601
+response.local_address  # => "..."
+```
+
+#### Source Type: `id`
+
+```ruby
+payment_request_source = CheckoutSdk::PaymentRequestSource.new
+payment_request_source.type = "id"
+payment_request_source.token = "src_..."
+payment_request_source.amount = 2022
+payment_request_source.currency = "GBP"
+
+api_resource = CheckoutSdk::ApiResource.new
+
+# Send API call
+response = api_resource.request_payment(payment_request_source)
+
+# response parsing
+response.data           # => {...}
+response.body           # => "..."
+response.headers        # => {...}
+response.remote_ip      # => "..."
+response.status         # => 200
+response.remote_ip      # => "..."
+response.local_port     # => 51601
+response.local_address  # => "..."
+```
+
 
+#### Source Type: `card`
+[Fully PCI Compliant](https://docs.checkout.com/docs/pci-compliance) merchants only
 ```ruby
-p = CheckoutSdk::PaymentRequestSource.new
-p.type = "card"
-p.card_number = "4242424242424242"
-p.card_expiry_month = 6
-p.card_expiry_year = 2025
-p.card_name = "Bruce Wayne"
-p.card_cvv = "100"
-p.amount = 2022
-p.currency = "GBP"
-p.capture = true
-p.threeds_enabled = false
-p.threeds_attempt_n3d = false
-p.recipient_dob = "1992-04-06"
-p.recipient_account_number = "1234567890"
-p.recipient_zip = "12345"
-p.recipient_last_name = "Elmo"
-p.risk_enabled = true
-p.billing_descriptor_name = "Nancy"
-p.billing_descriptor_city = "Berlin"
-p.processing_mid = "CheckoutSdk"
-
-r = CheckoutSdk::ApiResource.new
-r.request_payments(p)
-```
-
-## Tests
-
-    $ rspec
+payment_request_source = CheckoutSdk::PaymentRequestSource.new
+payment_request_source.type = "card"
+payment_request_source.card_number = "4242424242424242"
+payment_request_source.card_expiry_month = 6
+payment_request_source.card_expiry_year = 2025
+payment_request_source.card_name = "Bruce Wayne"
+payment_request_source.card_cvv = "100"
+payment_request_source.amount = 2022
+payment_request_source.currency = "GBP"
+
+api_resource = CheckoutSdk::ApiResource.new
+
+# Send API call
+response = api_resource.request_payment(payment_request_source)
+
+# response parsing
+response.data           # => {...}
+response.body           # => "..."
+response.headers        # => {...}
+response.remote_ip      # => "..."
+response.status         # => 200
+response.remote_ip      # => "..."
+response.local_port     # => 51601
+response.local_address  # => "..."
+```
+
+# :warning: Boolean/falsy values
+
+"nil" or empty strings will be stripped from API calls
+
+```ruby
+# ignored
+payment_request_source.capture = nil
+payment_request_source.capture = ""
+```
+
+but "false" or 0 are retained and sent in the request
+
+```ruby
+# sent
+payment_request_source.capture = false
+payment_request_source.capture = 0
+```
+See [api_resource_spec](https://github.com/checkout/checkout-sdk-ruby/blob/master/spec/checkout_sdk/api_resource_spec.rb#L10-L24) for details.
+
+# :rotating_light: Tests
+
+```bash
+$ rspec
+```

data/checkout_sdk.gemspec

@@ -13,11 +13,12 @@ Gem::Specification.new do |spec|
   spec.homepage      = "http://checkout.com"
   spec.files         = `git ls-files`.split("\n")
   spec.require_paths = ["lib"]
+  spec.license       = "MIT"
 
-  spec.add_development_dependency "bundler", "~> 1.16"
+  spec.add_development_dependency "bundler", "~> 2.0"
   spec.add_development_dependency "rake", "~> 10.0"
-  spec.add_development_dependency "rspec", "~> 3.0"
+  spec.add_development_dependency "rspec", "~> 3.5"
   spec.add_development_dependency "pry",  "~> 0.11.3"
   spec.add_dependency "multi_json", '~> 1.0'
-  spec.add_dependency "excon", "~> 0.66.0"
+  spec.add_dependency "excon", ">= 0.66", "<= 0.88.0"
 end

data/documentation/.gitignore

@@ -0,0 +1,20 @@
+# Dependencies
+/node_modules
+
+# Production
+/build
+
+# Generated files
+.docusaurus
+.cache-loader
+
+# Misc
+.DS_Store
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*

data/documentation/docs/environment.md

@@ -0,0 +1,26 @@
+---
+id: environment
+title: Environment
+---
+
+The SDK will target an environment based on the **base_url** value you provide when you initialize it:
+
+**Sandbox**: https://api.sandbox.checkout.com
+
+**Live**: https://api.checkout.com
+
+:::caution
+
+Public and secret key pairs will only work for their relevant environment. Sandbox keys begin with "pk_test_" or "sk_test_". You will receive separate Live keys for use in your production environment when going live with Checkout.com.
+
+:::
+
+## Testing
+
+If you are testing in the Sandbox environment, Checkout.com provides a list of [test card details](https://docs.checkout.com/testing/test-card-numbers). You can also simulate a lot of edge cases like Declines, by using [special transaction values](https://docs.checkout.com/testing/response-code-testing).
+
+:::note
+
+You can also test 3D Secure with the test cards provided. If you want to test 3DS 2 flows, use the cards mentioned [here](https://docs.checkout.com/testing/3d-secure-testing).
+
+:::

data/documentation/docs/getting_started.md

@@ -0,0 +1,48 @@
+---
+id: getting_started
+title: Getting Started
+sidebar_label: Getting Started
+---
+
+The Checkout.com Ruby SDK makes it easy to interact with the Unified Payments API. You can easily accept card payments and manage these using the same integration.
+
+[![GitHub license](https://img.shields.io/github/license/checkout/checkout-sdk-ruby.svg)](https://github.com/checkout/checkout-sdk-ruby/blob/master/LICENSE) [![GitHub release](https://img.shields.io/github/release/checkout/checkout-sdk-ruby.svg)](https://GitHub.com/checkout/checkout-sdk-ruby/releases/)
+
+## Get a test account
+
+If you are starting the integration process, and you want to start interacting with Checkout.com's API, you will need a test account, so you can get your API keys.
+
+export const RedirectButton = ({text, link}) => (
+<a
+href={link}
+target="\_blank"
+className="get-test-account">{text}</a>
+);
+
+<RedirectButton text="Get a test account" link="https://www.checkout.com/get-test-account" />
+
+## Authentication
+
+export const Highlight = ({children, color}) => (
+<span
+style={{
+      backgroundColor: color,
+      borderRadius: '2px',
+      color: '#fff',
+      padding: '0.2rem',
+    }}>
+{children}
+</span>
+);
+
+When you sign up for an account, you are given a secret and public API key pair. They will be used to initialise the SDK. You can find the keys by navigating to <Highlight color="#1877F2">Settings > Channels > API keys</Highlight> in Checkout.com's Hub.
+
+:::warning
+
+Never share your secret keys. Keep them guarded and secure.
+
+:::
+
+## Payload and Responses
+
+If you want to see all the parameters that you can provide in API requests, as well as examples of possible responses, please follow the Checkout.com [API Reference](https://api-reference.checkout.com/).

data/documentation/docs/initialize.md

@@ -0,0 +1,19 @@
+---
+id: initialize
+title: Initialize
+---
+
+## Configuration
+
+API keys must be configured in the gem setup. You can do this anywhere in your application before you make API calls using the gem.
+
+```ruby
+CheckoutSdk.configure do |config|
+  config.secret_key = "your secret key"
+  config.public_key = "your public key"
+  config.base_url   = "https://api.sandbox.checkout.com" #for sandbox
+end
+
+api_resource = CheckoutSdk::ApiResource.new
+```
+

data/documentation/docs/install.md

@@ -0,0 +1,21 @@
+---
+id: install
+title: Install
+---
+
+## Add to your application's Gemfile
+
+```ruby
+gem 'checkout_sdk'
+```
+
+And then execute:
+```bash
+$ bundle
+```
+
+## Or install yourself
+
+```bash
+$ gem install checkout_sdk
+```

data/documentation/docs/payments.md

@@ -0,0 +1,200 @@
+---
+id: payments
+title: Payments
+---
+
+You can find a list of request body parameters and possible outcomes [here](https://api-reference.checkout.com/#tag/Payments).
+
+export const Highlight = ({children, color}) => (
+<span
+style={{
+      color: color,
+      padding: '0.2rem',
+    }}>
+{children}
+</span>
+);
+
+:::important
+
+#### Using boolean/falsy values
+
+"nil" or empty strings will be stripped from API calls
+
+```ruby
+# ignored
+payment_request_source.capture = nil
+payment_request_source.capture = ""
+```
+
+but "false" or 0 are retained and sent in the request
+
+```ruby
+# sent
+payment_request_source.capture = false
+payment_request_source.capture = 0
+```
+See [api_resource_spec](https://github.com/checkout/checkout-sdk-ruby/blob/master/spec/checkout_sdk/api_resource_spec.rb#L10-L24) for details.
+
+:::
+
+## Request a card payment with a <Highlight color="#25c2a0">card token</Highlight>
+
+The card token is generated by front-end integration options such as [Frames](https://docs.checkout.com/docs/frames) or one of the [Mobile SDKs](https://docs.checkout.com/docs/sdks#section-mobile-sdk-libraries). Keep in mind that this token expires in 15 minutes and can only be used once.
+
+```ruby
+payment_request_source = CheckoutSdk::PaymentRequestSource.new
+payment_request_source.type = "token"
+payment_request_source.token = "tok_ubfj2q76miwundwlk72vxt2i7q"
+payment_request_source.amount = 1000
+payment_request_source.currency = "GBP"
+payment_request_source.reference = "ORD-090857"
+
+# Send API call
+response = api_resource.request_payment(payment_request_source)
+
+# response parsing
+puts(response.data) # => {...}
+puts(response.body) # => "..."
+```
+
+## Request a card payment with a <Highlight color="#25c2a0">full card details</Highlight>
+
+:::warning
+
+You need to have a high level of PCI Compliance (SAQ-D) to be able to send requests with full card details. Note that unless this payment option is enabled on your account by Checkout.com, the <Highlight color="#5A522C">request will fail</Highlight>. Contact you account manager to request access for this payment interaction.
+
+:::
+
+```ruby
+payment_request_source = CheckoutSdk::PaymentRequestSource.new
+payment_request_source.type = "card"
+payment_request_source.card_number = "4242424242424242"
+payment_request_source.card_expiry_month = 6
+payment_request_source.card_expiry_year = 2025
+payment_request_source.card_name = "Bruce Wayne"
+payment_request_source.card_cvv = "100"
+payment_request_source.amount = 1000
+payment_request_source.currency = "GBP"
+
+# Send API call
+response = api_resource.request_payment(payment_request_source)
+
+# response parsing
+puts(response.data) # => {...}
+puts(response.body) # => "..."
+```
+
+## Request a card payment with a <Highlight color="#25c2a0">an existing card</Highlight>
+
+After you perform at least one successful payment for a customer, Checkout.com will return a <Highlight color="#02b48f">source.id</Highlight>. This id does not expire, so it can be used to perform subsequent payments without needing the customer to enter the card details again.
+
+```ruby
+payment_request_source = CheckoutSdk::PaymentRequestSource.new
+payment_request_source.type = "id"
+payment_request_source.token = "src_vg3tm54ndfbefotjlmgrrvbxli"
+payment_request_source.amount = 1000
+payment_request_source.currency = "GBP"
+
+# Send API call
+response = api_resource.request_payment(payment_request_source)
+
+# response parsing
+puts(response.data) # => {...}
+puts(response.body) # => "..."
+```
+
+## Request a <Highlight color="#25c2a0">3D Secure payment</Highlight>
+
+You have the ability to authenticate with 3DS in a payment request. The request body is similar to normal card payments, but with some additional parameters. [Read more about 3DS](https://docs.checkout.com/docs/3d-secure-payments)
+
+```ruby
+payment_request_source = CheckoutSdk::PaymentRequestSource.new
+payment_request_source.type = "token"
+payment_request_source.token = "tok_ubfj2q76miwundwlk72vxt2i7q"
+payment_request_source.amount = 1000
+payment_request_source.currency = "GBP"
+payment_request_source.reference = "ORD-090857"
+payment_request_source.threeds_enabled = true
+
+# Send API call
+response = api_resource.request_payment(payment_request_source)
+
+# response parsing
+puts(response.data) # => {...}
+puts(response.body) # => "..."
+```
+
+3D Secure payments will return a redirection URL. Here is an example of a 3DS response:
+
+```json
+{
+  "id": "pay_hehfmlkpykeupofyxf7nbr6yyy",
+  "status": "Pending",
+  "customer": {
+    "id": "cus_u4a4zosnrw7ehhzr7jipbkdzo4"
+  },
+  "3ds": {
+    "downgraded": false,
+    "enrolled": "Y"
+  },
+  "_links": {
+    "self": {
+      "href": "https://api.sandbox.checkout.com/payments/pay_hehfmlkpykeupofyxf7nbr6yyy"
+    },
+    "redirect": {
+      "href": "https://sandbox.checkout.com/api2/v2/3ds/acs/sid_feixbit6us3utfedjulm6egnsu"
+    }
+  }
+}
+```
+
+You can access the redirection URL via the SDK like so:
+
+```ruby
+redirectURL = response.data._links.redirect.href
+```
+
+## Get payment details
+
+```ruby
+details = api_resource.get_payment_details("pay_juevt3h5mcjulir2t5g3wfug6u") # or with session id sid_XXX
+```
+
+## Get payment actions
+
+```ruby
+actions = api_resource.get_payment_actions("pay_juevt3h5mcjulir2t5g3wfug6u")
+```
+
+## Capture a payment
+
+```ruby
+capture_payment = CheckoutSdk::CapturePayment.new
+capture_payment.id = "pay_y3oqhf46pyzuxjbcn2giaqnb44"
+capture_payment.amount = "1000"
+capture_payment.reference = "your reference"
+
+response = api_resource.capture_payment(capture_payment)
+```
+
+## Refund a payment
+
+```ruby
+refund_payment = CheckoutSdk::RefundPayment.new
+refund_payment.id = "pay_y3oqhf46pyzuxjbcn2giaqnb44"
+refund_payment.amount = "1000"
+refund_payment.reference = "your reference"
+
+response = api_resource.refund_payment(refund_payment)
+```
+
+## Void a payment
+
+```ruby
+void_payment = CheckoutSdk::VoidPayment.new
+void_payment.id = "pay_y3oqhf46pyzuxjbcn2giaqnb44"
+void_payment.reference = "your reference"
+
+response = api_resource.void_payment(void_payment)
+```