From c691f9268ec913de4cac2f29f71ae92095a2f9c4 Mon Sep 17 00:00:00 2001
From: Jean-Paul Calderone <exarkun@twistedmatrix.com>
Date: Fri, 30 Aug 2019 11:19:10 -0400
Subject: [PATCH] slightly improved instructions perhaps

---
 README.rst | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/README.rst b/README.rst
index c0aaf40..565703d 100644
--- a/README.rst
+++ b/README.rst
@@ -13,9 +13,8 @@ First, run the server::
 
   $ stack run
 
-Then configure Stripe with a webhook pointing at the server.
-The hook lives at ``/v1/stripe/webhook`` so configure Stripe with,
-eg, ``http://youraddress:8081/v1/stripe/webhook``.
+Then configure Stripe with a `webhook`_ pointing at the server and receiving the *charge.successful* event.
+Configure Stripe with ``http://<youraddress>:8081/v1/stripe/webhook``.
 
 Then create a testing charge using Stripe::
 
@@ -30,3 +29,5 @@ Then create a testing charge using Stripe::
 
 This results in Stripe making a callback to the PaymentServer with the charge details.
 The PaymentServer marks the voucher as paid in its database.
+
+.. _webhook: https://stripe.com/docs/webhooks/setup#configure-webhook-settings
-- 
GitLab