Commit 450638e
docs(withdrawal): clarify beneficiary vs payment-instruction lifecycle (#23)
Two corrections to the "Register a beneficiary" step in the withdrawal
journey, addressing the open item from Leone's docs review:
1. The beneficiary record itself has no status. Status, review, and
webhook events are tracked at the payment-instruction level.
Re-word to make that explicit and to frame the beneficiary as a
reusable record across destinations — the first instruction on a
new beneficiary triggers the full compliance review, subsequent
instructions on the same beneficiary go through a reduced check
(without exposing the internal rules in detail).
2. List the webhook events emitted at this step:
BENEFICIARY_PAYMENT_INSTRUCTION_CREATED, _APPROVED, _REJECTED — so
integrators know what to subscribe to for the review outcome.
Mirrors what the "Submit the operation" step already does for
OPERATION_REQUESTED / _COMPLETED / _FAILED.
Step title also adjusted from "Register a beneficiary (one time per
destination)" — that subtitle was misleading since one beneficiary
can carry multiple payment instructions over time. New title:
"Register a beneficiary and add a payment instruction".
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>1 parent 8b5a7ed commit 450638e
1 file changed
Lines changed: 3 additions & 3 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
15 | 15 | | |
16 | 16 | | |
17 | 17 | | |
18 | | - | |
19 | | - | |
| 18 | + | |
| 19 | + | |
20 | 20 | | |
21 | 21 | | |
22 | 22 | | |
| |||
45 | 45 | | |
46 | 46 | | |
47 | 47 | | |
48 | | - | |
| 48 | + | |
49 | 49 | | |
50 | 50 | | |
51 | 51 | | |
| |||
0 commit comments