See also the Transaction response object.
Cloning a transaction will create a new transaction by copying all the attributes, except amount, of the original transaction. Instead of cloning transactions, a better practice in most cases is to use the Vault to save and reuse payment method or customer information.
importantYou must include an amount and an option flag to submit the transaction for settlement.
gateway.transaction.cloneTransaction("transactionId", {
amount: "10.00",
options: {
submitForSettlement: true
}
}, (err, result) => {
});
If the transaction can't be found, it will return a notFoundError
.
Arguments
transactionId
required, String
The unique transaction identifier. You can only clone non-PayPal transactions that have a status of authorized
, authorization_expired
, voided
, submitted_for_settlement
, or settled
. Processor declined, gateway rejected, and failed transactions can't be cloned.
Additional
Parameters
amount
required, String
The amount of the cloned transaction. This value must be greater than 0, and must match the appropriate currency format.
options
required
Values passed with a request.
submitForSettlement
required, bool
Whether to submit the transaction for settlement once authorization succeeds.