payment: fix typo

Signed-off-by: Pierre-Alexandre Meyer <pierre@mouraf.org>
payment: clarify flow

Signed-off-by: Pierre-Alexandre Meyer <pierre@mouraf.org>
Merge branch 'master' of github.com:killbill/killbill-docs