userguide: update payment API overview

Signed-off-by: Pierre-Alexandre Meyer <pierre@mouraf.org>
userguide: update payment method API doc

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