stripe-haskell: Stripe API for Haskell

[ library, mit, web ] [ Propose Tags ]

100% Stripe API Coverage: All Stripe commands are supported, including but not limited to Charges, Refunds, Customers, Cards, Subscriptions, Plans, Coupons, Discounts, Invoices, Invoice Items, Disputes, Transfers, Recipients, Application Fees, Application Fees Refunds, Account, Balance, Events and Tokens

100+ Hspec Tests:
Thoroughly unit-tested with hspec. All API commands are unit tested before inclusion into the API (see the tests directory). To run the tests, perform the following:
 cabal clean && cabal configure --enable-tests && cabal build tests && dist/build/tests/tests
Pagination:
Pagination is possible on all API calls that return a JSON array. (https://stripe.com/docs/api#pagination) Any API call that returns a StripeList is eligible for pagination. To use in practice do the following.
import Web.Stripe
import Web.Stripe.Customer

main :: IO ()
main = do
  let config = StripeConfig "secret key"
  result <- stripe config $ getCustomers
                                 (Just 30 :: Maybe Limit) -- Defaults to 10 if Nothing, 100 is Max
                                 (StartingAfter $ CustomerId "customer_id0")
                                 (EndingBefore $ CustomerId "customer_id30")
  case result of
    Right (StripeList stripelist)  -> print (list stripelist :: [Customer])
    Left stripeError -> print stripeError
Versioning:
All versioning is hard-coded (for safety) (https://stripe.com/docs/api#versioning) Stripe API versions specified in the HTTP headers of Stripe requests take precendence over the API version specified in your Stripe Admin Panel. In an attempt to ensure API consistency and correct parsing of returned JSON, all Stripe versions are hard-coded, and not accessible to the end users of this library. When a new Stripe API version is released this library will increment the hard-coded API version.
Expansion:
Object expansion is supported on Stripe objects eligible for expansion though the ExpandParams type (https://stripe.com/docs/api#expansion) Object expansion allows normal Stripe API calls to return expanded objects inside of other objects. For example, a Customer object contains a card id hash on the default_card field. This default_card hash can be expanded into a full Card object inside a Customer object. As an example:
import Web.Stripe
import Web.Stripe.Customer

main :: IO ()
main = do
  let config = StripeConfig "secret key"
  result <- stripe config $ getCustomerExpandable
                                 (CustomerId "customerid")
                                 (["default_card"] :: ExpandParams)
  case result of
    Right (Customer customer) -> print (defaultCard customer) -- Will be an `ExpandedCard`
    Left stripeError -> print stripeError
MetaData:
Stripe objects allow the embedding of arbitrary metadata (https://stripe.com/docs/api#metadata) Any Stripe object that supports the embedding of metadata is available via this API. As an example:
import Web.Stripe
import Web.Stripe.Coupon

main :: IO ()
main = do
  let config = StripeConfig "secret key"
  result <- stripe config $ updateCoupon (CouponId "couponid") [("key1", value2"), ("key2", "value2")]
  case result of
    Right (Coupon coupon) -> print (couponMetaData coupon)
    Left stripeError -> print stripeError
Issues:
Any API recommendations or bugs can be reported here: (https://github.com/dmjio/stripe-haskell/issues) Pull requests welcome!
Versions [faq] 0.1.0.0, 0.1.0.1, 0.1.0.2, 0.1.0.3, 0.1.0.4, 0.1.0.5, 0.1.0.6, 0.1.1.0, 0.1.1.1, 0.1.1.2, 0.1.3.0, 0.1.3.1, 0.1.4.0, 0.1.4.1, 0.1.4.2, 0.1.4.3, 2.0.0, 2.0.1, 2.0.2, 2.0.3, 2.1.0, 2.2.0, 2.2.1, 2.2.2, 2.2.3, 2.3.0, 2.4.0, 2.4.1, 2.5.0
Dependencies aeson, base (==4.7.*), bytestring, either, HsOpenSSL, hspec, http-streams, io-streams, mtl (>=2.1.3.1), random (>=1.1), text, time, transformers, unordered-containers, vector [details]
License MIT
Copyright Copyright (c) 2014 David M. Johnson
Author David Johnson
Maintainer djohnson.m@gmail.com
Category Web
Home page https://github.com/dmjio/stripe-haskell
Bug tracker https://github.com/dmjio/stripe-haskell/issues
Source repo head: git clone git://github.com/dmjio/stripe-haskell.git
Uploaded by DavidJohnson at 2014-10-28T21:15:05Z
Distributions NixOS:2.5.0
Downloads 15711 total (42 in the last 30 days)
Rating 2.25 (votes: 2) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Hackage Matrix CI
Docs uploaded by user
Build status unknown [no reports yet]

Modules

[Index]

Downloads

Maintainer's Corner

For package maintainers and hackage trustees