/**
 * @swagger
 * /api/payments:
 *   post:
 *     summary: Initiate a payment
 *     description: Process a payment between two accounts
 *     tags: [Payments]
 *     security:
 *       - SovereignToken: []
 *     requestBody:
 *       required: true
 *       content:
 *         application/json:
 *           schema:
 *             type: object
 *             required:
 *               - debtorAccount
 *               - creditorAccount
 *               - amount
 *               - currency
 *             properties:
 *               debtorAccount:
 *                 type: string
 *                 description: Account number of the debtor
 *                 example: "ACC-1234567890"
 *               creditorAccount:
 *                 type: string
 *                 description: Account number of the creditor
 *                 example: "ACC-0987654321"
 *               amount:
 *                 type: string
 *                 description: Payment amount (decimal as string)
 *                 example: "1000.00"
 *               currency:
 *                 type: string
 *                 description: ISO 4217 currency code
 *                 example: "USD"
 *               priority:
 *                 type: string
 *                 enum: [RTGS, URGENT, NORMAL, DNS]
 *                 default: NORMAL
 *               reference:
 *                 type: string
 *                 description: Payment reference
 *                 example: "Invoice #12345"
 *               assetType:
 *                 type: string
 *                 enum: [fiat, cbdc, commodity, security]
 *                 default: fiat
 *     responses:
 *       200:
 *         description: Payment processed successfully
 *         content:
 *           application/json:
 *             schema:
 *               type: object
 *               properties:
 *                 success:
 *                   type: boolean
 *                   example: true
 *                 data:
 *                   type: object
 *                   properties:
 *                     paymentId:
 *                       type: string
 *                       example: "PAY-abc123"
 *                     status:
 *                       type: string
 *                       example: "settled"
 *                     ledgerEntryIds:
 *                       type: array
 *                       items:
 *                         type: string
 *       400:
 *         description: Validation error
 *       401:
 *         description: Unauthorized
 *       404:
 *         description: Account not found
 *       500:
 *         description: Internal server error
 */

/**
 * @swagger
 * /api/payments/{paymentId}:
 *   get:
 *     summary: Get payment status
 *     description: Retrieve the status of a payment
 *     tags: [Payments]
 *     security:
 *       - SovereignToken: []
 *     parameters:
 *       - in: path
 *         name: paymentId
 *         required: true
 *         schema:
 *           type: string
 *         description: Payment ID
 *         example: "PAY-abc123"
 *     responses:
 *       200:
 *         description: Payment status retrieved
 *         content:
 *           application/json:
 *             schema:
 *               type: object
 *               properties:
 *                 success:
 *                   type: boolean
 *                 data:
 *                   type: object
 *                   properties:
 *                     paymentId:
 *                       type: string
 *                     status:
 *                       type: string
 *                       enum: [processing, settled, failed]
 *                     ledgerEntryIds:
 *                       type: array
 *                       items:
 *                         type: string
 *       404:
 *         description: Payment not found
 */

// This is an example file showing how to document API routes with Swagger/OpenAPI
// Apply this pattern to all route files

