Skip to main content

RecordPayment manually records a payment.

POST 
/api/v1/billing/payments

Use for payments received outside automated gateways: bank transfers, cheques, cash payments. Creates payment record and optionally applies to an invoice or wallet.

Authorization​

Requires billing:admin permission.

Behavior​

  • Creates Payment record in 'completed' status
  • If invoice_id provided, applies payment to invoice
  • If wallet_id provided, credits wallet balance
  • Records who recorded the payment for audit

Response​

Returns created Payment with generated reference.

Errors​

  • PERMISSION_DENIED: Caller lacks billing:admin permission
  • NOT_FOUND: Organization, invoice, or wallet not found
  • INVALID_ARGUMENT: Invalid payment details

Request​

Responses​

A successful response.