stripe
Stripe API)
Stripe API coverage for Haskell (All Stripe commands are supported, including but not limited to:
- Charges
- Refunds
- Customers
- Cards
- Subscriptions
- Plans
- Coupons
- Discounts
- Invoices
- Invoice Items
- Disputes
- Transfers
- Recipients (Deprecated)
- Bitcoin
- Application Fees
- Application Fee Refunds
- Account
- Balance
- Events and Tokens
Haddock Coverage
All code written for this library is documented to completion with the haddock documentation tool
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 # You will be prompted to enter your *TEST* key
Pagination
Pagination is possible on all API calls that return a JSON array.
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 (StripeKey "secret key") Nothing
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 -> print (list stripelist :: [Customer])
Left stripeError -> print stripeError
Optional Parameters
Stripe API calls can take multiple optional parameters.
stripe-haskell
supports optional parameters through the use of type-families and typeclasses.
In practice, the function to use is (-&-)
to specify optional parameters on a request.
For a deeper dive into how this works, please see this blog post.
chargeCardByToken :: TokenId -> Currency -> Amount -> IO (Either StripeError Charge)
chargeCardByToken tokenId currency amount =
stripe config $ createCharge amount currency
-&- tokenId
Versioning
All versioning is hard-coded (for safety) to version 2014-10-07
.
Stripe API versions specified in the HTTP headers of Stripe requests take precedence
over the API version specified in your Stripe Dashboard. In an attempt to ensure
API consistency and correct parsing of returned JSON, all Stripe versions are hard-coded, and are
inaccessible 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.
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 (StripeKey "secret key") Nothing
result <- stripe config $ getCustomerExpandable
(CustomerId "customerid")
(["default_card"] :: ExpandParams)
case result of
Right customer -> print (defaultCard customer) -- Will be an `ExpandedCard`
Left stripeError -> print stripeError
MetaData
Stripe objects allow the embedding of arbitrary 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 (StripeKey "secret key") Nothing
result <- stripe config $ updateCoupon (CouponId "couponid") [("key1", "value2"), ("key2", "value2")]
case result of
Right coupon -> print $ couponMetaData coupon
Left stripeError -> print stripeError
Issues
Any API recommendations or bugs can be reported on the GitHub issue tracker. Pull requests welcome!
Contributors
Code Contributors
This project exists thanks to all the people who contribute. [Contribute].
Financial Contributors
Become a financial contributor and help us sustain our community. [Contribute]
Individuals
Organizations
Support this project with your organization. Your logo will show up here with a link to your website. [Contribute]