userguide: update payment API doc

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