veritrans 2.4.0 → 2.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c2484ec329b86513d8003585c7aa216fca7d4b3249fbb7a3111effdcca5b7a87
-  data.tar.gz: 7e2a60467217efaf6eafc968c8855cceab8957dbdecd365fbb55817cb52d721f
+  metadata.gz: b8f40c46b892c2f87d0803387f08aeb565e7b5ecea9e26d4962fb5e852d5cbbb
+  data.tar.gz: 79ce221c6297fbc3558e60881704a0b6c72bce9353ce85c500f7145d1928a30d
 SHA512:
-  metadata.gz: 19777da7f7a41ca65c971e377145b35c2a2202ca2b241d0c49eb88cd7cb89f37f11c96356738fe5331f12c94b58c2a290979e806dd83f9388856ae8037014e4c
-  data.tar.gz: 9a12920d515efb504782f42d2fbc65d02c09d76c23f28c6c55418ca9c9dd11e8c6eb522cd0688a3c404786565d2449f2926d6fd7eae4ee8f0ceb2329e32b5aa7
+  metadata.gz: 6ec9419b6388b39665415dcfccb10acde81266d4ac338259bed4e033cca4c6240f4e6e7f7cf631f541ed831cefd033bb11b49b4eafda0781468a84f381924cfb
+  data.tar.gz: 8906403f8cc21a0963697b1e6b3283f8f8c8f30cc22305348cc7e96fadccd9817594b5d330dfea4b5001904fee71295b3b60c6751f81da771bf9fb20f7310482

data/Gemfile

@@ -1,8 +1,6 @@
 source 'https://rubygems.org'
 
 gem 'puma'
-gem 'rails', '< 7'
-gem 'rake'
 gem 'sinatra'
 gem 'tilt'
 gem 'sqlite3'

data/Gemfile.lock

@@ -1,155 +1,30 @@
 PATH
   remote: .
   specs:
-    veritrans (2.4.0)
+    veritrans (2.4.1)
       excon (~> 0.20)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    actioncable (6.1.4.1)
-      actionpack (= 6.1.4.1)
-      activesupport (= 6.1.4.1)
-      nio4r (~> 2.0)
-      websocket-driver (>= 0.6.1)
-    actionmailbox (6.1.4.1)
-      actionpack (= 6.1.4.1)
-      activejob (= 6.1.4.1)
-      activerecord (= 6.1.4.1)
-      activestorage (= 6.1.4.1)
-      activesupport (= 6.1.4.1)
-      mail (>= 2.7.1)
-    actionmailer (6.1.4.1)
-      actionpack (= 6.1.4.1)
-      actionview (= 6.1.4.1)
-      activejob (= 6.1.4.1)
-      activesupport (= 6.1.4.1)
-      mail (~> 2.5, >= 2.5.4)
-      rails-dom-testing (~> 2.0)
-    actionpack (6.1.4.1)
-      actionview (= 6.1.4.1)
-      activesupport (= 6.1.4.1)
-      rack (~> 2.0, >= 2.0.9)
-      rack-test (>= 0.6.3)
-      rails-dom-testing (~> 2.0)
-      rails-html-sanitizer (~> 1.0, >= 1.2.0)
-    actiontext (6.1.4.1)
-      actionpack (= 6.1.4.1)
-      activerecord (= 6.1.4.1)
-      activestorage (= 6.1.4.1)
-      activesupport (= 6.1.4.1)
-      nokogiri (>= 1.12.5)
-    actionview (6.1.4.1)
-      activesupport (= 6.1.4.1)
-      builder (~> 3.1)
-      erubi (~> 1.4)
-      rails-dom-testing (~> 2.0)
-      rails-html-sanitizer (~> 1.1, >= 1.2.0)
-    activejob (6.1.4.1)
-      activesupport (= 6.1.4.1)
-      globalid (>= 0.3.6)
-    activemodel (6.1.4.1)
-      activesupport (= 6.1.4.1)
-    activerecord (6.1.4.1)
-      activemodel (= 6.1.4.1)
-      activesupport (= 6.1.4.1)
-    activestorage (6.1.4.1)
-      actionpack (= 6.1.4.1)
-      activejob (= 6.1.4.1)
-      activerecord (= 6.1.4.1)
-      activesupport (= 6.1.4.1)
-      marcel (~> 1.0.0)
-      mini_mime (>= 1.1.0)
-    activesupport (6.1.4.1)
-      concurrent-ruby (~> 1.0, >= 1.0.2)
-      i18n (>= 1.6, < 2)
-      minitest (>= 5.1)
-      tzinfo (~> 2.0)
-      zeitwerk (~> 2.3)
-    builder (3.2.4)
-    concurrent-ruby (1.1.9)
-    crass (1.0.6)
-    erubi (1.10.0)
-    excon (0.85.0)
-    globalid (0.5.2)
-      activesupport (>= 5.0)
-    i18n (1.8.10)
-      concurrent-ruby (~> 1.0)
-    loofah (2.12.0)
-      crass (~> 1.0.2)
-      nokogiri (>= 1.5.9)
-    mail (2.7.1)
-      mini_mime (>= 0.1.1)
-    marcel (1.0.2)
-    method_source (1.0.0)
-    mini_mime (1.1.1)
-    mini_portile2 (2.6.1)
+    excon (0.88.0)
     minitest (5.14.4)
     mustermann (1.1.1)
       ruby2_keywords (~> 0.0.1)
     nio4r (2.5.8)
-    nokogiri (1.12.5)
-      mini_portile2 (~> 2.6.1)
-      racc (~> 1.4)
-    nokogiri (1.12.5-x86_64-darwin)
-      racc (~> 1.4)
     puma (5.5.0)
       nio4r (~> 2.0)
-    racc (1.5.2)
     rack (2.2.3)
     rack-protection (2.1.0)
       rack
-    rack-test (1.1.0)
-      rack (>= 1.0, < 3)
-    rails (6.1.4.1)
-      actioncable (= 6.1.4.1)
-      actionmailbox (= 6.1.4.1)
-      actionmailer (= 6.1.4.1)
-      actionpack (= 6.1.4.1)
-      actiontext (= 6.1.4.1)
-      actionview (= 6.1.4.1)
-      activejob (= 6.1.4.1)
-      activemodel (= 6.1.4.1)
-      activerecord (= 6.1.4.1)
-      activestorage (= 6.1.4.1)
-      activesupport (= 6.1.4.1)
-      bundler (>= 1.15.0)
-      railties (= 6.1.4.1)
-      sprockets-rails (>= 2.0.0)
-    rails-dom-testing (2.0.3)
-      activesupport (>= 4.2.0)
-      nokogiri (>= 1.6)
-    rails-html-sanitizer (1.4.2)
-      loofah (~> 2.3)
-    railties (6.1.4.1)
-      actionpack (= 6.1.4.1)
-      activesupport (= 6.1.4.1)
-      method_source
-      rake (>= 0.13)
-      thor (~> 1.0)
-    rake (13.0.6)
     ruby2_keywords (0.0.5)
     sinatra (2.1.0)
       mustermann (~> 1.0)
       rack (~> 2.2)
       rack-protection (= 2.1.0)
       tilt (~> 2.0)
-    sprockets (4.0.2)
-      concurrent-ruby (~> 1.0)
-      rack (> 1, < 3)
-    sprockets-rails (3.2.2)
-      actionpack (>= 4.0)
-      activesupport (>= 4.0)
-      sprockets (>= 3.0.0)
     sqlite3 (1.4.2)
-    thor (1.1.0)
     tilt (2.0.10)
-    tzinfo (2.0.4)
-      concurrent-ruby (~> 1.0)
-    websocket-driver (0.7.5)
-      websocket-extensions (>= 0.1.0)
-    websocket-extensions (0.1.5)
-    zeitwerk (2.4.2)
 
 PLATFORMS
   ruby
@@ -158,8 +33,6 @@ PLATFORMS
 DEPENDENCIES
   minitest (~> 5.14, >= 5.14.4)
   puma
-  rails (< 7)
-  rake
   sinatra
   sqlite3
   tilt

data/Maintaining.md

@@ -0,0 +1,17 @@
+> Warning: This note is for developer/maintainer of this package only
+
+## Updating Package
+
+- Make your changes
+- Update `version` value on `version.rb` file
+- To install the package from local codes, you should build a gem `gem build veritrans.gemspec` after that `gem install veritrans-x.y.z.gem` (replace `x.y.z` with the version number e.g. `gem install veritrans-2.4.0.gem`)
+  - Note: In case you want to test another new code changes, you will need to re-build & re-install, so that your latest code will be used by the locally installed gem
+- To run all test `cd /lib/test` and after that `ruby -Itest all.rb`
+- To run specific test `ruby snap_test.rb`
+- If you are using Rubymine, you can right click folder test and choose `run all tests in test`
+
+## Update Rubygems.org
+- Run this command `gem build veritrans.gemspec`
+- Run this command `gem push veritrans-x.y.z.gem` (replace `x.y.z` with the version number e.g. `gem push veritrans-2.4.0.gem`), after that you are required to enter email and password account in Rubygems.org
+- You can get account Rubygems.org in `Account Access & Resources`
+- If you are using Rubymine, you can use `Tools -> Gem -> Build Gem` and `Push Gem`

data/README.md

@@ -60,6 +60,9 @@ Midtrans.config.server_key = "your server key"
 Midtrans.config.client_key = "your client key"
 Midtrans.config.api_host = "https://api.sandbox.midtrans.com"
 ```
+Follow the steps given below to switch to Midtrans Production environment and to accept real payments from real customers.
+1. Change api_host URL from `https://api.sandbox.midtrans.com` to `https://api.midtrans.com`.
+2. Use Client Key and Server Key for Production environment. For more details, refer to [Retrieving API Access Keys](https://docs.midtrans.com/en/midtrans-account/overview?id=retrieving-api-access-keys).
 
 ### 2.2.A Snap
 You can see Snap example [with Sinatra](example/sinatra) and [without framework](example/snap).
@@ -230,6 +233,94 @@ The credit card charge result may contains `redirect_url` for 3DS authentication
 For full example on Credit Card 3DS transaction refer to:
 - [Sinatra example](/example/sinatra) that implement Snap & Core Api
 
+### 2.2.D Subscription API
+
+You can see some Subscription API examples [here](example/subscription), [Subscription API Docs](https://api-docs.midtrans.com/#subscription-api).
+
+#### Subscription API for Credit Card
+
+To use subscription API for credit card, you should first obtain the 1-click saved token, [refer to this docs.](https://docs.midtrans.com/en/core-api/advanced-features?id=recurring-transaction-with-subscriptions-api)
+You will receive `saved_token_id` as part of the response when the initial card payment is accepted (will also available in the HTTP notification's JSON), [refer to this docs.](https://docs.midtrans.com/en/core-api/advanced-features?id=sample-3ds-authenticate-json-response-for-the-first-transaction)
+```ruby
+require 'veritrans'
+# Set Midtrans config
+Midtrans.config.server_key = "your server key"
+Midtrans.config.client_key = "your client key"
+Midtrans.config.api_host = "https://api.sandbox.midtrans.com"
+# Prepare parameter
+parameter = {
+  "name": "monthly_subscription",
+  "amount": "14000",
+  "currency": "IDR",
+  "payment_type": "credit_card",
+  "token": saved_token_id,
+  "schedule": {
+    "interval": 1,
+    "interval_unit": "month",
+    "max_interval": 12,
+    #start_time value is just a sample time & should be replaced with a valid future time.
+    "start_time": "2022-12-20 07:00:00 +0700"
+  },
+  "metadata": {
+    "description": "Recurring payment for A"
+  },
+  "customer_details": {
+    "first_name": "John",
+    "last_name": "Doe",
+    "email": "johndoe@email.com",
+    "phone": "+62812345678"
+  }
+}
+
+result = Midtrans.create_subscription(parameter)
+puts "Create subscription response : #{result.data}"
+
+result_get_subs = Midtrans.get_subscription(subscription_id)
+puts "get subscription response : #{result_get_subs.data}"
+
+result_enable_subs = Midtrans.enable_subscription(subscription_id)
+puts "enable subscription response : #{result_enable_subs.data}"
+
+# update subscription by subscription_id and update_subscription_param
+result_update_subs = Midtrans.update_subscription(subscription_id, update_subscription_param)
+puts "update subscription response : #{result_update_subs.data}"
+
+# disable subscription by subscription_id
+result_disable_subs = Midtrans.disable_subscription(subscription_id)
+puts "disable subscription response : #{result_disable_subs.data}"
+```
+
+#### Subscription API for Gopay
+
+To use subscription API for gopay, you should first link your customer gopay account with gopay tokenization API, [refer to this section.](#22e-tokenization-api) You will receive gopay payment token using `getPaymentAccount` API call. You can see some Subscription API examples [here](example/subscription)
+
+### 2.2.E Tokenization API
+You can see some Tokenization API examples [here](examples/tokenization), [Tokenization API Docs.](https://api-docs.midtrans.com/#gopay-tokenization)
+```ruby
+require 'veritrans'
+# Set Midtrans config
+Midtrans.config.server_key = "your server key"
+Midtrans.config.client_key = "your client key"
+Midtrans.config.api_host = "https://api.sandbox.midtrans.com"
+# Prepare parameter
+parameter = {
+  "payment_type": "gopay",
+  "gopay_partner": {
+    "phone_number": "81987654321",
+    "country_code": "62",
+    "redirect_url": "https://www.gojek.com"
+  }
+}
+
+result = Midtrans.link_payment_account(parameter)
+puts "Create pay account response : #{result.data}"
+
+result_get_account = Midtrans.get_payment_account(active_account_id)
+puts "Get pay account response : #{result_get_account.data}"
+
+result_unlink = Midtrans.unlink_payment_account(active_account_id)
+puts "Unlink response : #{result_unlink.data}"
+```
 
 ### 2.3 Handle HTTP Notification
 > **IMPORTANT NOTE**: To update transaction status on your backend/database, **DO NOT** solely rely on frontend callbacks! For security reason to make sure the status is authentically coming from Midtrans, only update transaction status based on HTTP Notification or API Get Status.

data/example/subscription/credit_card_subscription_example.rb

@@ -0,0 +1,138 @@
+require 'veritrans'
+
+# This is just for very basic implementation reference, in production, you should validate the incoming requests and implement your backend more securely.
+
+# Set Midtrans config
+# You can find it in Merchant Portal -> Settings -> Access keys
+Midtrans.config.server_key = "SB-Mid-server-uQmMImQMeo0Ky3Svl90QTUj2"
+Midtrans.config.client_key = "SB-Mid-client-ArNfhrh7st9bQKmz"
+Midtrans.config.api_host = "https://api.sandbox.midtrans.com"
+
+# To use API subscription for credit card, you should first obtain the 1 click token
+# Refer to this docs: https://docs.midtrans.com/en/core-api/advanced-features?id=recurring-transaction-with-subscriptions-api
+
+# You will receive saved_token_id as part of the response when the initial card payment is accepted (will also available in the HTTP notification's JSON)
+# Refer to this docs: https://docs.midtrans.com/en/core-api/advanced-features?id=sample-3ds-authenticate-json-response-for-the-first-transaction
+# {
+# .
+# "status_code": "200",
+# "signature_key": "02d88dbe3ea009934daae63f0ec10b3078f92bbd75139cc9834689b92e707d305fb04b079020e877703c5ddbfbd779d5e2f62dc6edd63b0e68edeb57a985cf38",
+# "saved_token_id_expired_at": "2025-12-31 07:00:00",
+# "saved_token_id": "521111eLfszZpPoDAxJEjmoYCuaR1117",
+# .
+# }
+# Sample saved token id for testing purpose
+saved_token_id = "521111eLfszZpPoDAxJEjmoYCuaR1117"
+
+# prepare parameter ( refer to: https://api-docs.midtrans.com/#create-subscription ) create subscription parameter example
+begin
+parameter = {
+  "name": "monthly_subscription",
+  "amount": "14000",
+  "currency": "IDR",
+  "payment_type": "credit_card",
+  "token": saved_token_id,
+  "schedule": {
+    "interval": 1,
+    "interval_unit": "month",
+    "max_interval": 12,
+    # start_time value is just a sample time & should be replaced with a valid future time.
+    "start_time": "2022-12-20 07:00:00 +0700"
+  },
+  "metadata": {
+    "description": "Recurring payment for A"
+  },
+  "customer_details": {
+    "first_name": "John",
+    "last_name": "Doe",
+    "email": "johndoe@email.com",
+    "phone": "+62812345678"
+  }
+}
+
+result = Midtrans.create_subscription(parameter)
+puts "Create subscription response : #{result.data}"
+rescue MidtransError => e
+  puts e.message # Basic message error
+  puts e.http_status_code # HTTP status code e.g: 400, 401, etc.
+  puts e.api_response # API response body in String
+  puts e.raw_http_client_data # Raw HTTP client response
+end
+# result.data this will be Hash representation of the API JSON response
+# {
+# 	: id => "1d9c15ea-13e2-43f3-a87b-90aad6a9ad95",
+# 	: name => "MONTHLY_2021",
+# 	: amount => "14000",
+# 	: currency => "IDR",
+# 	: created_at => "2021-12-16 13:19:25",
+# 	: schedule => {
+# 		"interval" => 1, "current_interval" => 0, "max_interval" => 12, "interval_unit" => "month", "start_time" => "2021-12-20 07:00:00", "next_execution_at" => "2021-12-20 07:00:00"
+# 	},
+# 	: status => "active",
+# 	: token => "521111eLfszZpPoDAxJEjmoYCuaR1117",
+# 	: payment_type => "credit_card",
+# 	: transaction_ids => [],
+# 	: metadata => {
+# 		"description" => "Recurring payment for A"
+# 	},
+# 	: customer_details => {
+# 		"email" => "johndoe@email.com", "first_name" => "John", "last_name" => "Doe", "phone" => "+62812345678"
+# 	}
+# }
+
+# Sample active subscription id for testing purpose
+subscription_id = "1d9c15ea-13e2-43f3-a87b-90aad6a9ad95"
+
+# get subscription by subscription_id
+begin
+result_get_subs = Midtrans.get_subscription(subscription_id)
+puts "get subscription response : #{result_get_subs.data}"
+rescue MidtransError => e
+  puts e.message # Basic message error
+  puts e.http_status_code # HTTP status code e.g: 400, 401, etc.
+  puts e.api_response # API response body in String
+  puts e.raw_http_client_data # Raw HTTP client response
+end
+
+# enable subscription by subscription_id
+begin
+result_enable_subs = Midtrans.enable_subscription(subscription_id)
+puts "enable subscription response : #{result_enable_subs.data}"
+rescue MidtransError => e
+  puts e.message # Basic message error
+  puts e.http_status_code # HTTP status code e.g: 400, 401, etc.
+  puts e.api_response # API response body in String
+  puts e.raw_http_client_data # Raw HTTP client response
+end
+
+# update subscription by subscription_id and update_subscription_param
+begin
+update_subscription_param = {
+  "name": "monthly_subscription",
+  "amount": "300000",
+  "currency": "IDR",
+  "token": saved_token_id,
+  "schedule": {
+    "interval": 1
+  }
+}
+
+result_update_subs = Midtrans.update_subscription(subscription_id, update_subscription_param)
+puts "update subscription response : #{result_update_subs.data}"
+rescue MidtransError => e
+  puts e.message # Basic message error
+  puts e.http_status_code # HTTP status code e.g: 400, 401, etc.
+  puts e.api_response # API response body in String
+  puts e.raw_http_client_data # Raw HTTP client response
+end
+
+# disable subscription by subscription_id
+begin
+result_disable_subs = Midtrans.disable_subscription(subscription_id)
+puts "disable subscription response : #{result_disable_subs.data}"
+rescue MidtransError => e
+  puts e.message # Basic message error
+  puts e.http_status_code # HTTP status code e.g: 400, 401, etc.
+  puts e.api_response # API response body in String
+  puts e.raw_http_client_data # Raw HTTP client response
+end

data/example/subscription/gopay_subscription_example.rb

@@ -0,0 +1,153 @@
+require 'veritrans'
+
+# This is just for very basic implementation reference, in production, you should validate the incoming requests and implement your backend more securely.
+
+# Set Midtrans config
+# You can find it in Merchant Portal -> Settings -> Access keys
+Midtrans.config.server_key = "SB-Mid-server-uQmMImQMeo0Ky3Svl90QTUj2"
+Midtrans.config.client_key = "SB-Mid-client-ArNfhrh7st9bQKmz"
+Midtrans.config.api_host = "https://api.sandbox.midtrans.com"
+
+# To use API subscription for gopay, you should first link your customer gopay account with gopay tokenization
+# Refer to this docs: https://api-docs.midtrans.com/#gopay-tokenization
+
+# You will receive gopay payment token using `get_payment_account` API call.
+# You can see some Tokenization API examples here (examples/tokenization)
+# {
+# 	: status_code => "200",: payment_type => "gopay",: account_id => "7501d1f5-697c-4b4b-b095-69e60003759f",: account_status => "ENABLED",: metadata => {
+# 		"payment_options" => [{
+# 			"name" => "GOPAY_WALLET",
+# 			"active" => true,
+# 			"balance" => {
+# 				"value" => "8000000.00", "currency" => "IDR"
+# 			},
+# 			"metadata" => {},
+# 			"token" => "de60838a-4fb7-48af-89b8-4741ba8e5404"
+# 		}, {
+# 			"name" => "PAY_LATER",
+# 			"active" => true,
+# 			"balance" => {
+# 				"value" => "8000000.00", "currency" => "IDR"
+# 			},
+# 			"metadata" => {},
+# 			"token" => "5b141678-7dc3-4f36-a5ec-c74ce62d2c46"
+# 		}]
+# 	}
+# }
+# Sample gopay payment option token and gopay account id for testing purpose that has been already activated before
+gopay_payment_option_token = "de60838a-4fb7-48af-89b8-4741ba8e5404"
+gopay_account_id = "7501d1f5-697c-4b4b-b095-69e60003759f"
+
+# prepare CORE API parameter ( refer to: https://api-docs.midtrans.com/#create-subscription ) create subscription parameter example
+begin
+parameter = {
+  "name": "gopay_monthly_subscription",
+  "amount": "10000",
+  "currency": "IDR",
+  "payment_type": "gopay",
+  "token": gopay_payment_option_token,
+  "schedule": {
+    "interval": 1,
+    "interval_unit": "day",
+    "max_interval": 7
+  },
+  "metadata": {
+    "description": "Recurring payment for A"
+  },
+  "customer_details": {
+    "first_name": "John A",
+    "last_name": "Doe A",
+    "email": "johndoe@email.com",
+    "phone": "+62812345678"
+  },
+  "gopay": {
+    "account_id": gopay_account_id
+  }
+}
+
+result = Midtrans.create_subscription(parameter)
+puts "Create subscription response : #{result.data}"
+rescue MidtransError => e
+  puts e.message # Basic message error
+  puts e.http_status_code # HTTP status code e.g: 400, 401, etc.
+  puts e.api_response # API response body in String
+  puts e.raw_http_client_data # Raw HTTP client response
+end
+# result.data this will be Hash representation of the API JSON response
+# {
+# 	: id => "c04d89cb-ece6-4419-a87a-f773b243760d",
+# 	: name => "SUBS-Gopay-2021",
+# 	: amount => "10000",
+# 	: currency => "IDR",
+# 	: created_at => "2021-12-17 11:05:16",
+# 	: schedule => {
+# 		"interval" => 1, "current_interval" => 0, "max_interval" => 7, "interval_unit" => "day", "start_time" => "2021-12-17 11:05:16", "previous_execution_at" => "2021-12-17 11:05:16", "next_execution_at" => "2021-12-18 11:05:16"
+# 	},
+# 	: status => "active",
+# 	: token => "de60838a-4fb7-48af-89b8-4741ba8e5404",
+# 	: payment_type => "gopay",
+# 	: transaction_ids => [],
+# 	: metadata => {
+# 		"description" => "Recurring payment for A"
+# 	},
+# 	: customer_details => {
+# 		"email" => "johndoe@email.com", "first_name" => "John A", "last_name" => "Doe A", "phone" => "+62812345678"
+# 	}
+# }
+
+# sample active subscription id for testing purpose
+subscription_id = "c04d89cb-ece6-4419-a87a-f773b243760d"
+
+# get subscription by subscription_id
+begin
+result_get_subs = Midtrans.get_subscription(subscription_id)
+puts "get subscription response : #{result_get_subs.data}"
+rescue MidtransError => e
+  puts e.message # Basic message error
+  puts e.http_status_code # HTTP status code e.g: 400, 401, etc.
+  puts e.api_response # API response body in String
+  puts e.raw_http_client_data # Raw HTTP client response
+end
+
+# enable subscription by subscription_id
+begin
+result_enable_subs = Midtrans.enable_subscription(subscription_id)
+puts "enable subscription response : #{result_enable_subs.data}"
+rescue MidtransError => e
+  puts e.message # Basic message error
+  puts e.http_status_code # HTTP status code e.g: 400, 401, etc.
+  puts e.api_response # API response body in String
+  puts e.raw_http_client_data # Raw HTTP client response
+end
+
+# update subscription by subscription_id and update_subscription_param
+begin
+  update_subscription_param = {
+  "name": "gopay_monthly_subscription",
+  "amount": "300000",
+  "currency": "IDR",
+  "token": gopay_payment_option_token,
+  "schedule": {
+    "interval": 1
+  }
+}
+
+result_update_subs = Midtrans.update_subscription(subscription_id, update_subscription_param)
+puts "update subscription response : #{result_update_subs.data}"
+rescue MidtransError => e
+  puts e.message # Basic message error
+  puts e.http_status_code # HTTP status code e.g: 400, 401, etc.
+  puts e.api_response # API response body in String
+  puts e.raw_http_client_data # Raw HTTP client response
+end
+
+# disable subscription by subscription_id
+begin
+result_disable_subs = Midtrans.disable_subscription(subscription_id)
+puts "disable subscription response : #{result_disable_subs.data}"
+rescue MidtransError => e
+  puts e.message # Basic message error
+  puts e.http_status_code # HTTP status code e.g: 400, 401, etc.
+  puts e.api_response # API response body in String
+  puts e.raw_http_client_data # Raw HTTP client response
+end

data/example/subscription/readme.md

@@ -0,0 +1,4 @@
+How to run subscription example:
+
+1. Install dependencies: `gem install veritrans`
+2. Run the file: `ruby credit_card_subscription_example.rb` and `ruby gopay_subscription_example.rb`

data/example/tokenization/gopay_tokenization_example.rb

@@ -0,0 +1,144 @@
+require 'veritrans'
+
+# This is just for very basic implementation reference, in production, you should validate the incoming requests and implement your backend more securely.
+
+# Set Midtrans config
+# You can find it in Merchant Portal -> Settings -> Access keys
+Midtrans.config.server_key = "SB-Mid-server-uQmMImQMeo0Ky3Svl90QTUj2"
+Midtrans.config.client_key = "SB-Mid-client-ArNfhrh7st9bQKmz"
+Midtrans.config.api_host = "https://api.sandbox.midtrans.com"
+
+# prepare CORE API parameter ( refer to: https://api-docs.midtrans.com/#create-pay-account ) create pay account parameter example
+begin
+parameter = {
+  "payment_type": "gopay",
+  "gopay_partner": {
+    "phone_number": "81987654321",
+    "country_code": "62",
+    "redirect_url": "https://www.gojek.com"
+  }
+}
+
+# link payment account
+result = Midtrans.link_payment_account(parameter)
+puts "Create pay account response : #{result.data}"
+rescue MidtransError => e
+  puts e.message # Basic message error
+  puts e.http_status_code # HTTP status code e.g: 400, 401, etc.
+  puts e.api_response # API response body in String
+  puts e.raw_http_client_data # Raw HTTP client response
+end
+# sample response :
+# {
+# 	: status_code => "201",: payment_type => "gopay",: account_id => "7501d1f5-697c-4b4b-b095-69e60003759f",: account_status => "PENDING",: actions => [{
+# 		"name" => "activation-deeplink",
+# 		"method" => "GET",
+# 		"url" => "https://api.sandbox.midtrans.com/v2/pay/account/gpar_a5f424d0-c215-4633-b72d-6cac3bbc4328/link"
+# 	}, {
+# 		"name" => "activation-link-url",
+# 		"method" => "GET",
+# 		"url" => "https://api.sandbox.midtrans.com/v2/pay/account/gpar_a5f424d0-c215-4633-b72d-6cac3bbc4328/link"
+# 	}, {
+# 		"name" => "activation-link-app",
+# 		"method" => "GET",
+# 		"url" => "https://simulator.sandbox.midtrans.com/gopay/partner/web/otp?id=1cf353e9-d2ba-44e3-b6dc-00b2eb706ca9"
+# 	}],: metadata => {
+# 		"reference_id" => "d7e7cabe-a516-442f-b97a-230249cd62d0"
+# 	}
+# }
+# for the first link, the account status is PENDING, you must activate it by accessing one of the URLs on the actions object
+
+# Sample active account id for testing purpose
+active_account_id = "bf45fd32-c379-4ef1-8ef6-b51c81da0204"
+active_account_id_2 = "7501d1f5-697c-4b4b-b095-69e60003759f"
+
+# Get payment account by account id
+begin
+result_get_account = Midtrans.get_payment_account(active_account_id)
+puts "Get pay account response : #{result_get_account.data}"
+rescue MidtransError => e
+  puts e.message # Basic message error
+  puts e.http_status_code # HTTP status code e.g: 400, 401, etc.
+  puts e.api_response # API response body in String
+  puts e.raw_http_client_data # Raw HTTP client response
+end
+# sample response :
+# {
+#   : status_code => "200",: payment_type => "gopay",: account_id => "bf45fd32-c379-4ef1-8ef6-b51c81da0204",: account_status => "ENABLED",: metadata => {
+#   "payment_options" => [{
+#   "name" => "GOPAY_WALLET",
+#   "active" => true,
+#   "balance" => {
+#     "value" => "8000000.00", "currency" => "IDR"
+#   },
+#   "metadata" => {},
+#   "token" => "ebce5a0a-69d0-4961-bb23-390a9df9f4f9"
+# }, {
+#   "name" => "PAY_LATER",
+#   "active" => true,
+#   "balance" => {
+#     "value" => "8000000.00", "currency" => "IDR"
+#   },
+#   "metadata" => {},
+#   "token" => "0272b39c-13bb-4aba-be68-74074f85aa86"
+# }]
+# }
+# }
+
+# sample param request charge
+begin
+params = {
+  "payment_type": "gopay",
+  "gopay": {
+    "account_id": active_account_id,
+    "payment_option_token": "0272b39c-13bb-4aba-be68-74074f85aa86",
+    "callback_url": "https://mywebstore.com/gopay-linking-finish"
+  },
+  "transaction_details": {
+    "gross_amount": 1000,
+    "order_id": "Gopaylink-sample-#{Time.now.to_i}"
+  }
+}
+# sample request charge
+result_charge = Midtrans.charge(params)
+puts "charge response : #{result_charge.data}"
+rescue MidtransError => e
+  puts e.message # Basic message error
+  puts e.http_status_code # HTTP status code e.g: 400, 401, etc.
+  puts e.api_response # API response body in String
+  puts e.raw_http_client_data # Raw HTTP client response
+end
+
+# sample charge response
+# {
+#   : status_code => "200",
+#   : status_message => "Success, GoPay transaction is successful",
+#   : transaction_id => "55de5840-99f1-4b1d-a5fb-1b48d4ab321c",
+#   : order_id => "Gopaylink-sample-1641270143",
+#   : merchant_id => "G686051436",
+#   : gross_amount => "10000.00",
+#   : currency => "IDR",
+#   : payment_type => "gopay",
+#   : transaction_time => "2022-01-04 11:22:24",
+#   : transaction_status => "settlement",
+#   : fraud_status => "accept",
+#   : settlement_time => "2022-01-04 11:22:24"
+# }
+
+# unlink payment account by accountId
+# when account status still PENDING, you will get status code 412
+# sample response :
+#   {
+#        "status_code": "412",
+#        "status_message": "Account status cannot be updated.",
+#        "id": "358fdb22-1be2-4e6d-888d-b6703d60af6e"
+#  }
+begin
+result_unlink = Midtrans.unlink_payment_account(active_account_id_2)
+puts "Unlink response : #{result_unlink.data}"
+rescue MidtransError => e
+  puts e.message # Basic message error
+  puts e.http_status_code # HTTP status code e.g: 400, 401, etc.
+  puts e.api_response # API response body in String
+  puts e.raw_http_client_data # Raw HTTP client response
+end

data/example/tokenization/readme.md

@@ -0,0 +1,4 @@
+How to run subscription example:
+
+1. Install dependencies: `gem install veritrans`
+2. Run the file: `ruby gopay_tokenization_example.rb` 

data/lib/veritrans/client.rb

@@ -126,7 +126,7 @@ class Veritrans
           status_code = Integer(response_body["status_code"])
           if status_code >= 400 && status_code != 407
             raise MidtransError.new(
-              "Midtrans API is returning API error. HTTP status code: #{status_code}",
+              "Midtrans API is returning API error. HTTP status code: #{status_code} API response: #{response_body}",
               "#{status_code}",
               "#{response_body}",
               "#{response}")

data/lib/veritrans/version.rb

@@ -1,3 +1,3 @@
 class Veritrans
-  VERSION = "2.4.0"
+  VERSION = "2.4.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: veritrans
 version: !ruby/object:Gem::Version
-  version: 2.4.0
+  version: 2.4.1
 platform: ruby
 authors:
 - Veritrans Dev Team
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-10-27 00:00:00.000000000 Z
+date: 2022-01-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: excon
@@ -38,7 +38,7 @@ files:
 - CHANGELOG.md
 - Gemfile
 - Gemfile.lock
-- Maintaining.MD
+- Maintaining.md
 - README.md
 - api_reference.md
 - example/coreapi/core_api_credit_card_example.rb
@@ -52,6 +52,11 @@ files:
 - example/sinatra/webapp.rb
 - example/snap/readme.md
 - example/snap/snap_example.rb
+- example/subscription/credit_card_subscription_example.rb
+- example/subscription/gopay_subscription_example.rb
+- example/subscription/readme.md
+- example/tokenization/gopay_tokenization_example.rb
+- example/tokenization/readme.md
 - lib/test/all.rb
 - lib/test/api_test.rb
 - lib/test/config_test.rb

data/Maintaining.MD

@@ -1,8 +0,0 @@
-> Warning: This note is for developer/maintainer of this package only
-
-## Updating Package
-
-- Make your changes
-- Update `version` value on `version.rb` file
-- To run all test `ruby -Itest all.rb`
-- To run specific test `ruby snap_test.rb`