2018-03-31 04:13:44 +02:00
|
|
|
# Billing
|
|
|
|
|
|
|
|
|
|
Zulip uses a third party (Stripe) for billing, so working on the billing
|
|
|
|
|
system requires a little bit of setup.
|
|
|
|
|
|
|
|
|
|
To set up the development environment to work on the billing code:
|
|
|
|
|
* Create a Stripe account
|
|
|
|
|
* Go to <https://dashboard.stripe.com/account/apikeys>, and add the
|
|
|
|
|
publishable key and secret key as `stripe_publishable_key` and
|
|
|
|
|
`stripe_secret_key` to `zproject/dev-secrets.conf`.
|
|
|
|
|
|
2018-09-25 14:02:43 +02:00
|
|
|
Nearly all the billing-relevant code lives in `corporate/`.
|
2018-03-31 04:13:44 +02:00
|
|
|
|
2018-11-17 23:04:36 +01:00
|
|
|
## Upgrading Stripe API versions
|
|
|
|
|
|
|
|
|
|
Stripe makes pretty regular updates to their API. The process for upgrading
|
|
|
|
|
our code is:
|
|
|
|
|
* Go to <https://dashboard.stripe.com/developers> in your Stripe account.
|
|
|
|
|
* Upgrade the API version.
|
2020-03-13 15:45:47 +01:00
|
|
|
* Run `tools/test-backend --generate-stripe-fixtures`
|
2018-11-17 23:04:36 +01:00
|
|
|
* Fix any failing tests, and manually look through `git diff` to understand
|
|
|
|
|
the changes.
|
|
|
|
|
* If there are no material changes, commit the diff, and open a PR.
|
|
|
|
|
* Ask Rishi or Tim to go to <https://dashboard.stripe.com/developers> in the
|
|
|
|
|
zulipchat Stripe account, and upgrade the API version there.
|
|
|
|
|
|
|
|
|
|
We currently aren't set up to do version upgrades where there are breaking
|
2018-12-15 09:33:25 +01:00
|
|
|
changes, though breaking changes should be unlikely given the parts of the
|
|
|
|
|
product we use. The main remaining work for handling breaking version upgrades
|
|
|
|
|
is ensuring that we set the stripe version in our API calls.
|
2018-11-17 23:04:36 +01:00
|
|
|
<https://stripe.com/docs/upgrades#how-can-i-upgrade-my-api> has some
|
|
|
|
|
additional information.
|
