Simulation

Simulate incremental authorization

POST/simulate/issuing/card-transactions/{card_transaction_id}/incremental-authorization

Simulate an incremental authorization that adds to an existing authorization hold, such as a hotel stay extension. Currency codes are preserved from the initial authorization.

The original transaction must have started as an authorization, not a full financial transaction, and must not have captured funds. Column sends a real-time authorization decision request for the increment to your endpoint subscribed to decision.issuing.card_transaction, and declines if none is configured.

Path Parameters

card_transaction_id

stringRequired

Unique identifier for the card transaction.

Body Parameters

cardholder_amount

numberRequired

Additional cardholder amount to authorize, expressed in the smallest currency unit (e.g., cents for USD). This amount will be added to the existing authorization hold. Must not exceed 999999999999.

fx_rate

stringOptional

Foreign exchange rate for multi-currency transactions, as a decimal string. If not provided, uses the original transaction's FX rate.