BYbyaccrue
Simulations

Fail Pending Transaction

Fail a pending transaction for a wallet (ACH or card).

Fails a pending transaction either by transaction ID or the first pending transaction if no ID is provided.

An optional failure reason can be specified to simulate different failure scenarios.

This endpoint is only available in development, sandbox, and local testing environments.

post/api/v1/simulation/wallets/{walletId}/fail-transaction

Request

Path parameters

walletIdstring uuid required

Wallet ID

Example:123e4567-e89b-12d3-a456-426614174000

Headers

Client-IDstring uuid required

The unique identifier of the client making the request. This header is required to retrieve the client-specific configuration and ensure that the response is tailored to the client's settings and permissions.

Example:123e4567-e89b-12d3-a456-426614174000
Authorizationstring uuid required

Secure secret to access privileged endpoints.

Example:Bearer 633b336e4f57f095a405f6685e208cc7dd16de3e82494662f2acfeec3af1cdef

Request body

Example request

{
  "data": {
    "attributes": {
      "transactionId": "123e4567-e89b-12d3-a456-426614174000",
      "reason": "InsufficientFunds"
    }
  }
}

Response

No Content - Transaction failed successfully

Changes

No recorded changes to this operation across all 1 revision of this API.