Finish Paystack Invoice Payment | CargoExtra Global Logistics USA

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.

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.

Request

This endpoint expects an object.

cloneIdstringRequired

invoiceNointegerRequired

referencestringRequired

amountPaidintegerRequired

partPaymentFromWalletBalanceobjectRequired

Response

key_0integer

key_1string

key_2double

key_3string

key_4boolean

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error

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.

$	curl -X POST http://localhost:9000/api/v1/billing/invoice/paystack/finish \
>	-H "Content-Type: application/json" \
>	-d '{
>	"cloneId": "64f0a1b2c3d4e5f678901234",
>	"invoiceNo": 100456,
>	"reference": "PSKTXN20240615ABC123",
>	"amountPaid": 25000,
>	"partPaymentFromWalletBalance": {
>	"currency": "NGN",
>	"exchangeRate": 1,
>	"chargeTotalBefore": 25000,
>	"chargeTotalCurrent": 0
>	}
>	}'

1	{
2	"key_0": 100456,
3	"key_1": "Payment successful",
4	"key_2": 25000,
5	"key_3": "PSKTXN20240615ABC123",
6	"key_4": true
7	}