PRprototyping
admin-payments

Confirm Po

Confirm a Purchase Order — advances project to ORDER_CONFIRMED.

The B2B "we have your PO, work can begin" event. Decoupled from invoice-paid semantics: this endpoint advances the project lifecycle and fires an admin in-app notification, but DOES NOT touch payment.status or invoice.status, and does NOT email the customer. The customer's payment is still expected on the agreed Net-30/60/90 terms.

Use POST /admin/payments/{id}/mark-invoice-paid separately when the customer's check actually clears (typically weeks or months later).

Idempotent: if the project is already past PAYMENT_PENDING this is a successful no-op.

Requires payments:edit permission.

post/api/v1/admin/payments/{payment_id}/confirm-po

Request

Path parameters

payment_idstring uuid required

Request body

delivery_option_idstring uuid required
payment_terms_net_daysinteger required

Response

Successful Response

idstring uuid required
project_idstring uuid required
quote_idstring uuid required
user_idstring uuid required
methodstring required
statusstring required
amountstring required
total_with_taxstring nullable
deposit_amountstring nullable
currencystring required
stripe_payment_intent_idstring nullable
po_numberstring nullable
po_document_r2_keystring nullable
po_document_download_urlstring nullable
shipping_addressstring nullable
notesstring nullable
paid_atstring date-time nullable
created_atstring date-time required
updated_atstring date-time required
project_namestring required
customer_namestring required
customer_emailstring required
customer_billing_addressstring nullable
submitted_by_admin_idstring uuid nullable
submitted_by_labelstring nullable
payment_terms_net_daysinteger nullable
order_placed_at_overridestring date-time nullable
order_placed_atstring date-time nullable

Changes

No recorded changes to this operation across all 1 revision of this API.