Setting the payment_type parameter to wire, instant, or ach indicates how the failed payment will be retried. Note that only debit payments can be retried using wires. The wire details for this retry attempt are provided in the wire_details object in the first (most recent) payment attempt after the /retry endpoint is called.

Setting the bank_account parameter indicates the failed payment will be retried using a new bank account. Both credits and debits may be retried using a new bank account.

Retry limits: A debit can be attempted by ACH at most three times in total. The original debit counts as the first attempt, and any automatic redebits Check sends count toward the limit along with retries you request, including retries to a different bank account. Once a debit has used all three ACH attempts, an ACH retry returns a 400 error and the debit can only be retried by wire. Wire retries have no limit.

Deprecation Notice: The use_wire parameter has been deprecated in favor of the payment_type field.

If use_wire is provided:

• When true, it is treated as if payment_type="wire" was set.
• If payment_type is also provided, payment_type takes precedence, and use_wire is ignored.

Please update your integrations accordingly.

Note that the can_retry field on the Payment object communicates whether a payment can be retried. We recommend relying on this field to determine whether a retry is possible. A debit that has reached the ACH limit can still show can_retry as true, because a wire retry remains available.