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

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ff292f2eaf06b442175de16106fb31f54042337f11af7653609bf436eb34133a
-  data.tar.gz: b752565c83f486c960878d54fd204c6f70c543544d5574a5f820c5210e8f857d
+  metadata.gz: 439cdb07dc4f4d22baaf1d26710a1163cfedd565a6d56a5d0e61b0afdcc2c981
+  data.tar.gz: 358f1dfb78f49d1270dc4a457e5664959a40aae6dec6db51476ec6e57e926853
 SHA512:
-  metadata.gz: f45eaed130252eb5e06094fefd1cbc16d923a14c5248250118264ab29db0992bfc2c0bd3d4c820f7019aa2bae43241f3cdc0b5f148500724af32cbef454827d8
-  data.tar.gz: 8e867a51a1ffacd9eaee7c39c4217d0466dc3b651be3a89e71b0b8f0899696748be58cc6390d5b53a4417ede4368968919b9cc38ce662bcc1cabe8f0c47f873c
+  metadata.gz: 2e14bc560974f5c2dd0078f8b676bc9b41d7c0a02da6e9cce9fb6f2837f16ed2007261f307fffe2e5ec022813d5f8884a6783d49bbb300059717349afce8f488
+  data.tar.gz: 6181e925f7943ec0d8d89b9af328c0a89433b6ecadc897ac07d10451dd75f58fc17ef3843f4b853385e531d8581da7474496bf9199b970c8cac08a223b134133

data/README.md

@@ -5,7 +5,7 @@ This guide provides step-by-step instructions on how to use the Amazon Pay Clien
 
 ### Prerequisites
 
-- Ruby installed on your system.
+- Ruby (version 2.7.0 or later) installed on your system.
 - `amazon-pay-api-sdk-ruby` gem installed or this source code has been imported in your project.
 - Your `publicKeyId` & `privateKey.pem` file available.
 
@@ -22,6 +22,8 @@ gem 'amazon-pay-api-sdk-ruby'
 bundle install
 ```
 
+**Notice:** Those who may upgrade from 1.x.x to 2.0.0 or higher: You must change the require statement from: `require './lib/amazon_pay'` to `require './lib/amazon-pay-api-sdk-ruby'` or `require 'amazon_pay'` to `require 'amazon-pay-api-sdk-ruby'`
+
 ### Configuration
 
 Create a configuration with your Amazon Pay credentials and region:
@@ -47,7 +49,7 @@ client = AmazonPayClient.new(config)
 Define the payload and headers for the `create_merchant_account` API call:
 
 ```ruby
-require './lib/amazon_pay'
+require 'amazon-pay-api-sdk-ruby'
 
 client = AmazonPayClient.new(config)
 
@@ -86,35 +88,17 @@ createMerchantAccountPayload = {
             }
         }
     },
-    "beneficiaryOwners": [
-        {
-            "personId": "BO1",
-            "personFullName": "ABC ABC",
-            "residentialAddress": {
-                "addressLine1": "122, ABC XYZ",
-                "addressLine2": "XYZ",
-                "city": "XYZ",
-                "stateOrRegion": "XYZ",
-                "postalCode": "123456",
-                "countryCode": "JP",
-                "phoneNumber": {
-                    "countryCode": "123",
-                    "number": "2062062061"
-                }
-            }
-        },
-        {
-            "personId": "BO2",
-            "personFullName": "ABC ABC",
+     "beneficiaryOwners": [{
+            "personFullName": "Rufus Rufus",
             "residentialAddress": {
-                "addressLine1": "122, ABC XYZ",
-                "addressLine2": "XYZ",
-                "city": "XYZ",
-                "stateOrRegion": "XYZ",
-                "postalCode": "123456",
+                "addressLine1": "4-7, Sunny Mansion 203",
+                "addressLine2": "Boren Ave",
+                "city": "Chiryushi",
+                "stateOrRegion": "AICHI",
+                "postalCode": "4720021",
                 "countryCode": "JP",
                 "phoneNumber": {
-                    "countryCode": "123",
+                    "countryCode": "81",
                     "number": "2062062061"
                 }
             }
@@ -205,9 +189,11 @@ merchantAccountClaimPayload = {
 }
 
 response = client.merchant_account_claim('XXXXXXXXX', merchantAccountClaimPayload, headers: {})
-if response.code.to_i == 303
+if response.code.to_i == 303 || response.code.to_i == 200
     puts "Merchant Account Claim API Response:"
     puts response.body
+    puts "Headers:"
+    puts response.to_hash.to_json
 else
     puts "Error: Merchant Account Claim API"
     puts "Status: #{response.code}"
@@ -525,6 +511,32 @@ else
 end
 ```
 
+### Update Charge
+**Please note that is API is supported only for PSPs (Payment Service Provider)**
+
+```ruby
+def payload = {
+    "statusDetails": {
+        "state": "Canceled",
+        "reasonCode": "ExpiredUnused"
+    }
+}
+
+def headers = {
+    "x-amz-pay-Idempotency-Key": SecureRandom.uuid
+}
+
+response = client.update_charge("S03-XXXXXX-XXXXXX-XXXXXX", payload, headers: headers)
+if response.code.to_i == 200
+    puts "Update Charge API Response:"
+    puts response.body
+else
+    puts "Error: Update Charge API"
+    puts "Status: #{response.code}"
+    puts response.body
+end
+```
+
 ### Capture Charge
 
 ```ruby
@@ -610,4 +622,275 @@ else
     puts "Status: #{response.code}"
     puts response.body
 end
+```
+
+### Get Reports
+
+```ruby
+response = client.get_reports(query_params: {})
+if response.code.to_i == 200
+    puts "Get Reports Response:"
+    puts response.body
+else
+    puts "Error: Get Reports API"
+    puts "Status: #{response.code}"
+    puts response.body
+end
+```
+
+### Get Report By Id
+
+```ruby
+def report_id = "123456789"
+response = client.get_report_by_id(report_id, headers: {})
+if response.code.to_i == 200
+    puts "Get Report By Id Response:"
+    puts response.body
+else
+    puts "Error: Get Report By Id API"
+    puts "Status: #{response.code}"
+    puts response.body
+end
+```
+
+### Create Report
+
+```ruby
+def create_report_payload = {
+    "reportType": "_GET_FLAT_FILE_OFFAMAZONPAYMENTS_SANDBOX_SETTLEMENT_DATA_",
+    "startTime": "20240810T000000Z",
+    "endTime": "20240815T000000Z"
+}
+response = client.create_report(create_report_payload, headers: {"x-amz-pay-Idempotency-Key": SecureRandom.uuid})
+if response.code.to_i == 201
+    puts "Create Report Response:"
+    puts response.body
+else
+    puts "Error: Create Report API"
+    puts "Status: #{response.code}"
+    puts response.body
+end
+```
+
+### Get Report Document
+
+
+```ruby
+def report_document_id = "123456789"
+response = client.get_report_document(report_document_id, headers: {})
+if response.code.to_i == 200
+    puts "Get Report Document Response:"
+    puts response.body
+else
+    puts "Error: Get Report Document API"
+    puts "Status: #{response.code}"
+    puts response.body
+end
+```
+
+### Get Report Schedules
+
+```ruby
+def query_params = {
+    "reportType": "_GET_FLAT_FILE_OFFAMAZONPAYMENTS_SANDBOX_SETTLEMENT_DATA_",
+}
+response = client.get_report_schedules(query_params: query_params, headers: {})
+if response.code.to_i == 200
+    puts "Get Report Schedules Response:"
+    puts response.body
+else
+    puts "Error: Get Report Schedules API"
+    puts "Status: #{response.code}"
+    puts response.body
+end
+```
+
+### Get Report Schedule By ID
+
+```ruby
+def report_schedule_id = "123456789"
+response = client.get_report_schedule_by_id(report_schedule_id, headers: {})
+if response.code.to_i == 200
+    puts "Get Report Schedule By ID Response:"
+    puts response.body
+else
+    puts "Error: Get Report Schedule By ID API"
+    puts "Status: #{response.code}"
+    puts response.body
+end
+```
+
+### Create Report Schedule
+
+```ruby
+def create_report_schdule_payload = {
+    "reportType": "_GET_FLAT_FILE_OFFAMAZONPAYMENTS_SANDBOX_SETTLEMENT_DATA_",
+    "scheduleFrequency": "P1D",
+    "nextReportCreationTime": "20241001T000000Z"
+}
+response = client.create_report_schedule(create_report_schdule_payload, headers: {"x-amz-pay-Idempotency-Key": SecureRandom.uuid}, query_params: {})
+if response.code.to_i == 201
+    puts "Create Report Schedule Response:"
+    puts response.body
+else
+    puts "Error: Create Report Schedule API"
+    puts "Status: #{response.code}"
+    puts response.body
+end
+```
+
+#### Cancel Report Schedule
+
+```ruby
+def report_schedule_id = "123456789"
+response = client.cancel_report_schedule(report_schedule_id, headers: {})
+if response.code.to_i == 200
+    puts "Cancel Report Schedule Schedule Response:"
+    puts response.body
+else
+    puts "Error: Cancel Report Schedule Schedule API"
+    puts "Status: #{response.code}"
+    puts response.body
+end
+```
+
+### Get Disbursements
+
+```ruby
+def query_params = {
+    "startTime": '20240810T000000Z',
+    "endTime": '20240815T000000Z'
+    "pageSize": "30",
+    "nextToken": ""
+}
+response = client.get_disbursements(query_params: {}, headers: {})
+if response.code.to_i == 200
+    puts "Get Disbursements Response:"
+    puts response.body
+else
+    puts "Error: Get Disbursements API"
+    puts "Status: #{response.code}"
+    puts response.body
+end
+```
+
+### Create Dispute API
+
+```ruby
+creation_timestamp = Time.now.to_i
+merchant_response_deadline = creation_timestamp + (14 * 24 * 60 * 60) # Adding 14 days
+
+payload = {
+  "chargeId": "S03-XXXXXX-XXXXXX-XXXXXX",
+  "providerMetadata": {
+    "providerDisputeId": "AXXXXXXXXXX"
+  },  
+  "disputeAmount": {
+    "amount": "1",
+    "currencyCode": "JPY"
+  },  
+  "filingReason": Constants::DISPUTE_FILING_REASON[:PRODUCT_NOT_RECEIVED],
+  "creationTimestamp": creation_timestamp,
+  "statusDetails": {
+    "state": "ActionRequired"
+  },  
+  "merchantResponseDeadline": merchant_response_deadline
+}
+
+def headers = {
+    "x-amz-pay-Idempotency-Key": SecureRandom.uuid
+}
+
+response = client.create_dispute(payload, headers: headers)
+if response.code.to_i == 200
+    puts "Create Dispute API Response:"
+    puts response.body
+else
+    puts "Error: Create Dispute API"
+    puts "Status: #{response.code}"
+    puts response.body
+end
+```
+
+### Update Dispute API 
+
+```ruby
+current_timestamp = Time.now.to_i
+dispute_id = "S03-XXXXXX-XXXXXX-XXXXXX"
+
+payload = {
+    "statusDetails": {
+        "resolution": Constants::DISPUTE_RESOLUTION[:MERCHANT_WON],
+        "state": Constants::DISPUTE_STATE[:RESOLVED],
+        "reasonCode": Constants::DISPUTE_REASON_CODE[:MERCHANT_ACCEPTED_DISPUTE],
+        "reasonDescription": "Merchant accepted the dispute request"
+    },
+    "closureTimestamp": current_timestamp
+}
+
+def headers = {
+    "x-amz-pay-Idempotency-Key": SecureRandom.uuid
+}
+
+response = client.update_dispute(dispute_id, payload, headers: {})
+if response.code.to_i == 200
+    puts "Update Dispute API Response:"
+    puts response.body
+else
+    puts "Error: Update Dispute API"
+    puts "Status: #{response.code}"
+    puts response.body
+end
+```
+
+### Contest Dispute API 
+
+```ruby
+current_timestamp = Time.now.to_i
+dispute_id = "S03-XXXXXX-XXXXXX-XXXXXX"
+
+payload = {
+    "merchantEvidences": [
+        "evidenceType": "TrackingNumber",
+        "fileId": "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxx",
+        "evidenceText": "raw text supporting merchant evidence"
+    ]
+}
+
+def headers = {
+    "x-amz-pay-Idempotency-Key": SecureRandom.uuid
+}
+
+response = client.contest_dispute(dispute_id, payload, headers: {})
+if response.code.to_i == 200
+    puts "Contest Dispute API Response:"
+    puts response.body
+else
+    puts "Error: Contest Dispute API"
+    puts "Status: #{response.code}"
+    puts response.body
+end
+```
+
+### File Upload API 
+
+```ruby
+payload = {
+    "type": "jpg",
+    "purpose": "disputeEvidence"
+}
+
+def headers = {
+    "x-amz-pay-Idempotency-Key": SecureRandom.uuid
+}
+
+response = client.upload_file(payload, headers: headers)
+if response.code.to_i == 200
+    puts "Upload File API Response:"
+    puts response.body
+else
+    puts "Error: Upload File API"
+    puts "Status: #{response.code}"
+    puts response.body
+end
 ```

data/lib/{amazon_pay → amazon-pay-api-sdk-ruby}/client.rb

@@ -1,9 +1,10 @@
 require 'net/http'
 require_relative 'client_helper'
 require_relative 'constants'
+require_relative 'payment_service_provider_client'
 
 # AmazonPayClient class provides methods to interact with Amazon Pay API
-class AmazonPayClient
+class AmazonPayClient include PaymentServiceProviderClient
 
   # Initialize the client with configuration settings
   def initialize(config)
@@ -47,7 +48,6 @@ class AmazonPayClient
 
         # Increment the retry counter
         retries += 1
-        print "Retrying\n"
         # Raise an exception to force a retry
         raise "Transient error: #{response.code}" # Force retry
       end
@@ -224,6 +224,18 @@ class AmazonPayClient
     api_call("#{Constants::CHARGES_URL}/#{charge_id}", Constants::GET, headers: headers)
   end
 
+  # API to retrieve charge details. 
+  # The updateCharge operation is used to update the charge status of any PSP (Payment Service Provider) processed payment method (PPM) transactions.
+  # Please note that is API is supported only for PSPs (Payment Service Provider)
+  # @see https://developer.amazon.com/docs/amazon-pay-apis/charge.html#update-charge
+  # @param {String} charge_id - The unique ID of the charge to update.
+  # @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.
+  # @return [HTTPResponse] The response from the API call, which includes details of the requested charge.
+  def update_charge(charge_id, payload, headers: {})
+    api_call("#{Constants::CHARGES_URL}/#{charge_id}", Constants::PATCH, payload: payload, headers: headers)
+  end
+
   # API to capture a charge
   # Captures an authorized charge to collect the funds.
   # @see https://developer.amazon.com/docs/amazon-pay-api-v2/charge.html#capture-charge
@@ -266,4 +278,93 @@ class AmazonPayClient
     api_call("#{Constants::REFUNDS_URL}/#{refund_id}", Constants::GET, headers: headers)
   end
 
+  # API to retrieve a list of reports
+  # Retrieves a list of reports based on the provided query parameters.
+  # @see https://developer.amazon.com/docs/amazon-pay-api-v2/reports.html#get-reports
+  # @param {Object} headers - Optional headers for the request, such as authorization tokens or custom headers.
+  # @param {Object} query_params - Query parameters to filter the reports, such as report type or processing status.
+  # @return [HTTPResponse] The response from the API call, which includes a list of reports matching the criteria.
+  def get_reports(headers: {}, query_params: {})
+    api_call(Constants::REPORTS, Constants::GET, headers: headers, query_params: query_params)
+  end
+
+  # API to retrieve a specific report by ID
+  # Retrieves details of a specific report using its unique report ID.
+  # @see https://developer.amazon.com/docs/amazon-pay-api-v2/reports.html#get-report-by-id
+  # @param {String} report_id - The unique ID of the report to retrieve.
+  # @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 requested report.
+  def get_report_by_id(report_id, headers: {})
+    api_call("#{Constants::REPORTS}/#{report_id}", Constants::GET, headers: headers)
+  end
+
+  # API to create a new report
+  # Creates a new report based on the provided payload.
+  # @see https://developer.amazon.com/docs/amazon-pay-api-v2/reports.html#create-report
+  # @param {Object} payload - The payload containing data required to generate the report.
+  # @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 confirmation and details of the created report.
+  def create_report(payload, headers: {})
+    api_call(Constants::REPORTS, Constants::POST, payload: payload, headers: headers)
+  end
+
+  # API to retrieve a specific report document by ID
+  # Retrieves the content of a specific report document using its unique report document ID.
+  # @see https://developer.amazon.com/docs/amazon-pay-api-v2/reports.html#get-report-document
+  # @param {String} report_document_id - The unique ID of the report document to retrieve.
+  # @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 the content of the requested report document.
+  def get_report_document(report_document_id, headers: {})
+    api_call("#{Constants::REPORT_DOCUMENTS}/#{report_document_id}", Constants::GET, headers: headers)
+  end
+
+  # API to retrieve a list of report schedules
+  # Retrieves a list of report schedules based on the provided query parameters.
+  # @see https://developer.amazon.com/docs/amazon-pay-api-v2/reports.html#get-report-schedules
+  # @param {Object} headers - Optional headers for the request, such as authorization tokens or custom headers.
+  # @param {Object} query_params - Query parameters to filter the report schedules, such as schedule type or status.
+  # @return [HTTPResponse] The response from the API call, which includes a list of report schedules matching the criteria.
+  def get_report_schedules(headers: {}, query_params: {})
+    api_call(Constants::REPORT_SCHEDULES, Constants::GET, headers: headers, query_params: query_params)
+  end
+
+  # API to retrieve a specific report schedule by ID
+  # Retrieves details of a specific report schedule using its unique report schedule ID.
+  # @see https://developer.amazon.com/docs/amazon-pay-api-v2/reports.html#get-report-schedule-by-id
+  # @param {String} report_schedule_id - The unique ID of the report schedule to retrieve.
+  # @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 requested report schedule.
+  def get_report_schedule_by_id(report_schedule_id, headers: {})
+    api_call("#{Constants::REPORT_SCHEDULES}/#{report_schedule_id}", Constants::GET, headers: headers)
+  end
+
+  # API to create a new report schedule
+  # Creates a new report schedule based on the provided payload.
+  # @see https://developer.amazon.com/docs/amazon-pay-api-v2/reports.html#create-report-schedule
+  # @param {Object} payload - The payload containing data required to set up the report schedule.
+  # @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 confirmation and details of the created report schedule.
+  def create_report_schedule(payload, headers: {}, query_params: {})
+    api_call(Constants::REPORT_SCHEDULES, Constants::POST, payload: payload, headers: headers, query_params: query_params)
+  end
+
+  # API to cancel an existing report schedule by ID
+  # Cancels a specific report schedule using its unique report schedule ID.
+  # @see https://developer.amazon.com/docs/amazon-pay-api-v2/reports.html#cancel-report-schedule
+  # @param {String} report_schedule_id - The unique ID of the report schedule to cancel.
+  # @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 confirmation of the cancellation.
+  def cancel_report_schedule(report_schedule_id, headers: {})
+    api_call("#{Constants::REPORT_SCHEDULES}/#{report_schedule_id}", Constants::DELETE, headers: headers)
+  end
+
+  # API to retrieve a list of disbursements
+  # Retrieves a list of disbursements based on the provided query parameters.
+  # @see https://developer.amazon.com/docs/amazon-pay-api-v2/reports.html#get-disbursements
+  # @param {Object} headers - Optional headers for the request, such as authorization tokens or custom headers.
+  # @param {Object} query_params - Query parameters to filter the disbursements, such as date range or status.
+  # @return [HTTPResponse] The response from the API call, which includes a list of disbursements matching the criteria.
+  def get_disbursements(headers: {}, query_params: {})
+    api_call(Constants::DISBURSEMENTS, Constants::GET, headers: headers, query_params: query_params)
+  end
 end

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

@@ -0,0 +1,97 @@
+require 'net/http'
+
+module Constants
+    SDK_TYPE = "amazon-pay-api-sdk-ruby".freeze
+    SDK_VERSION = "2.0.0".freeze
+    API_VERSION = "v2".freeze
+    API_ENDPOINTS = {
+      'na' => 'pay-api.amazon.com',
+      'eu' => 'pay-api.amazon.eu',
+      'jp' => 'pay-api.amazon.jp'
+    }.freeze
+    METHOD_TYPES = {
+      'GET' => Net::HTTP::Get,
+      'POST' => Net::HTTP::Post,
+      'PUT' => Net::HTTP::Put,
+      'PATCH' => Net::HTTP::Patch,
+      'DELETE' => Net::HTTP::Delete
+    }.freeze
+    HASH_ALGORITHM = "SHA256".freeze
+    HTTPS = 'https'.freeze
+    AMAZON_SIGNATURE_ALGORITHM = "AMZN-PAY-RSASSA-PSS-V2".freeze
+    AUTHORIZATION = 'authorization'.freeze
+    ACCEPT = 'accept'.freeze
+    CONTENT_TYPE = 'content-type'.freeze
+    APPLICATION_JSON = 'application/json'.freeze
+    X_AMZ_PAY_REGION = 'x-amz-pay-region'.freeze
+    X_AMZ_PAY_DATE = 'x-amz-pay-date'.freeze
+    X_AMZ_PAY_HOST = 'x-amz-pay-host'.freeze
+    CONTENT_LENGTH = 'content-length'.freeze
+    X_AMZ_PAY_SDK_TYPE = 'x-amz-pay-sdk-type'.freeze
+    X_AMZ_PAY_SDK_VERSION = 'x-amz-pay-sdk-version'.freeze
+    LIVE = 'LIVE-'
+    SANDBOX = 'SANDBOX-'
+    MERCHANT_ACCOUNTS_BASE_URL = 'merchantAccounts'.freeze
+    GET = 'GET'.freeze
+    POST = 'POST'.freeze
+    PATCH = 'PATCH'.freeze
+    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
+    HTTP_OK = '200'
+    HTTP_SERVER_ERROR = '500'
+    BUYERS_URL = 'buyers'.freeze
+    CHECKOUT_SESSION_URL = 'checkoutSessions'.freeze
+    CHARGE_PERMISSIONS_URL = 'chargePermissions'.freeze
+    CHARGES_URL = 'charges'.freeze
+    REFUNDS_URL = 'refunds'.freeze
+    REPORTS = 'reports'.freeze
+    REPORT_SCHEDULES = 'report-schedules'.freeze
+    REPORT_DOCUMENTS = 'report-documents'.freeze
+    DISBURSEMENTS = 'disbursements'.freeze
+    DISPUTE_URLS = 'disputes'.freeze
+    FILES_URLS = 'files'.freeze
+    DISPUTE_FILING_REASON = {
+      PRODUCT_NOT_RECEIVED: "ProductNotReceived",
+      PRODUCT_UNACCEPTABLE: "ProductUnacceptable",
+      PRODUCT_NO_LONGER_NEEDED: "ProductNoLongerNeeded",
+      CREDIT_NOT_PROCESSED: "CreditNotProcessed",
+      OVERCHARGED: "Overcharged",
+      DUPLICATE_CHARGE: "DuplicateCharge",
+      SUBSCRIPTION_CANCELLED: "SubscriptionCancelled",
+      UNRECOGNIZED: "Unrecognized",
+      FRAUDULENT: "Fraudulent",
+      OTHER: "Other"
+    }.freeze
+    DISPUTE_REASON_CODE = {
+      MERCHANT_RESPONSE_REQUIRED: "MerchantResponseRequired",
+      MERCHANT_ADDITIONAL_EVIDENCES_REQUIRED: "MerchantAdditionalEvidencesRequired",
+      BUYER_ADDITIONAL_EVIDENCES_REQUIRED: "BuyerAdditionalEvidencesRequired",
+      MERCHANT_ACCEPTED_DISPUTE: "MerchantAcceptedDispute",
+      MERCHANT_RESPONSE_DEADLINE_EXPIRED: "MerchantResponseDeadlineExpired",
+      BUYER_CANCELLED: "BuyerCancelled",
+      INVESTIGATOR_RESOLVED: "InvestigatorResolved",
+      AUTO_RESOLVED: "AutoResolved",
+      CHARGEBACK_FILED: "ChargebackFiled"
+    }.freeze
+    DISPUTE_RESOLUTION = {
+      BUYER_WON: "BuyerWon",
+      MERCHANT_WON: "MerchantWon",
+      NO_FAULT: "NoFault"
+    }.freeze
+    DISPUTE_STATE = {
+      UNDER_REVIEW: "UnderReview",
+      ACTION_REQUIRED: "ActionRequired",
+      RESOLVED: "Resolved",
+      CLOSED: "Closed"
+    }.freeze
+    EVIDENCE_TYPE = {
+      PRODUCT_DESCRIPTION: "ProductDescription",
+      RECEIPT: "Receipt",
+      CANCELLATION_POLICY: "CancellationPolicy",
+      CUSTOMER_SIGNATURE: "CustomerSignature",
+      TRACKING_NUMBER: "TrackingNumber",
+      OTHER: "Other"
+    }.freeze
+end

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

@@ -0,0 +1,48 @@
+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
+    # @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.
+    def create_dispute(payload, headers: {});    
+        api_call(Constants::DISPUTE_URLS, Constants::POST, payload: payload, 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
+    # @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.
+    # @return [HTTPResponse] The response from the API call, which includes details of the dispute.
+    def update_dispute(dispute_id, payload, headers: {});    
+        api_call("#{Constants::DISPUTE_URLS}/#{dispute_id}", Constants::PATCH, payload: payload, headers: headers)
+    end
+
+    # API to contest dispute.
+    # 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.
+    # @return [HTTPResponse] The response from the API call, which includes details of the dispute.
+    def contest_dispute(dispute_id, payload, headers: {});    
+        api_call("#{Constants::DISPUTE_URLS}/#{dispute_id}/contest", Constants::POST, payload: payload, headers: headers)
+    end
+
+    # API to upload file.
+    # The uploadFile operation is utilised by PSPs (Payment Service Provider) 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  

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

@@ -0,0 +1,3 @@
+require_relative './amazon-pay-api-sdk-ruby/client'
+require_relative './amazon-pay-api-sdk-ruby/client_helper'
+require_relative "./amazon-pay-api-sdk-ruby/constants"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: amazon-pay-api-sdk-ruby
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 2.0.0
 platform: ruby
 authors:
 - AmazonPay
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-08-19 00:00:00.000000000 Z
+date: 2025-03-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64
@@ -31,7 +31,7 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.0'
-  type: :runtime
+  type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
@@ -46,10 +46,11 @@ extra_rdoc_files: []
 files:
 - LICENSE
 - README.md
-- lib/amazon_pay.rb
-- lib/amazon_pay/client.rb
-- lib/amazon_pay/client_helper.rb
-- lib/amazon_pay/constants.rb
+- lib/amazon-pay-api-sdk-ruby.rb
+- lib/amazon-pay-api-sdk-ruby/client.rb
+- lib/amazon-pay-api-sdk-ruby/client_helper.rb
+- lib/amazon-pay-api-sdk-ruby/constants.rb
+- lib/amazon-pay-api-sdk-ruby/payment_service_provider_client.rb
 homepage: https://rubygems.org/gems/amazon-pay-api-sdk-ruby
 licenses:
 - Apache-2.0

data/lib/amazon_pay/constants.rb

@@ -1,49 +0,0 @@
-require 'net/http'
-
-module Constants
-    SDK_TYPE = "amazon-pay-api-sdk-ruby".freeze
-    SDK_VERSION = "1.1.0".freeze
-    API_VERSION = "v2".freeze
-    API_ENDPOINTS = {
-      'na' => 'pay-api.amazon.com',
-      'eu' => 'pay-api.amazon.eu',
-      'jp' => 'pay-api.amazon.jp'
-    }.freeze
-    METHOD_TYPES = {
-      'GET' => Net::HTTP::Get,
-      'POST' => Net::HTTP::Post,
-      'PUT' => Net::HTTP::Put,
-      'PATCH' => Net::HTTP::Patch,
-      'DELETE' => Net::HTTP::Delete
-    }.freeze
-    HASH_ALGORITHM = "SHA256".freeze
-    HTTPS = 'https'.freeze
-    AMAZON_SIGNATURE_ALGORITHM = "AMZN-PAY-RSASSA-PSS-V2".freeze
-    AUTHORIZATION = 'authorization'.freeze
-    ACCEPT = 'accept'.freeze
-    CONTENT_TYPE = 'content-type'.freeze
-    APPLICATION_JSON = 'application/json'.freeze
-    X_AMZ_PAY_REGION = 'x-amz-pay-region'.freeze
-    X_AMZ_PAY_DATE = 'x-amz-pay-date'.freeze
-    X_AMZ_PAY_HOST = 'x-amz-pay-host'.freeze
-    CONTENT_LENGTH = 'content-length'.freeze
-    X_AMZ_PAY_SDK_TYPE = 'x-amz-pay-sdk-type'.freeze
-    X_AMZ_PAY_SDK_VERSION = 'x-amz-pay-sdk-version'.freeze
-    LIVE = 'LIVE-'
-    SANDBOX = 'SANDBOX-'
-    MERCHANT_ACCOUNTS_BASE_URL = 'merchantAccounts'.freeze
-    GET = 'GET'.freeze
-    POST = 'POST'.freeze
-    PATCH = 'PATCH'.freeze
-    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
-    HTTP_OK = '200'
-    HTTP_SERVER_ERROR = '500'
-    BUYERS_URL = 'buyers'.freeze
-    CHECKOUT_SESSION_URL = 'checkoutSessions'.freeze
-    CHARGE_PERMISSIONS_URL = 'chargePermissions'.freeze
-    CHARGES_URL = 'charges'.freeze
-    REFUNDS_URL = 'refunds'.freeze
-end

data/lib/amazon_pay.rb

@@ -1,3 +0,0 @@
-require_relative './amazon_pay/client'
-require_relative './amazon_pay/client_helper'
-require_relative "./amazon_pay/constants"