Commit staged payment batch
commit_payment_batchFinalizes a staged payment batch with its stage ID and confirmation token, transitioning the order to committed and optionally writing the ISO 20022 XML output.
Instructions
Commit a staged payment batch with its confirmation token.
Verifies the stage ID and validates the secondary confirmation token
using constant-time cryptographic comparison (preventing timing attacks).
Transitions the order status from 'staged' to 'committed'. Optionally
writes a new ``.xml`` file inside the output directory (see
``_output.py``). The token guards against an accidental commit only.
Args:
stage_id: Staging identifier from stage_payment_batch.
confirmation_token: Secondary secret confirmation token.
output_file_path: Optional new XML file in the output directory.
Returns:
CommitPaymentBatchResult with commit timestamp and fingerprint,
or {"error": ...}.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"stage_id": "<stage_id>",
"confirmation_token": "<confirmation_token>"
},
"name": "commit_payment_batch"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| stage_id | Yes | The staging identifier returned by stage_payment_batch. | |
| output_file_path | No | Optional new .xml file inside the output directory (PAIN001_MCP_OUTPUT_DIR, else the working directory). | |
| confirmation_token | Yes | The confirmation token stage_payment_batch returned for this batch. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | ||
| status | No | ||
| stage_id | No | ||
| committed_at | No | ||
| output_file_path | No | ||
| sha256_fingerprint | No | ||
| total_transactions | No |