amazon-pay-api-sdk-ruby 2.0.0 → 2.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 439cdb07dc4f4d22baaf1d26710a1163cfedd565a6d56a5d0e61b0afdcc2c981
-  data.tar.gz: 358f1dfb78f49d1270dc4a457e5664959a40aae6dec6db51476ec6e57e926853
+  metadata.gz: 176034301db14de72484334e1952fbb1e7988eb9affc0a9cdeb881eb1ec195a2
+  data.tar.gz: 63074ee096c0cf39d4b0034f697242152c8f821ec75205b8518d742d15681d54
 SHA512:
-  metadata.gz: 2e14bc560974f5c2dd0078f8b676bc9b41d7c0a02da6e9cce9fb6f2837f16ed2007261f307fffe2e5ec022813d5f8884a6783d49bbb300059717349afce8f488
-  data.tar.gz: 6181e925f7943ec0d8d89b9af328c0a89433b6ecadc897ac07d10451dd75f58fc17ef3843f4b853385e531d8581da7474496bf9199b970c8cac08a223b134133
+  metadata.gz: c7b5826e238173968ee21025c3e072e634935d64e512856bf86254a924746203b957f374d7ea9b22cdd0eadfb70ad6b46bb91b06bc36e47904996553c19484c0
+  data.tar.gz: 72bc8c3640a675d47badf5db8647c82695efa23fcd9b6b2e4ed897ce4f86d8edf730f208f82536964f0ed55a3bbf9ec0f37c53bb25398dbba864b47ffd008768

data/README.md

@@ -775,6 +775,7 @@ end
 ```
 
 ### Create Dispute API
+#### NOTE: This API is intended to be called only by PSPs (Payment Service Providers).
 
 ```ruby
 creation_timestamp = Time.now.to_i
@@ -812,6 +813,19 @@ else
 end
 ```
 
+### Get Dispute API
+```ruby
+response = client.get_dispute('S03-XXXXXX-XXXXXX-XXXXXX')
+if response.code.to_i == 200
+    puts "Get Dispute API Response:"
+    puts response.body
+else
+    puts "Error: Get Dispute API"
+    puts "Status: #{response.code}"
+    puts response.body
+end
+```
+
 ### Update Dispute API 
 
 ```ruby
@@ -893,4 +907,53 @@ else
     puts "Status: #{response.code}"
     puts response.body
 end
+```
+
+### Create Store
+
+```ruby
+create_store_payload = {
+    "allowedOriginDomains": ["https://example.com", "https://www.example.com"],
+    "allowedRedirectURLs": ["https://example.com/return", "https://example.com/cancel"],
+    "storeName": "My Store",
+    "privacyPolicyUrl": "https://example.com/privacy",
+    "merchantLogoUrl": "https://example.com/logo.png"
+}
+
+merchant_account_id = "MERCHANT_ACCOUNT_ID"
+
+response = client.create_store(merchant_account_id, create_store_payload, headers: {})
+if response.code.to_i == 201
+    puts "Create Store API Response:"
+    puts response.body
+else
+    puts "Error: Create Store API"
+    puts "Status: #{response.code}"
+    puts response.body
+end
+```
+
+### Update Store
+
+```ruby
+update_store_payload = {
+    "allowedOriginDomains": ["https://example.com", "https://www.example.com", "https://shop.example.com"],
+    "allowedRedirectURLs": ["https://example.com/return", "https://example.com/cancel"],
+    "storeName": "Updated Store Name",
+    "privacyPolicyUrl": "https://example.com/privacy-updated",
+    "merchantLogoUrl": "https://example.com/new-logo.png"
+}
+
+merchant_account_id = "MERCHANT_ACCOUNT_ID"
+store_id = "STORE_ID"
+
+response = client.update_store(merchant_account_id, store_id, update_store_payload, headers: {})
+if response.code.to_i == 200
+    puts "Update Store API Response:"
+    puts response.body
+else
+    puts "Error: Update Store API"
+    puts "Status: #{response.code}"
+    puts response.body
+end
 ```

data/lib/amazon-pay-api-sdk-ruby/constants.rb

@@ -2,7 +2,7 @@ require 'net/http'
 
 module Constants
     SDK_TYPE = "amazon-pay-api-sdk-ruby".freeze
-    SDK_VERSION = "2.0.0".freeze
+    SDK_VERSION = "2.2.0".freeze
     API_VERSION = "v2".freeze
     API_ENDPOINTS = {
       'na' => 'pay-api.amazon.com',
@@ -38,7 +38,7 @@ module Constants
     DELETE = 'DELETE'.freeze
     MAX_RETRIES = 3.freeze
     BACKOFF_TIMES = [1, 2, 4].freeze # Define backoff times for retries
-    RETRYABLE_ERROR_CODES = [408, 429, 500, 502, 503, 504].freeze
+    RETRYABLE_ERROR_CODES = [408, 425, 429, 500, 502, 503, 504].freeze
     HTTP_OK = '200'
     HTTP_SERVER_ERROR = '500'
     BUYERS_URL = 'buyers'.freeze
@@ -52,6 +52,7 @@ module Constants
     DISBURSEMENTS = 'disbursements'.freeze
     DISPUTE_URLS = 'disputes'.freeze
     FILES_URLS = 'files'.freeze
+    STORES_URL = 'stores'.freeze
     DISPUTE_FILING_REASON = {
       PRODUCT_NOT_RECEIVED: "ProductNotReceived",
       PRODUCT_UNACCEPTABLE: "ProductUnacceptable",
@@ -92,6 +93,10 @@ module Constants
       CANCELLATION_POLICY: "CancellationPolicy",
       CUSTOMER_SIGNATURE: "CustomerSignature",
       TRACKING_NUMBER: "TrackingNumber",
+      CARRIER_NAME: "CarrierName",
+      DEVICE_ID: "DeviceId",
+      DEVICE_NAME: "DeviceName",
+      DOWNLOAD_DATE_TIME: "DownloadDateTime",
       OTHER: "Other"
     }.freeze
-end
+end

data/lib/amazon-pay-api-sdk-ruby/payment_service_provider_client.rb

@@ -1,8 +1,8 @@
 module PaymentServiceProviderClient
     # API to create dispute. 
     # The createDispute operation is used to notify Amazon of a newly created chargeback dispute by a buyer on a
-    # transaction processed by the PSP (Payment Service Provider), ensuring the dispute is properly accounted for in the Amazon Pay systems.
-    # @see https://developer.amazon.com/docs/amazon-pay-apis/dispute.html/#create-dispute
+    # transaction processed only by the PSP (Payment Service Provider), ensuring the dispute is properly accounted for in the Amazon Pay systems.
+    # NOTE: This API is intended to be called only by PSPs (Payment Service Providers).
     # @param {Object} payload - The payload containing statusDetails.
     # @param {Object} headers - Requires : x-amz-pay-idempotency-key, Optional headers for the request, such as authorization tokens or custom headers.
     # @return [HTTPResponse] The response from the API call, which includes details of the dispute.
@@ -10,10 +10,17 @@ module PaymentServiceProviderClient
         api_call(Constants::DISPUTE_URLS, Constants::POST, payload: payload, headers: headers)
     end
 
+    # API to get dispute. 
+    # The getDispute operation is used to retrieve details of a chargeback dispute associated with a specific order
+    # @param {Object} headers - Optional headers for the request, such as x-amz-pay-idempotency-key, authorization tokens or custom headers.
+    # @return [HTTPResponse] The response from the API call, which includes details of the dispute.
+    def get_dispute(dispute_id, headers: {});    
+        api_call("#{Constants::DISPUTE_URLS}/#{dispute_id}", Constants::GET, headers: headers)
+    end
+
     # API to update dispute. 
     # The updateDispute operation is used to notify Amazon of the closure status of a chargeback dispute initiated by a
-    # buyer for orders processed by a partner PSP (Payment Service Provider), ensuring proper accounting within the Amazon systems.
-    # @see https://developer.amazon.com/docs/amazon-pay-apis/dispute.html/#update-dispute
+    # buyer for orders, ensuring proper accounting within the Amazon systems.
     # @param {String} dispute_id - The unique ID of the dispute to retrieve.
     # @param {Object} payload - The payload containing statusDetails.
     # @param {Object} headers - Optional headers for the request, such as x-amz-pay-idempotency-key, authorization tokens or custom headers.
@@ -26,7 +33,6 @@ module PaymentServiceProviderClient
     # The contestDispute operation is used by the partner, on behalf of the merchant, to formally contest a dispute
     # managed by Amazon, requiring the submission of necessary evidence files within the specified
     # Dispute Window (11 days for Chargeback, 7 days for A-Z Claims).
-    # @see https://developer.amazon.com/docs/amazon-pay-apis/dispute.html/#contest-dispute
     # @param {String} dispute_id - The unique ID of the dispute to retrieve.
     # @param {Object} payload - The payload containing statusDetails.
     # @param {Object} headers - Optional headers for the request, such as x-amz-pay-idempotency-key, authorization tokens or custom headers.
@@ -36,13 +42,37 @@ module PaymentServiceProviderClient
     end
 
     # API to upload file.
-    # The uploadFile operation is utilised by PSPs (Payment Service Provider) to upload file-based evidence when a
+    # The uploadFile operation is utilised to upload file-based evidence when a
     # merchant contests a dispute, providing the necessary reference ID to the evidence file as part of
     # the Update Dispute API process.
-    # @see https://developer.amazon.com/docs/amazon-pay-apis/file.html#upload-a-file
     # @param {Object} headers - Requires : x-amz-pay-idempotency-key, Optional headers for the request, such as authorization tokens or custom headers.
     # @return [HTTPResponse] The response from the API call, which includes details of the file.
     def upload_file(payload, headers: {});    
         api_call(Constants::FILES_URLS, Constants::POST, payload: payload, headers: headers)
     end
-end  
+
+    # API to create store.
+    # The createStore operation is used to create a new store for a merchant account.
+    # This allows merchants to configure store-specific settings like allowed domains, redirect URLs,
+    # store name, privacy policy URL, merchant logo URL, and store status.
+    # @param {String} merchant_account_id - The unique ID of the merchant account to create the store for.
+    # @param {Object} payload - The payload containing store configuration details.
+    # @param {Object} headers - Optional headers for the request, such as authorization tokens or custom headers.
+    # @return [HTTPResponse] The response from the API call, which includes details of the created store.
+    def create_store(merchant_account_id, payload, headers: {})
+        api_call("#{Constants::MERCHANT_ACCOUNTS_BASE_URL}/#{merchant_account_id}/#{Constants::STORES_URL}", Constants::POST, payload: payload, headers: headers)
+    end
+
+    # API to update store.
+    # The updateStore operation is used to update an existing store's configuration.
+    # This allows merchants to modify store-specific settings like allowed domains, redirect URLs,
+    # store name, privacy policy URL, merchant logo URL, and store status.
+    # @param {String} merchant_account_id - The unique ID of the merchant account that owns the store.
+    # @param {String} store_id - The unique ID of the store to update.
+    # @param {Object} payload - The payload containing updated store configuration details.
+    # @param {Object} headers - Optional headers for the request, such as authorization tokens or custom headers.
+    # @return [HTTPResponse] The response from the API call, which includes details of the updated store.
+    def update_store(merchant_account_id, store_id, payload, headers: {})
+        api_call("#{Constants::MERCHANT_ACCOUNTS_BASE_URL}/#{merchant_account_id}/#{Constants::STORES_URL}/#{store_id}", Constants::PATCH, payload: payload, headers: headers)
+    end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: amazon-pay-api-sdk-ruby
 version: !ruby/object:Gem::Version
-  version: 2.0.0
+  version: 2.2.0
 platform: ruby
 authors:
 - AmazonPay
-autorequire:
+autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-03-11 00:00:00.000000000 Z
+date: 2025-12-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64
@@ -56,7 +56,7 @@ licenses:
 - Apache-2.0
 metadata:
   source_code_uri: https://github.com/amzn/amazon-pay-api-sdk-ruby
-post_install_message:
+post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -71,8 +71,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.4
-signing_key:
+rubygems_version: 3.0.3.1
+signing_key: 
 specification_version: 4
 summary: This is an AmazonPay Ruby SDK
 test_files: []