support for flexible billing and usage records

stripe/api_resources/__init__.py

@@ -45,3 +45,4 @@
 from stripe.api_resources.token import Token
 from stripe.api_resources.topup import Topup
 from stripe.api_resources.transfer import Transfer
+from stripe.api_resources.usage_record import UsageRecord

stripe/api_resources/usage_record.py

@@ -0,0 +1,21 @@
+from __future__ import absolute_import, division, print_function
+
+from stripe.api_resources.abstract.api_resource import APIResource
+from stripe import api_requestor, util
+
+
+class UsageRecord(APIResource):
+    OBJECT_NAME = 'usage_record'
+
+    @classmethod
+    def create(cls, subscription_item, api_key=None, idempotency_key=None,
+               stripe_version=None, stripe_account=None,**params):
+        requestor = api_requestor.APIRequestor(api_key,
+                                               api_version=stripe_version,
+                                               account=stripe_account)
+        url = "/v1/subscription_items/%s/usage_records" % subscription_item
+        headers = util.populate_headers(idempotency_key)
+        response, api_key = requestor.request('post', url, params, headers)
+
+        return util.convert_to_stripe_object(response, api_key, stripe_version,
+                                             stripe_account)

stripe/util.py

@@ -218,6 +218,7 @@ def load_object_classes():
         api_resources.Token.OBJECT_NAME: api_resources.Token,
         api_resources.Topup.OBJECT_NAME: api_resources.Topup,
         api_resources.Transfer.OBJECT_NAME: api_resources.Transfer,
+        api_resources.UsageRecord.OBJECT_NAME: api_resources.UsageRecord,
     }
 
 

tests/api_resources/test_usage_record.py

@@ -0,0 +1,22 @@
+from __future__ import absolute_import, division, print_function
+
+import stripe
+from tests.helper import StripeTestCase
+
+
+TEST_SUBSCRIPTION_ITEM_ID = 'si_123'
+
+
+class UsageRecordTest(StripeTestCase):
+    def test_is_creatable(self):
+        resource = stripe.UsageRecord.create(
+            subscription_item=TEST_SUBSCRIPTION_ITEM_ID,
+            quantity=123,
+            timestamp=123123,
+            action='increment',
+        )
+        self.assert_requested(
+            'post',
+            '/v1/subscription_items/%s/usage_records' % TEST_SUBSCRIPTION_ITEM_ID
+        )
+        self.assertIsInstance(resource, stripe.UsageRecord)