Create a payment (charge) on an order
Apply a payment to an invoice/order. Routes by payment_method: card/ach -> Stripe PaymentIntent; cash/check/credit/terms -> manual record. Overpayment automatically creates a credit memo. Requires both orders:write AND payments:write scopes. R4: raw card credentials (card_number, cvc) are rejected. Idempotent via Idempotency-Key header.
Revision acknowledgment gate (HTTP 409 revision_unacknowledged).
If the order was revised after the customer received their copy and the customer has not
yet acknowledged the new total, this endpoint returns HTTP 409 with
code: revision_unacknowledged. Lift the gate via
POST /v1/orders/{id}/customer-acknowledge-revision, or bypass with
?override=true / {"skip_revision_ack": true} (requires orders.revision_override
permission). Disable entity-wide via
entities.settings.require_customer_ack_on_revision = false.
Authorizations
API key issued per entity via Settings > Developers > API Keys.
Each key carries scopes (e.g. orders:read, products:write).
Bearer token format: Authorization: Bearer ark_live_ent_Test keys use ark_test_ent_. Both are issued per entity
via Settings > Developers > API Keys.
Headers
Client-generated unique key for idempotent POST/PATCH/DELETE operations. Alias for the Idempotency parameter. Max 255 chars. On retry with the same key, the original response is returned without re-executing the operation. Keys expire after 24 hours.
255Path Parameters
Body
card, ach, cash, check, credit, terms, external Stripe PM id for card/ach
Partial payment in dollars; omit for full balance
Check number, external reference, etc.
When true, bypasses the revision acknowledgment gate. Requires the caller to have the orders.revision_override permission; returns 403 otherwise. Equivalent to the ?override=true query parameter.
Response
Payment created
A customer-side payment applied to one or more orders. AR-facing.
payment Set when payment is applied to a single order; null for unapplied/on-account payments.
cash, check, ach, wire, credit_card, debit_card, store_credit, stripe, other Gross amount received (always positive).
Portion applied to orders so far.
Total refunded against this payment.
Check number, ACH trace, Stripe charge id, etc.
pending, succeeded, failed, refunded, partially_refunded, voided 
