Skip to main content

Search

Admoji Help Center

Browse guides, FAQs, and tutorials — or search for something specific

How to Charge an Upsell Later with the API

To authorize an upsell at checkout and capture it later — for example, 24 hours after the sale — send the upsell as its own Add Order call instead of bundling it into the main order. A capture settles the whole authorization of an order, so an upsell that rides inside the main order cannot be captured on its own.

Note: The upsell has to run on a processor that supports Auth + Capture. See How to Set Up Auth + Capture for the list of gateways.

Step 1: Authorize the Upsell

Call the Add Order endpoint with the main order's ID and "TransactionType": "auth":

$ curl -X POST 'https://openapi.admoji.com/api/v2/open/orders' \
  -H "Authorization: ApiKey secret_492796e421a34666a5695d53cd311111" \
  -H "Content-Type: application/json" \
  -d '{
    "OrderID": 1234567,
    "TransactionType": "auth",
    "Products": [{ "ProductID": 55123 }]
  }'

  • OrderID is the ID returned for the main order. It links the upsell to that order.

  • No payment information is needed. Admoji charges the payment method saved at checkout.

  • TransactionType set to auth runs an authorization only. What you send in the API takes priority over the Transaction Mode of the product and the processor.

  • Keep the order ID of the upsell from the response — you need it to capture.

Step 2: Capture the Upsell

Choose one of these:

  • Capture it yourself — call POST https://openapi.admoji.com/api/v2/open/capture/{orderId} with the upsell's order ID when you are ready. A successful capture returns "Status": 0.

$ curl -X POST 'https://openapi.admoji.com/api/v2/open/capture/1234568' \
  -H "Authorization: ApiKey secret_492796e421a34666a5695d53cd311111"

  • Let Admoji capture it — open the upsell product, go to the Auth / Capture tab, set Transaction Mode to Auth + Capture and Capture Delay (Days) to 1. The capture job runs every 6 hours, so the charge settles about a day after the authorization.

Important: Card authorizations usually expire after 5–7 days, depending on the card network and issuer. Capture before the authorization expires, or the order cannot be settled without charging the card again.
Note: Test the capture with a real card. An authorization placed with a card from your Test Cards list is simulated inside Admoji and never reaches the gateway, so there is nothing to capture and the capture fails (for example, with Invalid transaction_id).

Related articles