Sign in

v2

latestOpenAPI 3.1.02026-07-264249163.7 KB
Order

Upcharge amount by order

Use this endpoint to upcharge an amount on an existing order. Can be performed after payment authorization. Upon success, a new separate order is created for the upcharge amount only. The original order is not released and remains in its current state. The upcharge amount is charged to the shopper as a single payment. The cumulative total of all upcharges on a given order must not exceed 15% of the original order amount. The currency of the upcharge must match the currency of the original order. The relationship between the upcharge order and the original order is queryable via Get Order: the upcharge order returns is_upcharge: true and parent_order_uuid, and the original order returns an upcharges array listing each upcharge.

post/v2/order/{order_uuid}/upcharge

Path parameters

order_uuidstring required

The Order UUID to upcharge (order.uuid from session response)

Headers

Sezzle-Request-Idstring

Unique client-generated ID to enforce idempotency

Request body

intent'AUTH' | 'CAPTURE' required
  • Use CAPTURE if payment should be captured immediately upon shopper authorization
  • Use AUTH if there is any post-authorization validation needed prior to capture, such as inventory validation or regulatory requirements, or if merchant policy is to charge the payment method at time of shipment
    • Submit a capture request via the API or your Merchant Dashboard before the authorization expires.
    • The authorization expiration window can be set from 30 minutes up to 7 days in your Merchant Dashboard Settings.
  • If not specified, the value will default to CAPTURE

Response

Successful Operation

uuidstring

The UUID of the new upcharge order. This UUID can be used with other Order API endpoints (e.g., capture, refund).