Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.momentco.io/llms.txt

Use this file to discover all available pages before exploring further.

Reserve funds when a customer places an order, then capture when the item ships. If the item becomes unavailable, void the authorisation instead.
{
  "amount": 150000,
  "currency": "ZAR",
  "type": "one_time",
  "options": {
    "checkout_options": { "return_url": "https://merchant.example/return" },
    "payment_method_options": {
      "card": { "capture_method": "manual" }
    }
  }
}
Authorise the estimated amount (e.g. hotel stay), then capture the actual final amount. Void the remaining authorisation.For example, authorise R1 500.00 for a 3-night hotel stay. If the guest checks out after 2 nights (R1 000.00), capture R1 000.00 and void the remaining authorisation.
Authorise immediately, then review the transaction asynchronously. This gives your fraud team a window to review high-value or suspicious transactions before funds are settled. Capture after approval or void if flagged.
Authorise the full order amount, then capture per shipment as items become available. Void the remaining authorisation for any unshipped items.For example, a customer orders 3 items totalling R3 000.00. Ship item 1 (R1 200.00) and capture that amount. Ship item 2 (R800.00) and capture again. If item 3 is out of stock, void the remaining authorisation.
Authorise the base amount (e.g. a restaurant bill), then capture the final amount including the tip. Void the difference if the tip is less than the authorised buffer.For example, authorise R500.00 for a meal. The customer adds a R75.00 tip, so you capture R575.00 (if within the authorised amount) or capture R500.00 and process the tip separately.
Authorise a deposit amount when a customer begins a rental (e.g. car hire, equipment rental), then capture only the actual usage charges and void the remainder.For example, authorise R5 000.00 for a weekend car rental. The customer returns the car with no damage, so you capture R2 500.00 for the rental fee and void the remaining R2 500.00 deposit.
For simple, immediate payments where no review or delay is needed, use the default capture_method: automatic.