lavenda-pay-ruby 0.0.2 → 0.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1b22bd19fa8ee233967739f90119ba9159e36b5650f69a40ceb1aaf4283886e2
-  data.tar.gz: 90b7d4524c3a098c0f497945b6905e134872070449a308129d6a089ab38d8462
+  metadata.gz: 39b5e1f0ee482056108e319e7c1231913d9cc2c34947b884176ee26214df40dd
+  data.tar.gz: 14d74a9dfec2e429cdc6f7f18099384b2d19162a1c3a0eb992f5d3ac3b7f9dfa
 SHA512:
-  metadata.gz: 8ed16222d6590470b455d4dfb41657dc70716aee12f530faea840bfeab13b369e0fc2be5516bdbb06c21687f360aee9388495d7597689a6e17b6fdbb12a8bae1
-  data.tar.gz: e535aed1df0e7727729e7dae40dc987ac33bc9ac5a1cfe64e9fdb98965c5810fa35488156102d81aea2aea0efa37d52e1aabe0f09bc084c06ec8ad1f44c2664b
+  metadata.gz: 4e771c230db541ff2f90b2e1178891a9d4cc341df303e457f8af55a6f80ebc6761a8f3cd9b88385405b0f29b41920c32792bb662daf3b76d73a4b79ec763f4dd
+  data.tar.gz: 2962469cbe01f0bd57645dfb997504f482e678ad7c1b02ba9d44281aaeec63bafc665fde208e218fc2829ae076f5e095d63e2c663936b808afbf518c541e193b

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 0.0.3
+
+- Add `LavendaPay::Payments::Confirm` to confirm a pending payment outside production.
+
 ## 0.0.2
 
 - Read settings from the `lavenda_pay` Rails credentials when the environment variable is not set.

data/README.md

@@ -88,6 +88,19 @@ LavendaPay::Orders::Find.call(order.pid)
 LavendaPay::Url.order_path(order.pid) # => "https://pay.example.com/orders/order_..."
 ```
 
+## Payments
+
+Sandbox only: confirm a pending payment as if the customer had paid it, to test your payment flow
+end to end. LavendaPay marks it as paid and, when the gateway supports it, confirms it there too.
+The endpoint does not exist in production, where it raises `LavendaPay::NotFoundError`.
+
+```ruby
+# The payment pid comes from the payment outcome webhooks.
+payment = LavendaPay::Payments::Confirm.call("pay_...")
+payment.status               # => "paid"
+payment.gateway_confirmation # => "confirmed", "failed" or "unsupported"
+```
+
 ## Errors
 
 Non-2xx responses raise a `LavendaPay::ApiError` subclass exposing `status`, `body` and `errors`:

data/lib/lavenda_pay/payments/confirm.rb

@@ -0,0 +1,16 @@
+module LavendaPay
+  module Payments
+    # Sandbox only: marks a pending payment as paid, and confirms it on the
+    # gateway when the gateway supports it. Production answers 404 (NotFoundError).
+    #
+    # LavendaPay::Payments::Confirm.call("pay_...") # => LavendaPay::Payment
+    class Confirm < Operation
+      def call(pid)
+        body = http.post("/v1/payments/#{escape(pid)}/confirmation")
+        gateway_confirmation = body.dig("meta", "gateway_confirmation")
+
+        Payment.new((body["payment"] || body).merge("gateway_confirmation" => gateway_confirmation))
+      end
+    end
+  end
+end

data/lib/lavenda_pay/resources/payment.rb

@@ -0,0 +1,6 @@
+module LavendaPay
+  class Payment < Resource
+    # Attributes: pid, status, and gateway_confirmation after a sandbox
+    # confirmation ("confirmed", "failed" or "unsupported").
+  end
+end

data/lib/lavenda_pay/version.rb

@@ -1,3 +1,3 @@
 module LavendaPay
-  VERSION = "0.0.2"
+  VERSION = "0.0.3"
 end

data/lib/lavenda_pay.rb

@@ -5,6 +5,7 @@ require_relative "lavenda_pay/http"
 require_relative "lavenda_pay/resource"
 require_relative "lavenda_pay/resources/customer"
 require_relative "lavenda_pay/resources/order"
+require_relative "lavenda_pay/resources/payment"
 require_relative "lavenda_pay/client"
 require_relative "lavenda_pay/operation"
 require_relative "lavenda_pay/customers/create"
@@ -13,6 +14,7 @@ require_relative "lavenda_pay/customers/list"
 require_relative "lavenda_pay/customers/find_by"
 require_relative "lavenda_pay/orders/create"
 require_relative "lavenda_pay/orders/find"
+require_relative "lavenda_pay/payments/confirm"
 require_relative "lavenda_pay/url"
 require_relative "lavenda_pay/webhooks"
 require_relative "lavenda_pay/engine" if defined?(Rails::Engine)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lavenda-pay-ruby
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.0.3
 platform: ruby
 authors:
 - La Venda Software
@@ -118,9 +118,11 @@ files:
 - lib/lavenda_pay/operation.rb
 - lib/lavenda_pay/orders/create.rb
 - lib/lavenda_pay/orders/find.rb
+- lib/lavenda_pay/payments/confirm.rb
 - lib/lavenda_pay/resource.rb
 - lib/lavenda_pay/resources/customer.rb
 - lib/lavenda_pay/resources/order.rb
+- lib/lavenda_pay/resources/payment.rb
 - lib/lavenda_pay/url.rb
 - lib/lavenda_pay/version.rb
 - lib/lavenda_pay/webhooks.rb
@@ -151,7 +153,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.13
+rubygems_version: 4.0.22
 specification_version: 4
 summary: Ruby client for the Lavenda Pay payments API.
 test_files: []