komoju 0.0.7 → 0.0.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 8cfa7016aea050e4612e7c24e96854405b2f2237
-  data.tar.gz: b1c92adb38691718e43b2ab958398f45c6b4b7f7
+SHA256:
+  metadata.gz: 259d2079aab7d8c0a95d2a1e19b3e30ee15f304463afa9088879a70ab1589b66
+  data.tar.gz: dc72042ac25b1d6e8fde06767d341d27931aa6677938c183bbf0122bfe0d1d9c
 SHA512:
-  metadata.gz: 49955905870bbb6ba5d1ecf8e3371040da2f2915bacec70bc26f87fc86d717cdc3681744c06ccb8a74200f7b2eba6cc6ef31a7e5300835eafb9c90b6c0f19219
-  data.tar.gz: 0f51662cdfaba2722219cea8a75c68ff7491a006d4b276a13f61680d4f15237a54516c45a4e306c2cb2081737f78edea410cec0ac7a3380e14d7188ebd1726e6
+  metadata.gz: 4fcff7a529050e3b2463f52a0302fdbf4799b4ed9cbd576c8456e1d53ebaf956d39a72aceffa60f8e96b069630dde82576ba63c8b8dcdafed3bc4683526977d0
+  data.tar.gz: 13680056e9f5b972f42c390d8a72537dab6bb12f5b4c224c248b9bde9586f432bd2acfb5ca6082268462dca6434b81e5780d75f57697176d5d52aa0fb76db123

data/.gitignore

@@ -1,2 +1,3 @@
 .bundle
 .yardoc
+Gemfile.lock

data/README.md

@@ -21,7 +21,7 @@ Or install it yourself as:
 ## Usage
 
 ```ruby
-client = Komoju.connect("api-secret-key", url: "https://sandbox.komoju.com/api/v1")
+client = Komoju.connect("api-secret-key")
 client.payments.show("55404024b7b0dd6ec490158925")
 
 payment_details = {

data/komoju.gemspec

@@ -18,7 +18,7 @@ Gem::Specification.new do |spec|
   spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
   spec.require_paths = ["lib"]
 
-  spec.add_dependency 'heroics', '0.0.21'
+  spec.add_dependency 'heroics'
   spec.add_dependency 'moneta'
 
   spec.add_development_dependency "bundler", "~> 1.7"

data/lib/komoju/client.rb

@@ -9,6 +9,7 @@
 
 require 'heroics'
 require 'uri'
+require 'moneta'
 
 module Komoju
   # Get a Client configured to use HTTP Basic or header-based authentication.
@@ -111,13 +112,6 @@ module Komoju
       @payments_resource ||= Payments.new(@client)
     end
 
-    # Payout Resource
-    #
-    # @return [Payouts]
-    def payouts
-      @payouts_resource ||= Payouts.new(@client)
-    end
-
     # Subscription Resource
     #
     # @return [Subscriptions]
@@ -132,27 +126,6 @@ module Komoju
       @customers_resource ||= Customers.new(@client)
     end
 
-    # Subscription Invoice
-    #
-    # @return [Invoices]
-    def invoices
-      @invoices_resource ||= Invoices.new(@client)
-    end
-
-    # Subscription Invoice Items
-    #
-    # @return [InvoiceItems]
-    def invoice_items
-      @invoice_items_resource ||= InvoiceItems.new(@client)
-    end
-
-    # Subscription Plans
-    #
-    # @return [Plans]
-    def plans
-      @plans_resource ||= Plans.new(@client)
-    end
-
     # Token resource
     #
     # @return [Tokens]
@@ -240,34 +213,6 @@ module Komoju
     end
   end
 
-  # Payout Resource
-  class Payouts
-    def initialize(client)
-      @client = client
-    end
-
-    # List payouts
-    #
-    # @param body: the object to pass as the request payload
-    def list(body = {})
-      @client.payouts.list(body)
-    end
-
-    # Show a payout
-    #
-    # @param payouts_id: A unique identifier for a payout.
-    def show(payouts_id)
-      @client.payouts.show(payouts_id)
-    end
-
-    # List payout items
-    #
-    # @param payouts_id: A unique identifier for a payout.
-    def payout_items(payouts_id)
-      @client.payouts.payout_items(payouts_id)
-    end
-  end
-
   # Subscription Resource
   class Subscriptions
     def initialize(client)
@@ -298,9 +243,8 @@ module Komoju
     # Destroy a subscription
     #
     # @param subscriptions_id: A unique identifier for a subscription.
-    # @param body: the object to pass as the request payload
-    def destroy(subscriptions_id, body = {})
-      @client.subscriptions.destroy(subscriptions_id, body)
+    def destroy(subscriptions_id)
+      @client.subscriptions.destroy(subscriptions_id)
     end
   end
 
@@ -347,126 +291,6 @@ module Komoju
     end
   end
 
-  # Subscription Invoice
-  class Invoices
-    def initialize(client)
-      @client = client
-    end
-
-    # List invoices
-    #
-    # @param body: the object to pass as the request payload
-    def list(body = {})
-      @client.invoices.list(body)
-    end
-
-    # Show an invoice
-    #
-    # @param invoices_id: A unique identifier for the invoice.
-    def show(invoices_id)
-      @client.invoices.show(invoices_id)
-    end
-
-    # Cancel an invoice
-    #
-    # @param invoices_id: A unique identifier for the invoice.
-    def cancel(invoices_id)
-      @client.invoices.cancel(invoices_id)
-    end
-
-    # Create an invoice
-    #
-    # @param body: the object to pass as the request payload
-    def create(body = {})
-      @client.invoices.create(body)
-    end
-
-    # Preview an upcoming invoice
-    #
-    # @param body: the object to pass as the request payload
-    def preview(body = {})
-      @client.invoices.preview(body)
-    end
-
-    # Pay an invoice
-    #
-    # @param invoices_id: A unique identifier for the invoice.
-    # @param body: the object to pass as the request payload
-    def pay(invoices_id, body = {})
-      @client.invoices.pay(invoices_id, body)
-    end
-  end
-
-  # Subscription Invoice Items
-  class InvoiceItems
-    def initialize(client)
-      @client = client
-    end
-
-    # List invoice items
-    #
-    # @param body: the object to pass as the request payload
-    def list(body = {})
-      @client.invoice_items.list(body)
-    end
-
-    # Show an invoice item
-    #
-    # @param invoice_items_id: A unique identifier for the invoice items.
-    def show(invoice_items_id)
-      @client.invoice_items.show(invoice_items_id)
-    end
-
-    # Create an invoice item
-    #
-    # @param body: the object to pass as the request payload
-    def create(body = {})
-      @client.invoice_items.create(body)
-    end
-
-    # Deletes an invoice item from the upcoming invoice.
-    #
-    # @param invoice_items_id: A unique identifier for the invoice items.
-    def destroy(invoice_items_id)
-      @client.invoice_items.destroy(invoice_items_id)
-    end
-  end
-
-  # Subscription Plans
-  class Plans
-    def initialize(client)
-      @client = client
-    end
-
-    # List plans
-    #
-    # @param body: the object to pass as the request payload
-    def list(body = {})
-      @client.plans.list(body)
-    end
-
-    # Show a plan
-    #
-    # @param plans_name: Name of the plan.
-    def show(plans_name)
-      @client.plans.show(plans_name)
-    end
-
-    # Create a plan
-    #
-    # @param body: the object to pass as the request payload
-    def create(body = {})
-      @client.plans.create(body)
-    end
-
-    # Destroy a plan
-    #
-    # @param plans_name: Name of the plan.
-    def destroy(plans_name)
-      @client.plans.destroy(plans_name)
-    end
-  end
-
   # Token resource
   class Tokens
     def initialize(client)
@@ -503,17 +327,59 @@ module Komoju
           "format": "date-time"
         },
         "per_page": {
-          "type": [
-            "number"
-          ]
+          "$ref": "#/definitions/per_page"
         },
         "page": {
+          "$ref": "#/definitions/page"
+        }
+      }
+    },
+    "payment_list_filter": {
+      "type": [
+        "object"
+      ],
+      "properties": {
+        "start_time": {
           "type": [
-            "number"
-          ]
+            "string"
+          ],
+          "format": "date-time"
+        },
+        "end_time": {
+          "type": [
+            "string"
+          ],
+          "format": "date-time"
+        },
+        "per_page": {
+          "$ref": "#/definitions/per_page"
+        },
+        "page": {
+          "$ref": "#/definitions/page"
+        },
+        "currency": {
+          "$ref": "#/definitions/payments/definitions/currency"
+        },
+        "external_order_num": {
+          "$ref": "#/definitions/payments/definitions/external_order_num"
+        },
+        "status": {
+          "$ref": "#/definitions/payments/definitions/status"
         }
       }
     },
+    "page": {
+      "type": [
+        "number"
+      ],
+      "minimum": 1
+    },
+    "per_page": {
+      "type": [
+        "number"
+      ],
+      "minimum": 1
+    },
     "list": {
       "type": [
         "object"
@@ -530,14 +396,10 @@ module Komoju
           ]
         },
         "page": {
-          "type": [
-            "integer"
-          ]
+          "$ref": "#/definitions/page"
         },
         "per_page": {
-          "type": [
-            "integer"
-          ]
+          "$ref": "#/definitions/per_page"
         },
         "last_page": {
           "type": [
@@ -545,7 +407,7 @@ module Komoju
           ]
         },
         "data": {
-          "oneOf": [
+          "anyOf": [
             {
               "type": [
                 "array"
@@ -554,22 +416,6 @@ module Komoju
                 "$ref": "#/definitions/payments"
               }
             },
-            {
-              "type": [
-                "array"
-              ],
-              "items": {
-                "$ref": "#/definitions/payouts"
-              }
-            },
-            {
-              "type": [
-                "array"
-              ],
-              "items": {
-                "$ref": "#/definitions/payouts/definitions/payout_item"
-              }
-            },
             {
               "type": [
                 "array"
@@ -593,38 +439,6 @@ module Komoju
               "items": {
                 "$ref": "#/definitions/customers"
               }
-            },
-            {
-              "type": [
-                "array"
-              ],
-              "items": {
-                "$ref": "#/definitions/plans"
-              }
-            },
-            {
-              "type": [
-                "array"
-              ],
-              "items": {
-                "$ref": "#/definitions/subscriptions"
-              }
-            },
-            {
-              "type": [
-                "array"
-              ],
-              "items": {
-                "$ref": "#/definitions/invoices"
-              }
-            },
-            {
-              "type": [
-                "array"
-              ],
-              "items": {
-                "$ref": "#/definitions/invoice_items"
-              }
             }
           ]
         }
@@ -731,33 +545,47 @@ module Komoju
             "boolean"
           ],
           "default": true,
-          "description": "If true, the payment will be immediately captured. This option is ignored if a payment type is not credit_card"
+          "description": "If false, the payment will be authorized but not be captured. This option is ignored if a payment type is not credit_card"
         },
-        "given_name": {
+        "nonempty_string": {
           "type": [
             "string"
-          ]
+          ],
+          "minLength": 1
+        },
+        "given_name": {
+          "$ref": "#/definitions/payments/definitions/nonempty_string"
         },
         "family_name": {
-          "type": [
-            "string"
-          ]
+          "$ref": "#/definitions/payments/definitions/nonempty_string"
         },
         "given_name_kana": {
+          "$ref": "#/definitions/payments/definitions/nonempty_string"
+        },
+        "family_name_kana": {
+          "$ref": "#/definitions/payments/definitions/nonempty_string"
+        },
+        "name": {
+          "$ref": "#/definitions/payments/definitions/nonempty_string"
+        },
+        "email": {
           "type": [
             "string"
-          ]
+          ],
+          "format": "email",
+          "maxLength": 255
         },
-        "family_name_kana": {
+        "return_url": {
           "type": [
             "string"
-          ]
+          ],
+          "format": "uri"
         },
-        "email": {
+        "cancel_url": {
           "type": [
             "string"
           ],
-          "format": "email"
+          "format": "uri"
         },
         "locale": {
           "enum": [
@@ -765,7 +593,8 @@ module Komoju
             "ja",
             "ko"
           ],
-          "default": "ja"
+          "default": "ja",
+          "description": "Sets language of instruction page for supported payment methods. Valid options are 'en', 'ja', and 'ko'."
         },
         "partner_origin": {
           "type": [
@@ -802,7 +631,9 @@ module Komoju
         "external_order_num": {
           "type": [
             "string"
-          ]
+          ],
+          "maxLength": 255,
+          "description": "A unique ID from your application used to track this payment."
         },
         "bank_transfer_request": {
           "type": [
@@ -833,7 +664,13 @@ module Komoju
               "$ref": "#/definitions/payments/definitions/family_name_kana"
             },
             "expiry_days": {
-              "$ref": "#/definitions/payments/definitions/expiry_days"
+              "type": [
+                "integer"
+              ],
+              "minimum": 14,
+              "maximum": 59,
+              "exclusiveMinimum": false,
+              "exclusiveMaximum": false
             }
           },
           "required": [
@@ -914,10 +751,9 @@ module Komoju
                 "seven-eleven",
                 "lawson",
                 "family-mart",
-                "sunkus",
-                "circle-k",
                 "ministop",
-                "daily-yamazaki"
+                "daily-yamazaki",
+                "seicomart"
               ]
             },
             "email": {
@@ -951,10 +787,9 @@ module Komoju
                 "seven-eleven",
                 "lawson",
                 "family-mart",
-                "sunkus",
-                "circle-k",
                 "ministop",
-                "daily-yamazaki"
+                "daily-yamazaki",
+                "seicomart"
               ]
             },
             "instructions_url": {
@@ -1072,6 +907,9 @@ module Komoju
                 "web_money"
               ]
             },
+            "email": {
+              "$ref": "#/definitions/payments/definitions/email"
+            },
             "prepaid_number": {
               "type": [
                 "string"
@@ -1133,21 +971,25 @@ module Komoju
           },
           "additionalProperties": false
         },
-        "bit_cash_request": {
+        "steam_prepaid_card_request": {
           "type": [
             "object"
           ],
           "properties": {
             "type": {
               "enum": [
-                "bit_cash"
+                "steam_prepaid_card"
               ]
             },
+            "email": {
+              "$ref": "#/definitions/payments/definitions/email"
+            },
             "prepaid_number": {
               "type": [
                 "string"
               ],
-              "maxLength": 16
+              "maxLength": 16,
+              "minLength": 16
             }
           },
           "required": [
@@ -1155,39 +997,116 @@ module Komoju
             "prepaid_number"
           ]
         },
-        "bit_cash_response": {
-          "type": [
-            "object"
-          ],
-          "properties": {
-            "type": {
-              "enum": [
-                "bit_cash"
-              ]
-            }
-          },
-          "required": [
-            "type"
-          ]
-        },
-        "nanaco_request": {
+        "steam_prepaid_card_response": {
           "type": [
             "object"
           ],
           "properties": {
             "type": {
               "enum": [
-                "nanaco"
+                "steam_prepaid_card"
               ]
             },
-            "prepaid_number": {
+            "email": {
               "type": [
-                "string"
+                "string",
+                "null"
               ],
-              "maxLength": 16,
-              "minLength": 16
-            }
-          },
+              "format": "email"
+            },
+            "short_amount": {
+              "type": [
+                "integer"
+              ]
+            },
+            "prepaid_cards": {
+              "type": [
+                "array"
+              ],
+              "items": {
+                "type": [
+                  "object"
+                ],
+                "properties": {
+                  "last_four_digits": {
+                    "type": [
+                      "string"
+                    ]
+                  },
+                  "points": {
+                    "type": [
+                      "number"
+                    ]
+                  }
+                },
+                "additionalProperties": false
+              }
+            }
+          },
+          "additionalProperties": false
+        },
+        "bit_cash_request": {
+          "type": [
+            "object"
+          ],
+          "properties": {
+            "type": {
+              "enum": [
+                "bit_cash"
+              ]
+            },
+            "email": {
+              "$ref": "#/definitions/payments/definitions/email"
+            },
+            "prepaid_number": {
+              "type": [
+                "string"
+              ],
+              "maxLength": 16,
+              "minLength": 16
+            }
+          },
+          "required": [
+            "type",
+            "prepaid_number"
+          ]
+        },
+        "bit_cash_response": {
+          "type": [
+            "object"
+          ],
+          "properties": {
+            "type": {
+              "enum": [
+                "bit_cash"
+              ]
+            }
+          },
+          "required": [
+            "type"
+          ]
+        },
+        "nanaco_request": {
+          "type": [
+            "object"
+          ],
+          "properties": {
+            "type": {
+              "enum": [
+                "nanaco"
+              ]
+            },
+            "email": {
+              "$ref": "#/definitions/payments/definitions/email"
+            },
+            "prepaid_number": {
+              "type": [
+                "string"
+              ],
+              "maxLength": 16,
+              "minLength": 16
+            }
+          },
           "required": [
             "type",
             "prepaid_number"
@@ -1251,11 +1170,14 @@ module Komoju
                 "net_cash"
               ]
             },
+            "email": {
+              "$ref": "#/definitions/payments/definitions/email"
+            },
             "prepaid_number": {
               "type": [
                 "string"
               ],
-              "maxLength": 16,
+              "maxLength": 20,
               "minLength": 16
             }
           },
@@ -1326,13 +1248,15 @@ module Komoju
               "type": [
                 "string"
               ],
-              "maxLength": 12
+              "maxLength": 12,
+              "minLength": 1
             },
             "culture_password": {
               "type": [
                 "string"
               ],
-              "maxLength": 12
+              "maxLength": 12,
+              "minLength": 1
             }
           },
           "required": [
@@ -1356,43 +1280,45 @@ module Komoju
             "type"
           ]
         },
-        "dospara_request": {
+        "happy_money_request": {
           "type": [
             "object"
           ],
           "properties": {
             "type": {
               "enum": [
-                "dospara"
+                "happy_money"
               ]
             },
-            "user_no": {
+            "happy_money_id": {
               "type": [
                 "string"
               ],
-              "maxLength": 20
+              "maxLength": 20,
+              "minLength": 1
             },
-            "user_password": {
+            "happy_money_password": {
               "type": [
                 "string"
               ],
-              "maxLength": 20
+              "maxLength": 50,
+              "minLength": 1
             }
           },
           "required": [
             "type",
-            "user_no",
-            "user_password"
+            "happy_money_id",
+            "happy_money_password"
           ]
         },
-        "dospara_response": {
+        "happy_money_response": {
           "type": [
             "object"
           ],
           "properties": {
             "type": {
               "enum": [
-                "dospara"
+                "happy_money"
               ]
             }
           },
@@ -1400,120 +1326,351 @@ module Komoju
             "type"
           ]
         },
-        "credit_card_request": {
+        "mobile_request": {
           "type": [
             "object"
           ],
           "properties": {
             "type": {
               "enum": [
-                "credit_card"
+                "mobile"
               ]
             },
-            "number": {
+            "email": {
+              "$ref": "#/definitions/payments/definitions/email"
+            }
+          },
+          "required": [
+            "type",
+            "email"
+          ]
+        },
+        "mobile_response": {
+          "type": [
+            "object"
+          ],
+          "properties": {
+            "type": {
+              "enum": [
+                "mobile"
+              ]
+            },
+            "redirect_url": {
               "type": [
                 "string"
+              ],
+              "format": "uri"
+            }
+          },
+          "required": [
+            "type",
+            "redirect_url"
+          ]
+        },
+        "toss_request": {
+          "type": [
+            "object"
+          ],
+          "properties": {
+            "type": {
+              "enum": [
+                "toss"
               ]
             },
-            "month": {
-              "type": [
-                "integer"
+            "email": {
+              "$ref": "#/definitions/payments/definitions/email"
+            }
+          },
+          "required": [
+            "type",
+            "email"
+          ]
+        },
+        "toss_response": {
+          "type": [
+            "object"
+          ],
+          "properties": {
+            "type": {
+              "enum": [
+                "toss"
               ]
             },
-            "year": {
+            "redirect_url": {
               "type": [
-                "integer"
+                "string"
+              ],
+              "format": "uri"
+            }
+          },
+          "required": [
+            "type",
+            "redirect_url"
+          ]
+        },
+        "zgold_request": {
+          "type": [
+            "object"
+          ],
+          "properties": {
+            "type": {
+              "enum": [
+                "zgold"
               ]
             },
-            "verification_value": {
+            "item_title": {
               "type": [
                 "string"
               ]
             },
-            "given_name": {
-              "$ref": "#/definitions/payments/definitions/given_name"
-            },
-            "family_name": {
-              "$ref": "#/definitions/payments/definitions/family_name"
-            },
-            "last_four_digits": {
+            "item_description": {
               "type": [
                 "string"
               ]
             },
-            "brand": {
-              "enum": [
-                "visa",
-                "american_express",
-                "master",
-                "jcb",
-                "diners_club"
-              ]
+            "image_url": {
+              "type": [
+                "string"
+              ],
+              "format": "uri"
             }
           },
           "required": [
-            "type",
-            "number",
-            "month",
-            "year",
-            "given_name",
-            "family_name"
+            "type"
           ]
         },
-        "credit_card_response": {
+        "zgold_response": {
           "type": [
             "object"
           ],
           "properties": {
             "type": {
               "enum": [
-                "credit_card"
+                "zgold"
               ]
             },
-            "month": {
+            "redirect_url": {
               "type": [
-                "integer"
+                "string"
+              ],
+              "format": "uri"
+            }
+          },
+          "required": [
+            "type",
+            "redirect_url"
+          ]
+        },
+        "dospara_request": {
+          "type": [
+            "object"
+          ],
+          "properties": {
+            "type": {
+              "enum": [
+                "dospara"
               ]
             },
-            "year": {
+            "user_no": {
               "type": [
-                "integer"
-              ]
+                "string"
+              ],
+              "maxLength": 20
             },
-            "last_four_digits": {
+            "user_password": {
               "type": [
                 "string"
-              ]
-            },
-            "brand": {
-              "enum": [
-                "visa",
-                "american_express",
-                "master",
-                "jcb"
-              ]
-            },
-            "expiry_days": {
-              "$ref": "#/definitions/payments/definitions/expiry_days"
+              ],
+              "maxLength": 20
             }
           },
           "required": [
             "type",
-            "brand",
-            "last_four_digits",
-            "month",
-            "year"
+            "user_no",
+            "user_password"
           ]
         },
-        "id": {
-          "example": "94f128d4021b049bc616f5b1b0",
-          "readOnly": true,
+        "dospara_response": {
           "type": [
-            "string"
+            "object"
           ],
-          "description": "A unique indentifier for the payment"
-        },
-        "resource": {
+          "properties": {
+            "type": {
+              "enum": [
+                "dospara"
+              ]
+            }
+          },
+          "required": [
+            "type"
+          ]
+        },
+        "cvs_request": {
+          "type": [
+            "object"
+          ],
+          "properties": {
+            "type": {
+              "enum": [
+                "cvs"
+              ]
+            },
+            "email": {
+              "$ref": "#/definitions/payments/definitions/email"
+            }
+          },
+          "required": [
+            "type",
+            "email"
+          ]
+        },
+        "cvs_korea_response": {
+          "type": [
+            "object"
+          ],
+          "properties": {
+            "type": {
+              "enum": [
+                "cvs"
+              ]
+            }
+          },
+          "required": [
+            "type",
+            "email"
+          ]
+        },
+        "credit_card_request": {
+          "type": [
+            "object"
+          ],
+          "properties": {
+            "type": {
+              "enum": [
+                "credit_card"
+              ]
+            },
+            "email": {
+              "$ref": "#/definitions/payments/definitions/email"
+            },
+            "number": {
+              "type": [
+                "string"
+              ],
+              "maxLength": 19
+            },
+            "month": {
+              "type": [
+                "integer"
+              ],
+              "maximum": 12,
+              "minimum": 1
+            },
+            "year": {
+              "type": [
+                "integer"
+              ],
+              "maximum": 2100,
+              "minimum": 1
+            },
+            "verification_value": {
+              "type": [
+                "string"
+              ]
+            },
+            "given_name": {
+              "$ref": "#/definitions/payments/definitions/given_name"
+            },
+            "family_name": {
+              "$ref": "#/definitions/payments/definitions/family_name"
+            },
+            "name": {
+              "$ref": "#/definitions/payments/definitions/family_name"
+            },
+            "three_d_secure": {
+              "type": [
+                "boolean"
+              ],
+              "default": false
+            },
+            "expiry_days": {
+              "$ref": "#/definitions/payments/definitions/expiry_days"
+            }
+          },
+          "required": [
+            "type",
+            "number",
+            "month",
+            "year"
+          ],
+          "anyOf": [
+            {
+              "required": [
+                "given_name",
+                "family_name"
+              ]
+            },
+            {
+              "required": [
+                "name"
+              ]
+            }
+          ]
+        },
+        "credit_card_response": {
+          "type": [
+            "object"
+          ],
+          "properties": {
+            "type": {
+              "enum": [
+                "credit_card"
+              ]
+            },
+            "month": {
+              "type": [
+                "integer"
+              ]
+            },
+            "year": {
+              "type": [
+                "integer"
+              ]
+            },
+            "last_four_digits": {
+              "type": [
+                "string"
+              ]
+            },
+            "brand": {
+              "enum": [
+                "visa",
+                "american_express",
+                "master",
+                "jcb"
+              ]
+            },
+            "expiry_days": {
+              "$ref": "#/definitions/payments/definitions/expiry_days"
+            }
+          },
+          "required": [
+            "type",
+            "brand",
+            "last_four_digits",
+            "month",
+            "year"
+          ]
+        },
+        "id": {
+          "example": "94f128d4021b049bc616f5b1b0",
+          "readOnly": true,
+          "type": [
+            "string"
+          ],
+          "description": "A unique indentifier for the payment"
+        },
+        "resource": {
           "example": "payment",
           "enum": [
             "payment"
@@ -1534,6 +1691,7 @@ module Komoju
         },
         "amount": {
           "example": "300",
+          "maximum": 9999999,
           "minimum": 0,
           "type": [
             "number"
@@ -1544,6 +1702,7 @@ module Komoju
           "example": "30",
           "type": [
             "number",
+            "string",
             "null"
           ],
           "description": "The amount of tax to be charged, or ‘auto’ to use the current consumption tax rate in Japan. Use a ‘.’ as a decimal separator, and no thousands separator. If the tax is more precise than the currency allows, it will be rounded using a round half up algorithm."
@@ -1589,7 +1748,7 @@ module Komoju
             "string",
             "null"
           ],
-          "description": "Description of the payment (used in e-mail receipts if enabled)."
+          "description": "Plaintext description for annotating a resource."
         },
         "subscription": {
           "example": null,
@@ -1643,8 +1802,17 @@ module Komoju
                 "nanaco",
                 "net_cash",
                 "culture_voucher",
-                "dospara"
+                "dospara",
+                "mobile",
+                "zgold",
+                "cvs",
+                "steam_prepaid_card",
+                "happy_money",
+                "toss"
               ]
+            },
+            "email": {
+              "$ref": "#/definitions/payments/definitions/email"
             }
           },
           "required": [
@@ -1682,6 +1850,9 @@ module Komoju
             {
               "$ref": "#/definitions/payments/definitions/web_money_response"
             },
+            {
+              "$ref": "#/definitions/payments/definitions/steam_prepaid_card_response"
+            },
             {
               "$ref": "#/definitions/payments/definitions/bit_cash_response"
             },
@@ -1691,8 +1862,23 @@ module Komoju
             {
               "$ref": "#/definitions/payments/definitions/culture_voucher_response"
             },
+            {
+              "$ref": "#/definitions/payments/definitions/mobile_response"
+            },
+            {
+              "$ref": "#/definitions/payments/definitions/toss_response"
+            },
+            {
+              "$ref": "#/definitions/payments/definitions/zgold_response"
+            },
             {
               "$ref": "#/definitions/payments/definitions/net_cash_response"
+            },
+            {
+              "$ref": "#/definitions/payments/definitions/cvs_korea_response"
+            },
+            {
+              "$ref": "#/definitions/payments/definitions/happy_money_response"
             }
           ]
         },
@@ -1771,7 +1957,7 @@ module Komoju
             "$ref": "#/definitions/list/"
           },
           "schema": {
-            "$ref": "#/definitions/list_filter/"
+            "$ref": "#/definitions/payment_list_filter/"
           }
         },
         {
@@ -1806,6 +1992,9 @@ module Komoju
               "capture": {
                 "$ref": "#/definitions/payments/definitions/capture"
               },
+              "description": {
+                "$ref": "#/definitions/payments/definitions/description"
+              },
               "tax": {
                 "$ref": "#/definitions/payments/definitions/tax"
               },
@@ -1815,6 +2004,12 @@ module Komoju
               "external_order_num": {
                 "$ref": "#/definitions/payments/definitions/external_order_num"
               },
+              "return_url": {
+                "$ref": "#/definitions/payments/definitions/return_url"
+              },
+              "cancel_url": {
+                "$ref": "#/definitions/payments/definitions/cancel_url"
+              },
               "locale": {
                 "$ref": "#/definitions/payments/definitions/locale"
               },
@@ -1864,6 +2059,7 @@ module Komoju
               },
               "payment_details": {
                 "type": [
+                  "string",
                   "object"
                 ],
                 "properties": {
@@ -1871,7 +2067,8 @@ module Komoju
                     "enum": [
                       "web_money",
                       "net_cash",
-                      "nanaco"
+                      "nanaco",
+                      "steam_prepaid_card"
                     ]
                   }
                 },
@@ -1920,741 +2117,13 @@ module Komoju
         },
         {
           "title": "Cancel",
-          "description": "Cancel a payment",
-          "href": "/payments/{(%2Fdefinitions%2Fpayments%2Fdefinitions%2Fid)}/cancel",
-          "method": "POST",
-          "rel": "self",
-          "response_example": "payments#cancel",
-          "targetSchema": {
-            "$ref": "#/definitions/payments/"
-          }
-        }
-      ],
-      "properties": {
-        "id": {
-          "$ref": "#/definitions/payments/definitions/id"
-        },
-        "resource": {
-          "$ref": "#/definitions/payments/definitions/resource"
-        },
-        "status": {
-          "$ref": "#/definitions/payments/definitions/status"
-        },
-        "amount": {
-          "$ref": "#/definitions/payments/definitions/amount"
-        },
-        "tax": {
-          "$ref": "#/definitions/payments/definitions/tax"
-        },
-        "payment_deadline": {
-          "$ref": "#/definitions/payments/definitions/payment_deadline"
-        },
-        "payment_details": {
-          "$ref": "#/definitions/payments/definitions/payment_details_response"
-        },
-        "payment_method_fee": {
-          "$ref": "#/definitions/payments/definitions/payment_method_fee"
-        },
-        "total": {
-          "$ref": "#/definitions/payments/definitions/total"
-        },
-        "currency": {
-          "$ref": "#/definitions/payments/definitions/currency"
-        },
-        "description": {
-          "$ref": "#/definitions/payments/definitions/description"
-        },
-        "subscription": {
-          "$ref": "#/definitions/payments/definitions/subscription"
-        },
-        "captured_at": {
-          "$ref": "#/definitions/payments/definitions/captured_at"
-        },
-        "metadata": {
-          "$ref": "#/definitions/payments/definitions/metadata"
-        },
-        "created_at": {
-          "$ref": "#/definitions/payments/definitions/created_at"
-        },
-        "refunds": {
-          "type": [
-            "array"
-          ]
-        }
-      },
-      "description": "Payment resource",
-      "title": "Payments"
-    },
-    "payouts": {
-      "$schema": "http://json-schema.org/draft-04/hyper-schema",
-      "type": [
-        "object"
-      ],
-      "definitions": {
-        "id": {
-          "example": "66a4824ac97cc7afff608f27c7",
-          "readOnly": true,
-          "type": [
-            "string"
-          ],
-          "description": "A unique identifier for a payout."
-        },
-        "resource": {
-          "example": "event",
-          "readOnly": true,
-          "enum": [
-            "payout"
-          ],
-          "description": "Name of resource"
-        },
-        "payout_item": {
-          "readOnly": true,
-          "type": [
-            "object"
-          ],
-          "properties": {
-            "resource": {
-              "example": "payout_item",
-              "readOnly": true,
-              "enum": [
-                "payout_item"
-              ],
-              "description": "Name of resource."
-            },
-            "event_type": {
-              "example": "capture",
-              "readOnly": true,
-              "enum": [
-                "capture",
-                "refund"
-              ],
-              "description": "Describes whether the payout item is from a captured or refunded payment."
-            },
-            "timestamp": {
-              "example": "2015-03-06T06:52:35Z",
-              "readOnly": true,
-              "format": "date-time",
-              "description": "Timestamp describing when the payment was either captured or refunded."
-            },
-            "payment_method": {
-              "example": "visa",
-              "readOnly": true,
-              "enum": [
-                "visa",
-                "master_card",
-                "american_express",
-                "jcb",
-                "bank_transfer",
-                "web_money",
-                "lawson",
-                "family-mart",
-                "sunkus",
-                "circle-k",
-                "ministop",
-                "daily-yamazaki",
-                "seven-eleven"
-              ],
-              "description": "The payment method of the payment."
-            },
-            "payment_fee": {
-              "example": "300",
-              "type": [
-                "number"
-              ],
-              "description": "Komoju platform fee deducted from the payment total."
-            },
-            "receivable": {
-              "example": "300",
-              "type": [
-                "number"
-              ],
-              "description": "The amount paid to your account for a given payment."
-            },
-            "amount": {
-              "$ref": "#/definitions/payments/definitions/amount"
-            },
-            "tax": {
-              "$ref": "#/definitions/payments/definitions/tax"
-            },
-            "total": {
-              "$ref": "#/definitions/payments/definitions/total"
-            }
-          },
-          "description": "Payout Item Resource"
-        },
-        "created_at": {
-          "example": "2015-03-06T06:52:35Z",
-          "format": "date-time",
-          "readOnly": true,
-          "type": [
-            "string"
-          ],
-          "description": "An ISO 8601 formatted timestamp of when the payout was created."
-        }
-      },
-      "links": [
-        {
-          "title": "List",
-          "description": "List payouts",
-          "href": "/payouts",
-          "method": "GET",
-          "rel": "instances",
-          "response_example": "payouts#index",
-          "targetSchema": {
-            "$ref": "#/definitions/list/"
-          },
-          "schema": {
-            "$ref": "#/definitions/list_filter/"
-          }
-        },
-        {
-          "title": "Show",
-          "description": "Show a payout",
-          "href": "/payouts/{(%2Fdefinitions%2Fpayouts%2Fdefinitions%2Fid)}",
-          "method": "GET",
-          "rel": "self",
-          "response_example": "payouts#show",
-          "targetSchema": {
-            "$ref": "#/definitions/payouts/"
-          }
-        },
-        {
-          "title": "Payout Items",
-          "description": "List payout items",
-          "href": "/payouts/{(%2Fdefinitions%2Fpayouts%2Fdefinitions%2Fid)}/payout_items",
-          "method": "GET",
-          "rel": "instances",
-          "response_example": "payouts#payout_items",
-          "targetSchema": {
-            "$ref": "#/definitions/list/"
-          }
-        }
-      ],
-      "properties": {
-        "id": {
-          "$ref": "#/definitions/payouts/definitions/id"
-        },
-        "resource": {
-          "$ref": "#/definitions/payouts/definitions/resource"
-        },
-        "payout_items": {
-          "$ref": "#/definitions/list/"
-        },
-        "created_at": {
-          "$ref": "#/definitions/payouts/definitions/created_at"
-        }
-      },
-      "description": "Payout Resource",
-      "title": "Payouts"
-    },
-    "subscriptions": {
-      "$schema": "http://json-schema.org/draft-04/hyper-schema",
-      "type": [
-        "object"
-      ],
-      "definitions": {
-        "id": {
-          "example": "66a4824ac97cc7afff608f27c7",
-          "readOnly": true,
-          "type": [
-            "string"
-          ],
-          "description": "A unique identifier for a subscription."
-        },
-        "resource": {
-          "example": "subscription",
-          "readOnly": true,
-          "enum": [
-            "subscription"
-          ],
-          "description": "Name of resource"
-        },
-        "status": {
-          "example": "pending",
-          "readOnly": true,
-          "enum": [
-            "cancelled",
-            "pending",
-            "active",
-            "past_due"
-          ],
-          "description": "The status of the subscription."
-        },
-        "plan": {
-          "$ref": "#/definitions/plans"
-        },
-        "customer": {
-          "$ref": "#/definitions/customers"
-        },
-        "current_period_end_at": {
-          "example": null,
-          "format": "date-time",
-          "readOnly": true,
-          "type": [
-            "string",
-            "null"
-          ],
-          "description": "An ISO 8601 formatted timestamp of when the subscription will next be billed."
-        },
-        "cancel_later": {
-          "type": [
-            "boolean"
-          ],
-          "default": true,
-          "description": "Cancel the subscription at the end of the current billing period (default: true)"
-        },
-        "metadata": {
-          "$ref": "#/definitions/payments/definitions/metadata"
-        },
-        "created_at": {
-          "example": "2015-03-06T06:52:35Z",
-          "format": "date-time",
-          "readOnly": true,
-          "type": [
-            "string"
-          ],
-          "description": "An ISO 8601 formatted timestamp of when the plan was created."
-        }
-      },
-      "links": [
-        {
-          "title": "List",
-          "description": "List subscriptions",
-          "href": "/subscriptions",
-          "method": "GET",
-          "rel": "instances",
-          "response_example": "subscriptions#index",
-          "targetSchema": {
-            "$ref": "#/definitions/list/"
-          },
-          "schema": {
-            "$ref": "#/definitions/list_filter/"
-          }
-        },
-        {
-          "title": "Show",
-          "description": "Show a subscription",
-          "href": "/subscriptions/{(%2Fdefinitions%2Fsubscriptions%2Fdefinitions%2Fid)}",
-          "method": "GET",
-          "rel": "self",
-          "response_example": "subscriptions#show",
-          "targetSchema": {
-            "$ref": "#/definitions/subscriptions/"
-          }
-        },
-        {
-          "title": "Create",
-          "description": "Create a subscription",
-          "href": "/subscriptions",
-          "method": "POST",
-          "rel": "create",
-          "response_example": "subscriptions#create",
-          "targetSchema": {
-            "$ref": "#/definitions/subscriptions/"
-          },
-          "schema": {
-            "type": [
-              "object"
-            ],
-            "properties": {
-              "customer": {
-                "type": [
-                  "string"
-                ]
-              },
-              "plan": {
-                "type": [
-                  "string"
-                ]
-              },
-              "metadata": {
-                "$ref": "#/definitions/subscriptions/definitions/metadata"
-              }
-            },
-            "required": [
-              "customer",
-              "plan"
-            ]
-          }
-        },
-        {
-          "title": "Destroy",
-          "description": "Destroy a subscription",
-          "href": "/subscriptions/{(%2Fdefinitions%2Fsubscriptions%2Fdefinitions%2Fid)}",
-          "method": "DELETE",
-          "rel": "destroy",
-          "response_example": "subscriptions#destroy",
-          "targetSchema": {
-            "$ref": "#/definitions/subscriptions/"
-          },
-          "schema": {
-            "type": [
-              "object"
-            ],
-            "properties": {
-              "cancel_later": {
-                "$ref": "#/definitions/subscriptions/definitions/cancel_later"
-              }
-            }
-          }
-        }
-      ],
-      "properties": {
-        "id": {
-          "$ref": "#/definitions/subscriptions/definitions/id"
-        },
-        "resource": {
-          "$ref": "#/definitions/subscriptions/definitions/resource"
-        },
-        "status": {
-          "$ref": "#/definitions/subscriptions/definitions/status"
-        },
-        "plan": {
-          "$ref": "#/definitions/subscriptions/definitions/plan"
-        },
-        "customer": {
-          "$ref": "#/definitions/subscriptions/definitions/customer"
-        },
-        "cancel_later": {
-          "$ref": "#/definitions/subscriptions/definitions/cancel_later"
-        },
-        "metadata": {
-          "$ref": "#/definitions/subscriptions/definitions/metadata"
-        },
-        "created_at": {
-          "$ref": "#/definitions/subscriptions/definitions/created_at"
-        }
-      },
-      "description": "Subscription Resource",
-      "title": "Subscriptions"
-    },
-    "customers": {
-      "$schema": "http://json-schema.org/draft-04/hyper-schema",
-      "type": [
-        "object"
-      ],
-      "definitions": {
-        "id": {
-          "example": "fa799fca14be29d3fae455f22d",
-          "readOnly": true,
-          "type": [
-            "string"
-          ],
-          "description": "A unique identifier for the customer."
-        },
-        "resource": {
-          "example": "customer",
-          "readOnly": true,
-          "enum": [
-            "customer"
-          ],
-          "description": "Name of resource"
-        },
-        "payment_details": {
-          "$ref": "#/definitions/payments/definitions/payment_details_response"
-        },
-        "metadata": {
-          "$ref": "#/definitions/payments/definitions/metadata"
-        },
-        "email": {
-          "type": [
-            "string",
-            "null"
-          ],
-          "format": "email",
-          "description": "Customer's email address."
-        },
-        "created_at": {
-          "example": "2015-03-06T06:52:35Z",
-          "format": "date-time",
-          "readOnly": true,
-          "type": [
-            "string"
-          ],
-          "description": "An ISO 8601 formatted timestamp of when the customer was created."
-        }
-      },
-      "links": [
-        {
-          "title": "List",
-          "description": "List customers",
-          "href": "/customers",
-          "method": "GET",
-          "rel": "instances",
-          "response_example": "customers#index",
-          "targetSchema": {
-            "$ref": "#/definitions/list/"
-          },
-          "schema": {
-            "$ref": "#/definitions/list_filter/"
-          }
-        },
-        {
-          "title": "Show",
-          "description": "Show a customer",
-          "href": "/customers/{(%2Fdefinitions%2Fcustomers%2Fdefinitions%2Fid)}",
-          "method": "GET",
-          "rel": "self",
-          "response_example": "customers#show",
-          "targetSchema": {
-            "$ref": "#/definitions/customers/"
-          }
-        },
-        {
-          "title": "Create",
-          "description": "Create a customer",
-          "href": "/customers",
-          "method": "POST",
-          "rel": "create",
-          "response_example": "customers#create",
-          "targetSchema": {
-            "$ref": "#/definitions/customers/"
-          },
-          "schema": {
-            "type": [
-              "object"
-            ],
-            "properties": {
-              "payment_details": {
-                "$ref": "#/definitions/payments/definitions/payment_details_request"
-              },
-              "email": {
-                "$ref": "#/definitions/customers/definitions/email"
-              },
-              "metadata": {
-                "$ref": "#/definitions/customers/definitions/metadata"
-              }
-            },
-            "additionalFields": false
-          }
-        },
-        {
-          "title": "Update",
-          "description": "Update customers",
-          "href": "/customers/{(%2Fdefinitions%2Fcustomers%2Fdefinitions%2Fid)}",
-          "method": "PATCH",
-          "rel": "self",
-          "response_example": "customers#update",
-          "schema": {
-            "type": [
-              "object"
-            ],
-            "properties": {
-              "payment_details": {
-                "$ref": "#/definitions/payments/definitions/payment_details_request"
-              },
-              "email": {
-                "$ref": "#/definitions/customers/definitions/email"
-              },
-              "metadata": {
-                "$ref": "#/definitions/customers/definitions/metadata"
-              }
-            },
-            "additionalFields": false
-          },
-          "targetSchema": {
-            "$ref": "#/definitions/customers/"
-          }
-        },
-        {
-          "title": "Destroy",
-          "description": "Destroy a customer",
-          "href": "/customers/{(%2Fdefinitions%2Fcustomers%2Fdefinitions%2Fid)}",
-          "method": "DELETE",
-          "rel": "destroy",
-          "response_example": "customers#destroy",
-          "targetSchema": {
-            "$ref": "#/definitions/customers/"
-          }
-        }
-      ],
-      "properties": {
-        "id": {
-          "$ref": "#/definitions/customers/definitions/id"
-        },
-        "resource": {
-          "$ref": "#/definitions/customers/definitions/resource"
-        },
-        "email": {
-          "$ref": "#/definitions/customers/definitions/email"
-        },
-        "metadata": {
-          "$ref": "#/definitions/customers/definitions/metadata"
-        },
-        "created_at": {
-          "$ref": "#/definitions/customers/definitions/created_at"
-        }
-      },
-      "description": "Customers",
-      "title": "Customers"
-    },
-    "invoices": {
-      "$schema": "http://json-schema.org/draft-04/hyper-schema",
-      "type": [
-        "object"
-      ],
-      "definitions": {
-        "id": {
-          "readOnly": true,
-          "type": [
-            "string"
-          ],
-          "description": "A unique identifier for the invoice."
-        },
-        "resource": {
-          "example": "invoice",
-          "readOnly": true,
-          "enum": [
-            "invoice"
-          ],
-          "description": "Name of resource."
-        },
-        "invoice": {
-          "readOnly": true,
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "renewal": {
-          "type": [
-            "boolean"
-          ],
-          "default": true,
-          "description": "Include the upcoming renewal charge (default: true)"
-        },
-        "paid": {
-          "readOnly": true,
-          "type": [
-            "boolean"
-          ]
-        },
-        "created_at": {
-          "readOnly": true,
-          "format": "date-time",
-          "type": [
-            "string",
-            "null"
-          ],
-          "description": "An ISO 8601 formatted timestamp of when the invoice was created."
-        }
-      },
-      "links": [
-        {
-          "title": "List",
-          "description": "List invoices",
-          "href": "/invoices",
-          "method": "GET",
-          "rel": "instances",
-          "response_example": "invoices#index",
-          "targetSchema": {
-            "$ref": "#/definitions/list/"
-          },
-          "schema": {
-            "$ref": "#/definitions/list_filter/"
-          }
-        },
-        {
-          "title": "Show",
-          "description": "Show an invoice",
-          "href": "/invoices/{(%2Fdefinitions%2Finvoices%2Fdefinitions%2Fid)}",
-          "method": "GET",
-          "rel": "self",
-          "response_example": "invoices#show",
-          "targetSchema": {
-            "$ref": "#/definitions/invoices/"
-          }
-        },
-        {
-          "title": "Cancel",
-          "description": "Cancel an invoice",
-          "href": "/invoices/{(%2Fdefinitions%2Finvoices%2Fdefinitions%2Fid)}/cancel",
-          "method": "POST",
-          "rel": "self",
-          "response_example": "invoices#cancel",
-          "targetSchema": {
-            "$ref": "#/definitions/invoices/"
-          }
-        },
-        {
-          "title": "Create",
-          "description": "Create an invoice",
-          "href": "/invoices",
-          "method": "POST",
-          "rel": "create",
-          "response_example": "invoices#create",
-          "targetSchema": {
-            "$ref": "#/definitions/invoices/"
-          },
-          "schema": {
-            "type": [
-              "object"
-            ],
-            "properties": {
-              "subscription": {
-                "$ref": "#/definitions/subscriptions/definitions/id"
-              },
-              "metadata": {
-                "$ref": "#/definitions/subscriptions/definitions/metadata"
-              }
-            },
-            "required": [
-              "subscription"
-            ]
-          }
-        },
-        {
-          "title": "Preview",
-          "description": "Preview an upcoming invoice",
-          "href": "/invoices/preview",
-          "method": "GET",
-          "rel": "self",
-          "response_example": "invoices#preview",
-          "targetSchema": {
-            "$ref": "#/definitions/invoices/"
-          },
-          "schema": {
-            "type": [
-              "object"
-            ],
-            "properties": {
-              "subscription": {
-                "$ref": "#/definitions/subscriptions/definitions/id"
-              },
-              "renewal": {
-                "$ref": "#/definitions/invoices/definitions/renewal"
-              }
-            },
-            "required": [
-              "subscription"
-            ]
-          }
-        },
-        {
-          "title": "Pay",
-          "description": "Pay an invoice",
-          "href": "/invoices/{(%2Fdefinitions%2Finvoices%2Fdefinitions%2Fid)}/pay",
-          "method": "POST",
-          "rel": "self",
-          "response_example": "invoices#pay",
-          "targetSchema": {
-            "$ref": "#/definitions/invoices/"
-          },
-          "schema": {
-            "type": [
-              "object"
-            ],
-            "properties": {
-              "payment_details": {
-                "$ref": "#/definitions/payments/definitions/payment_details_request"
-              },
-              "fraud_details": {
-                "$ref": "#/definitions/payments/definitions/fraud_details"
-              }
-            },
-            "required": [
-              "payment_details"
-            ]
+          "description": "Cancel a payment",
+          "href": "/payments/{(%2Fdefinitions%2Fpayments%2Fdefinitions%2Fid)}/cancel",
+          "method": "POST",
+          "rel": "self",
+          "response_example": "payments#cancel",
+          "targetSchema": {
+            "$ref": "#/definitions/payments/"
           }
         }
       ],
@@ -2663,19 +2132,31 @@ module Komoju
           "$ref": "#/definitions/payments/definitions/id"
         },
         "resource": {
-          "$ref": "#/definitions/invoices/definitions/resource"
+          "$ref": "#/definitions/payments/definitions/resource"
         },
-        "subscription": {
-          "$ref": "#/definitions/subscriptions"
+        "status": {
+          "$ref": "#/definitions/payments/definitions/status"
+        },
+        "amount": {
+          "$ref": "#/definitions/payments/definitions/amount"
+        },
+        "return_url": {
+          "$ref": "#/definitions/payments/definitions/return_url"
+        },
+        "cancel_url": {
+          "$ref": "#/definitions/payments/definitions/cancel_url"
         },
-        "renewal": {
-          "$ref": "#/definitions/invoices/definitions/renewal"
+        "tax": {
+          "$ref": "#/definitions/payments/definitions/tax"
+        },
+        "payment_deadline": {
+          "$ref": "#/definitions/payments/definitions/payment_deadline"
         },
-        "paid": {
-          "$ref": "#/definitions/invoices/definitions/paid"
+        "payment_details": {
+          "$ref": "#/definitions/payments/definitions/payment_details_response"
         },
-        "invoice_items": {
-          "$ref": "#/definitions/list/"
+        "payment_method_fee": {
+          "$ref": "#/definitions/payments/definitions/payment_method_fee"
         },
         "total": {
           "$ref": "#/definitions/payments/definitions/total"
@@ -2683,251 +2164,185 @@ module Komoju
         "currency": {
           "$ref": "#/definitions/payments/definitions/currency"
         },
+        "description": {
+          "$ref": "#/definitions/payments/definitions/description"
+        },
+        "subscription": {
+          "$ref": "#/definitions/payments/definitions/subscription"
+        },
+        "captured_at": {
+          "$ref": "#/definitions/payments/definitions/captured_at"
+        },
+        "metadata": {
+          "$ref": "#/definitions/payments/definitions/metadata"
+        },
         "created_at": {
-          "$ref": "#/definitions/invoices/definitions/created_at"
+          "$ref": "#/definitions/payments/definitions/created_at"
+        },
+        "refunds": {
+          "type": [
+            "array"
+          ]
         }
       },
-      "description": "Subscription Invoice",
-      "title": "Invoices"
+      "description": "Payment resource",
+      "title": "Payments"
     },
-    "invoice_items": {
+    "subscriptions": {
       "$schema": "http://json-schema.org/draft-04/hyper-schema",
       "type": [
         "object"
       ],
       "definitions": {
         "id": {
+          "example": "fa888fca14be29d3fae455f22d",
           "readOnly": true,
           "type": [
             "string"
           ],
-          "description": "A unique identifier for the invoice items."
+          "description": "A unique identifier for a subscription."
         },
-        "resource": {
-          "example": "invoice_item",
-          "readOnly": true,
+        "period": {
+          "example": "JPY",
           "enum": [
-            "invoice_item"
+            "weekly",
+            "monthly",
+            "yearly"
           ],
-          "description": "Name of resource"
-        },
-        "type": {
-          "example": "invoice_item",
-          "readOnly": true,
-          "enum": [
-            "invoice_item",
-            "plan"
-          ]
-        },
-        "plan": {
-          "oneOf": [
-            {
-              "$ref": "#/definitions/plans/"
-            },
-            {
-              "type": [
-                "null"
-              ]
-            }
-          ]
-        },
-        "invoice": {
-          "readOnly": true,
-          "type": [
-            "string",
-            "null"
-          ]
+          "description": "Interval for subscription payments: 'weekly', 'monthly', or 'yearly'"
         }
       },
       "links": [
         {
           "title": "List",
-          "description": "List invoice items",
-          "href": "/invoice_items",
+          "description": "List subscriptions",
+          "href": "/subscriptions",
           "method": "GET",
           "rel": "instances",
-          "response_example": "invoice_items#index",
-          "schema": {
-            "allOf": [
-              {
-                "type": [
-                  "object"
-                ],
-                "properties": {
-                  "subscription": {
-                    "$ref": "#/definitions/subscriptions/definitions/id"
-                  }
-                }
-              },
-              {
-                "$ref": "#/definitions/list_filter/"
-              }
-            ]
-          },
+          "response_example": "subscriptions#index",
           "targetSchema": {
             "$ref": "#/definitions/list/"
+          },
+          "schema": {
+            "$ref": "#/definitions/list_filter/"
           }
         },
         {
           "title": "Show",
-          "description": "Show an invoice item",
-          "href": "/invoice_items/{(%2Fdefinitions%2Finvoice_items%2Fdefinitions%2Fid)}",
+          "description": "Show a subscription",
+          "href": "/subscriptions/{(%2Fdefinitions%2Fsubscriptions%2Fdefinitions%2Fid)}",
           "method": "GET",
           "rel": "self",
-          "response_example": "invoice_items#show",
+          "response_example": "subscriptions#show",
           "targetSchema": {
-            "$ref": "#/definitions/invoice_items/"
+            "$ref": "#/definitions/subscriptions/"
           }
         },
         {
           "title": "Create",
-          "description": "Create an invoice item",
-          "href": "/invoice_items",
+          "description": "Create a subscription",
+          "href": "/subscriptions",
           "method": "POST",
           "rel": "create",
-          "response_example": "invoice_items#create",
+          "response_example": "subscriptions#create",
           "targetSchema": {
-            "$ref": "#/definitions/invoice_items/"
+            "$ref": "#/definitions/subscriptions/"
           },
           "schema": {
             "type": [
               "object"
             ],
             "properties": {
+              "customer": {
+                "$ref": "#/definitions/payments/definitions/customer"
+              },
               "amount": {
-                "$ref": "#/definitions/invoice_items/properties/amount"
+                "$ref": "#/definitions/payments/definitions/amount"
+              },
+              "currency": {
+                "$ref": "#/definitions/payments/definitions/currency"
               },
-              "subscription": {
-                "$ref": "#/definitions/invoice_items/properties/subscription"
+              "period": {
+                "$ref": "#/definitions/subscriptions/definitions/period"
               },
               "metadata": {
-                "$ref": "#/definitions/invoice_items/properties/metadata"
+                "$ref": "#/definitions/payments/definitions/metadata"
               }
             },
             "required": [
+              "customer",
               "amount",
-              "subscription"
-            ]
+              "currency",
+              "period"
+            ],
+            "additionalFields": false
           }
         },
         {
           "title": "Destroy",
-          "description": "Deletes an invoice item from the upcoming invoice.",
-          "href": "/invoice_items/{(%2Fdefinitions%2Finvoice_items%2Fdefinitions%2Fid)}",
+          "description": "Destroy a subscription",
+          "href": "/subscriptions/{(%2Fdefinitions%2Fsubscriptions%2Fdefinitions%2Fid)}",
           "method": "DELETE",
           "rel": "destroy",
-          "response_example": "invoice_items#destroy",
+          "response_example": "subscriptions#destroy",
           "targetSchema": {
-            "$ref": "#/definitions/invoice_items/"
+            "$ref": "#/definitions/subscriptions/"
           }
         }
       ],
       "properties": {
-        "id": {
-          "$ref": "#/definitions/payments/definitions/id"
-        },
-        "resource": {
-          "$ref": "#/definitions/invoice_items/definitions/resource"
-        },
-        "type": {
-          "$ref": "#/definitions/invoice_items/definitions/type"
+        "customer": {
+          "$ref": "#/definitions/payments/definitions/customer"
         },
         "amount": {
           "$ref": "#/definitions/payments/definitions/amount"
         },
-        "invoice": {
-          "$ref": "#/definitions/invoice_items/definitions/invoice"
-        },
-        "plan": {
-          "$ref": "#/definitions/invoice_items/definitions/plan"
-        },
-        "subscription": {
-          "$ref": "#/definitions/subscriptions/definitions/id"
+        "currency": {
+          "$ref": "#/definitions/payments/definitions/currency"
         },
-        "metadata": {
-          "$ref": "#/definitions/payments/definitions/metadata"
+        "period": {
+          "$ref": "#/definitions/subscriptions/definitions/period"
         }
       },
-      "required": [
-        "id",
-        "resource",
-        "type",
-        "amount",
-        "customer",
-        "currency",
-        "subscription",
-        "invoice",
-        "metadata",
-        "plan"
-      ],
-      "description": "Subscription Invoice Items",
-      "title": "Invoice Items"
+      "description": "Subscription Resource",
+      "title": "Subscriptions"
     },
-    "plans": {
+    "customers": {
       "$schema": "http://json-schema.org/draft-04/hyper-schema",
       "type": [
         "object"
       ],
       "definitions": {
-        "name": {
-          "example": "name2",
+        "id": {
+          "example": "fa799fca14be29d3fae455f22d",
+          "readOnly": true,
           "type": [
             "string"
           ],
-          "description": "Name of the plan."
+          "description": "A unique identifier for the customer."
         },
         "resource": {
-          "example": "plan",
+          "example": "customer",
+          "readOnly": true,
           "enum": [
-            "plan"
+            "customer"
           ],
           "description": "Name of resource"
         },
-        "interval": {
-          "example": "month",
-          "enum": [
-            "day",
-            "week",
-            "month",
-            "year"
-          ],
-          "description": "The billing frequency of a subscription."
-        },
-        "interval_count": {
-          "example": "1",
-          "type": [
-            "integer"
-          ],
-          "minimum": 1,
-          "description": "The number of intervals before the end of each billing period. For example, `interval=month` and `interval_count=3` would bill every 3 months."
-        },
-        "amount": {
-          "$ref": "#/definitions/payments/definitions/amount"
-        },
-        "tax_percent": {
-          "type": [
-            "integer",
-            "null"
-          ]
-        },
-        "currency": {
-          "$ref": "#/definitions/payments/definitions/currency"
+        "payment_details": {
+          "$ref": "#/definitions/payments/definitions/payment_details_response"
         },
         "metadata": {
           "$ref": "#/definitions/payments/definitions/metadata"
         },
-        "renewal_notice_days": {
-          "example": 1,
-          "type": [
-            "integer"
-          ],
-          "minimum": 0
-        },
-        "trial_period_days": {
+        "email": {
           "type": [
-            "integer"
+            "string",
+            "null"
           ],
-          "minimum": 1
+          "format": "email",
+          "maxLength": 255,
+          "description": "Customer's email address."
         },
         "created_at": {
           "example": "2015-03-06T06:52:35Z",
@@ -2936,17 +2351,17 @@ module Komoju
           "type": [
             "string"
           ],
-          "description": "An ISO 8601 formatted timestamp of when the plan was created."
+          "description": "An ISO 8601 formatted timestamp of when the customer was created."
         }
       },
       "links": [
         {
           "title": "List",
-          "description": "List plans",
-          "href": "/plans",
+          "description": "List customers",
+          "href": "/customers",
           "method": "GET",
           "rel": "instances",
-          "response_example": "plans#index",
+          "response_example": "customers#index",
           "targetSchema": {
             "$ref": "#/definitions/list/"
           },
@@ -2956,112 +2371,111 @@ module Komoju
         },
         {
           "title": "Show",
-          "description": "Show a plan",
-          "href": "/plans/{(%2Fdefinitions%2Fplans%2Fdefinitions%2Fname)}",
+          "description": "Show a customer",
+          "href": "/customers/{(%2Fdefinitions%2Fcustomers%2Fdefinitions%2Fid)}",
           "method": "GET",
           "rel": "self",
-          "response_example": "plans#show",
+          "response_example": "customers#show",
           "targetSchema": {
-            "$ref": "#/definitions/plans/"
+            "$ref": "#/definitions/customers/"
           }
         },
         {
           "title": "Create",
-          "description": "Create a plan",
-          "href": "/plans",
+          "description": "Create a customer",
+          "href": "/customers",
           "method": "POST",
           "rel": "create",
-          "response_example": "plans#create",
+          "response_example": "customers#create",
           "targetSchema": {
-            "$ref": "#/definitions/plans/"
+            "$ref": "#/definitions/customers/"
           },
           "schema": {
             "type": [
               "object"
             ],
             "properties": {
-              "name": {
-                "$ref": "#/definitions/plans/definitions/name"
-              },
-              "interval": {
-                "$ref": "#/definitions/plans/definitions/interval"
-              },
-              "interval_count": {
-                "$ref": "#/definitions/plans/definitions/interval_count"
+              "currency": {
+                "$ref": "#/definitions/payments/definitions/currency"
               },
-              "amount": {
-                "$ref": "#/definitions/plans/definitions/amount"
+              "payment_details": {
+                "$ref": "#/definitions/payments/definitions/payment_details_request"
               },
-              "tax_percent": {
-                "$ref": "#/definitions/plans/definitions/tax_percent"
+              "email": {
+                "$ref": "#/definitions/customers/definitions/email"
               },
+              "metadata": {
+                "$ref": "#/definitions/customers/definitions/metadata"
+              }
+            },
+            "required": [
+              "payment_details"
+            ],
+            "additionalFields": false
+          }
+        },
+        {
+          "title": "Update",
+          "description": "Update customers",
+          "href": "/customers/{(%2Fdefinitions%2Fcustomers%2Fdefinitions%2Fid)}",
+          "method": "PATCH",
+          "rel": "self",
+          "response_example": "customers#update",
+          "schema": {
+            "type": [
+              "object"
+            ],
+            "properties": {
               "currency": {
-                "$ref": "#/definitions/plans/definitions/currency"
+                "$ref": "#/definitions/payments/definitions/currency"
               },
-              "renewal_notice_days": {
-                "$ref": "#/definitions/plans/definitions/renewal_notice_days"
+              "payment_details": {
+                "$ref": "#/definitions/payments/definitions/payment_details_request"
               },
-              "trial_period_days": {
-                "$ref": "#/definitions/plans/definitions/trial_period_days"
+              "email": {
+                "$ref": "#/definitions/customers/definitions/email"
               },
               "metadata": {
-                "$ref": "#/definitions/plans/definitions/metadata"
+                "$ref": "#/definitions/customers/definitions/metadata"
               }
             },
-            "required": [
-              "name",
-              "interval",
-              "amount",
-              "currency"
-            ]
+            "additionalFields": false
+          },
+          "targetSchema": {
+            "$ref": "#/definitions/customers/"
           }
         },
         {
           "title": "Destroy",
-          "description": "Destroy a plan",
-          "href": "/plans/{(%2Fdefinitions%2Fplans%2Fdefinitions%2Fname)}",
+          "description": "Destroy a customer",
+          "href": "/customers/{(%2Fdefinitions%2Fcustomers%2Fdefinitions%2Fid)}",
           "method": "DELETE",
           "rel": "destroy",
-          "response_example": "plans#destroy",
+          "response_example": "customers#destroy",
           "targetSchema": {
-            "$ref": "#/definitions/plans/"
+            "$ref": "#/definitions/customers/"
           }
         }
       ],
       "properties": {
-        "resource": {
-          "$ref": "#/definitions/plans/definitions/resource"
-        },
-        "name": {
-          "$ref": "#/definitions/plans/definitions/name"
-        },
-        "interval": {
-          "$ref": "#/definitions/plans/definitions/interval"
-        },
-        "interval_count": {
-          "$ref": "#/definitions/plans/definitions/interval_count"
-        },
-        "currency": {
-          "$ref": "#/definitions/plans/definitions/currency"
-        },
-        "amount": {
-          "$ref": "#/definitions/plans/definitions/amount"
+        "id": {
+          "$ref": "#/definitions/customers/definitions/id"
         },
-        "tax_percent": {
-          "$ref": "#/definitions/plans/definitions/tax_percent"
+        "resource": {
+          "$ref": "#/definitions/customers/definitions/resource"
         },
-        "renewal_notice_days": {
-          "$ref": "#/definitions/plans/definitions/renewal_notice_days"
+        "email": {
+          "$ref": "#/definitions/customers/definitions/email"
         },
         "metadata": {
-          "$ref": "#/definitions/plans/definitions/metadata"
+          "$ref": "#/definitions/customers/definitions/metadata"
         },
         "created_at": {
-          "$ref": "#/definitions/plans/definitions/created_at"
+          "$ref": "#/definitions/customers/definitions/created_at"
         }
       },
-      "description": "Subscription Plans",
-      "title": "Plans"
+      "description": "Customers",
+      "title": "Customers"
     },
     "tokens": {
       "$schema": "http://json-schema.org/draft-04/hyper-schema",
@@ -3115,6 +2529,9 @@ module Komoju
               "object"
             ],
             "properties": {
+              "currency": {
+                "$ref": "#/definitions/payments/definitions/currency"
+              },
               "payment_details": {
                 "$ref": "#/definitions/payments/definitions/payment_details_request"
               }
@@ -3151,24 +2568,12 @@ module Komoju
     "payments": {
       "$ref": "#/definitions/payments"
     },
-    "payouts": {
-      "$ref": "#/definitions/payouts"
-    },
     "subscriptions": {
       "$ref": "#/definitions/subscriptions"
     },
     "customers": {
       "$ref": "#/definitions/customers"
     },
-    "invoices": {
-      "$ref": "#/definitions/invoices"
-    },
-    "invoice_items": {
-      "$ref": "#/definitions/invoice_items"
-    },
-    "plans": {
-      "$ref": "#/definitions/plans"
-    },
     "tokens": {
       "$ref": "#/definitions/tokens"
     }