***

title: Reissue payouts with the API
subtitle: Reissue a payout transaction with a different payment method
description: >-
Use the Payabli API to reissue a payout transaction when the original payment
method fails or needs to change. Supports reissuing as ACH, check, or virtual
card.
'og:description': >-
Use the Payabli API to reissue a payout transaction when the original payment
method fails or needs to change. Supports reissuing as ACH, check, or virtual
card.
keywords: >-
embedded payments, payment API, REST API, payout reissue, payment method
change, vendor payments, payout processing
slug: guides/pay-out-developer-payouts-reissue
icon: arrows-rotate
area:

* Pay Out
  subArea:
* Payouts
  audience:
* developers

***

<AudienceInfo audiences={['developers']} />

Use the reissue endpoint to create a new payout transaction with a different payment method when the original payout can't be completed. The original and new transactions are linked through their event histories for audit purposes.

<Note>
  The reissue endpoint is for on-demand payouts only. For managed payables, contact the Payabli client success team for help with payouts.
</Note>

## When to reissue

Reissue a payout when:

* A virtual card expires before the vendor redeems it
* An ACH payment is returned by the bank
* You need to switch payment methods (for example, from check to ACH)

Reissuing doesn't cancel the original transaction. It marks it as reissued and creates a new, linked transaction. If the original payment method needs to be stopped (for example, a check), contact Payabli support to initiate a stop payment before reissuing.

## Prerequisites

Before you can reissue a payout, the original transaction must be in **Processing** or **Processed** status.

## Allowed payment method changes

The reissue endpoint doesn't support all payment method combinations. The table below shows which methods you can reissue to, based on the original payment method.

| Original method | Can reissue to           | Notes                                                                                                       |
| --------------- | ------------------------ | ----------------------------------------------------------------------------------------------------------- |
| Virtual card    | Virtual card, ACH, check |                                                                                                             |
| Check           | Check, ACH, virtual card | Contact Payabli support to stop the original check before reissuing.                                        |
| ACH             | ACH, check, virtual card | Only before the [hold period](/guides/pay-out-payables-overview#payout-calculator) ends, or after a return. |
| Same Day ACH    | Cancel only              | Same Day ACH transactions can't be reissued. Cancel them instead.                                           |

## Reissue a payout

Send a POST request to `/api/MoneyOut/reissue` with the original transaction ID as a query parameter and the new payment method in the request body.

The endpoint uses the payment method details you include in the request. It doesn't fall back to the vendor's existing payment methods.

See the [API reference](/developers/api-reference/moneyout/reissue-a-payout-transaction) for full endpoint documentation.

### Reissue as ACH

When reissuing as ACH, you must include all the bank account details in the request body.

<EndpointRequestSnippet endpoint="POST /MoneyOut/reissue" example="ReissueAsACH" />

### Reissue as check

When reissuing as a check, the check is mailed to the vendor's remittance address from the original transaction.

<EndpointRequestSnippet endpoint="POST /MoneyOut/reissue" example="ReissueAsCheck" />

<Warning>
  If you're reissuing a check that was already mailed, contact Payabli support to stop the original check first. The reissue endpoint doesn't automatically stop the original check.
</Warning>

### Reissue as virtual card

When reissuing as a virtual card, Payabli generates a new card and sends it to the vendor's email address.

<EndpointRequestSnippet endpoint="POST /MoneyOut/reissue" example="ReissueAsVCard" />

### Response

A successful reissue returns the new transaction ID and a link back to the original.

<EndpointResponseSnippet endpoint="POST /MoneyOut/reissue" example="ReissueAsACH" />

The new transaction automatically goes through the standard authorize-and-capture flow. You can track its progress using the [Get payout details](/developers/api-reference/moneyout/get-details-for-a-processed-payout-transaction) endpoint with the new `transactionId`.

## Audit trail

When you reissue a transaction, Payabli creates event records on both transactions:

* **Original transaction**: Gets a "Reissued" event linking to the new transaction
* **New transaction**: Gets event records linking back to the original transaction

You can view these links by querying the [Get payout details](/developers/api-reference/moneyout/get-details-for-a-processed-payout-transaction) endpoint and checking the `Events` array in the response.

## Error handling

The reissue endpoint returns HTTP 400 when the transaction can't be reissued. Common causes:

| Cause                                               | Error message                                                                                    |
| --------------------------------------------------- | ------------------------------------------------------------------------------------------------ |
| Transaction isn't in Processing or Processed status | `Bad Request: Transaction must be in Processing or Processed state`                              |
| Transaction doesn't exist                           | `Bad Request: Transaction ID does not exist or is malformed`                                     |
| Missing required ACH fields                         | `Bad Request: Invalid payment method configuration. Missing required field for ACH: {fieldName}` |
| Invalid payment method                              | `Bad Request: Invalid payment method`                                                            |

<Info>
  An HTTP 200 response doesn't always mean the reissue succeeded. Always check the `isSuccess` field in the response body to confirm the result.
</Info>

## Testing considerations

When you integrate this feature, keep these testing considerations in mind:

* Create a payout and advance it to **Processing** or **Processed** status before attempting a reissue.
* Test each payment method type (ACH, check, virtual card) to confirm the request body validation works as expected.
* Verify that the original transaction's status changes to "Reissued" and that both transactions are linked through their events.
* Test error cases: reissuing a transaction in an invalid state, missing required ACH fields, and non-existent transaction IDs.
* If you're using idempotency keys, confirm that duplicate requests with the same key don't create multiple transactions.

## Best practices

Keep these tips in mind when working with the reissue endpoint.

* **Use idempotency keys** in production to prevent duplicate reissues from retry logic. Include the `idempotencyKey` header with a unique value for each reissue attempt.
* **Check transaction status first** by calling the [Get payout details](/developers/api-reference/moneyout/get-details-for-a-processed-payout-transaction) endpoint before attempting a reissue.
* **Stop check payments before reissuing.** The reissue endpoint doesn't cancel the original check automatically.
* **Validate ACH details** before sending. Routing numbers must be exactly 9 digits, and account numbers must be between 8 and 17 digits.

## Related resources

See these related resources to help you get the most out of Payabli.

<AccordionGroup>
  <Accordion title="References">
    * **[Pay Out statuses](/guides/pay-out-status-reference)** - Learn about Pay Out statuses
    * **[Pay Out TransEvent reference](/guides/pay-out-transevents-reference)** - Learn about TransEvent values
  </Accordion>

  <Accordion title="Related topics">
    * **[Manage payouts with the API](/guides/pay-out-developer-payouts-manage)** - Learn how to use the Payabli API to create, capture, and cancel payout transactions
    * **[Audit payout transactions with the API](/guides/pay-out-developer-payouts-audit)** - Learn how to use the Payabli API to track and audit payout transactions
  </Accordion>
</AccordionGroup>