Skip to main content

Mark Payment As Paid

POST 
/api/v2/payments/:payment_id/mark-paid

Manually mark a payment as paid (full or partial).

Record a payment received through manual methods (CASH, BANK_TRANSFER, CARD, or QURRAH).

Full: omit amount or pass amount == payment.amount. Partial: pass amount < payment.amount with remainder greater than 1 in the payment currency (not allowed while UNDER_REVIEW).

  • Selected payment amount is reduced and marked SUCCEEDED.
  • A new PENDING SPLIT_REMAINDER payment is created for the remainder.
  • invoice.type is unchanged (ONE_OFF stays ONE_OFF).
  • Invoice completes only when every payment is paid.

Request​

Responses​

Successful Response