This guide explains the Auth + Capture transaction mode in Admoji — what it is, how to enable it on a processor, how the auto-capture schedule works, and where to track authorized and captured transactions across the platform.

What is Auth + Capture?

In a standard Default (Sale) transaction, authorization and settlement happen in a single step — the customer's card is charged immediately. With Auth + Capture, the flow is split into two distinct steps:

1. Authorization (Auth) — Admoji sends an authorization request to the payment gateway. The gateway verifies the card and reserves the specified amount on the customer's account. No money moves yet; the funds are simply placed on hold.

2. Capture — A second request is sent (either automatically on a schedule or manually) to settle the transaction and transfer the reserved funds to your merchant account.

This model is useful when you need to verify an order before charging the customer — for example, to confirm stock availability, run fraud checks, or only bill after a shipment is confirmed.

Step 1: Enable Auth + Capture on a Processor

1. Go to Merchants > Processors.

2. Click the edit icon in the Actions column on the processor you want to configure, or click Add New to create a new one.

3. In the processor form, switch to the Settings tab.

4. Locate the Transaction Mode dropdown. By default it is set to Default (Sale). Change it to Auth + Capture.

Step 2: Configure the Capture Delay

Once Auth + Capture is selected, a Capture Delay (Days) field appears in the Settings section. This controls how long Admoji waits before automatically submitting the capture request for each authorized transaction:

• Enter a number (minimum 1) — Wait that many days after the authorization before automatically submitting the capture. The AuthCaptureJob runs every 6 hours and submits the capture once the configured delay has passed. For example, entering 1 will capture approximately 1 day (24 hours) after the auth transaction is created.

• Leave empty — Auto-capture is disabled. Authorized transactions will remain in Pending (Authorization) status until captured or voided manually.

Step 3: How Auth + Capture Appears in the Customer Profile

Once a customer places an order through an Auth + Capture processor, you can follow the two-step flow directly in their profile:

1. Go to For Customers and open the customer's profile.

2. In the Orders section, click the order row to open the Order Details modal.

3. Click the Transactions tab.

The Type column shows the transaction type and the Result column shows a status badge reflecting the current state:

• Auth → Pending (Authorization) — The card was successfully authorized. Funds are reserved but not yet settled. A capture is required to complete the charge.

• Capture → Success (Captured) — The capture was submitted successfully. Funds are now being settled to your merchant account.

Step 4: Monitoring Auth + Capture in Reports

Go to Reports > Processing to monitor the Auth + Capture flow across your processors. The following columns are relevant:

• Pending Auths — Transactions approved for a specified amount but not yet posted to the bank account. A capture is required to complete the sale.

• Sales Capture — All approved and captured transactions in the selected date range.

• Voids — Transactions canceled prior to settlement. An authorized transaction that is voided will not be captured and the hold on the customer's card will be released.

Step 5: Manually Capture an Authorized Order

When auto-capture is disabled (or you want to settle a charge before its scheduled capture), you can capture an authorized order directly from the customer's profile:

1. Go to For Customers and open the customer's profile.

2. In the Orders section, click the order to open the Order Details modal, then select the Transactions tab.

3. Find the authorized transaction (Type: Auth, status Pending (Authorization)) and click the Capture button in its row.

4. Once the capture succeeds, you will see a Transaction captured successfully confirmation and a new Capture transaction with a Success (Captured) status.

Step 6: Manual Capture via API

If you have left Capture Delay (Days) empty (manual capture mode), you can trigger a capture programmatically using the Open API.

Definition

POST https://openapi.admoji.com/api/v2/open/capture/:orderId

Request Example

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

Response Example

{
  "Status": 0
}

Captures a previously authorized order. A Status: 0 response indicates success.

Request Arguments

• orderId (required) — The ID of the order to capture. The order must have a Pending (Authorization) status.