recipient:writeMutates state: Yes when validation succeeds
Idempotency: Stable
request_id
request_id, rail, type, and at least one input source are required. Fiat
recipients also require exactly one payment_instrument selected from the
estimate’s recipient_requirements: qr, bank_transfer, or mobile_money.
Use exactly one of image.path or image.data_base64. Images are limited to 10
MB decoded data and must contain machine-readable QR content; OCR is not
provided.
On hosted OAuth, call get_supported_bank_names before a bank-transfer
recipient when the tool is available. If it is unavailable, submit the user’s
bank name and let Core validate or canonicalize it.
The tool either returns information_required without writing, or registers
canonical fields and returns the recipient plus a reusable payment destination.
