Updates an existing payment order with new information or status.

This endpoint can be used to modify payment order details or progress a payment order through
its lifecycle by updating its status. Status changes are restricted to valid
transitions:

• pending → approved or archived
• approved → paid or archived
• paid → archived
• archived → (no further transitions allowed)

When updating a payment order's status, the system enforces these valid state transitions
to ensure the integrity of the payment order workflow.

If you provide a bank_account_id, the system will update the payment order to use that
bank account and automatically set the appropriate counterparty type based on the profile
associated with the bank account.