Finish Paystack Invoice Payment

Finalizes a Paystack invoice payment after Paystack confirms the transaction.

Required body fields: cloneId, invoiceNo, reference, amountPaid, partPaymentFromWalletBalance.

Response fields: message, status, invoice, invoiceNo, amount, paymentId.

Possible errors:

• 404: Invoice not found - invoice number does not belong to the customer.
• 400: Bad Invoice - invoice already paid or in invalid payment state.
• 400: Clone not found - cloneId is invalid or does not match invoice.
• 400: Invalid Currency - invoice currency no longer resolves.
• 400: Payment method is disabled - Paystack is not active for the currency.
• 400: Paystack transaction already used - duplicate reference.
• 400: Invalid Amount - amount paid does not match expected amount.
• 400: Missing One or More Required Parameters - required body/query fields were not supplied.
• 401: Unauthorized - token is missing, expired, invalid, or the account/token pair was not found.
• 403: Access denied - gateway traffic guard/rate policy blocked the request.
• 429: Too many requests - gateway rate limit exceeded.
• 500: Unexpected Error - unhandled gateway or downstream service failure.