Menu Apps

Delayed capture transactions

By default, the Charge endpoint charges a card as soon you make a valid request to it. If you prefer, you can choose to delay capture of transactions you initiate with the endpoint. If you do, the buyer's credit card is authorized for the amount of money you specify, and then you have up to six days to either capture the funds or void (i.e., cancel) the transaction.

After six days, a transaction that hasn't been captured is voided automatically.

Initiating a delayed capture transaction

Initiating a delayed capture transaction is easy: send a request to the Charge endpoint as always, but set the delay_capture parameter to true.

The Tender object included in the returned Transaction will have a status of AUTHORIZED, instead of the usual CAPTURED.

Be sure to save the id of the transaction you've created so you can capture or void it later.

Capturing an authorized transaction

Use the CaptureTransaction endpoint to capture a previouly authorized transaction. On success, the endpoint's response is an empty javascript object, {}.

Voiding an authorized transaction

Use the VoidTransaction endpoint to void a previouly authorized transaction. On success, the endpoint's response is an empty javascript object, {}.

Was this page helpful?