v4

OpenAPI 3.1.02026-08-012402353.8 MB

Create a Pending Transaction

Creates a pending transaction on an account. This can be useful to hold funds for an external payment or known future transaction outside of Increase (only negative amounts are supported). The resulting Pending Transaction will have a category of user_initiated_hold and can be released via the API to unlock the held funds.

post/pending_transactions

Request body

account_idstring required

The Account to place the hold on.

amountinteger required

The amount to hold in the minor unit of the account's currency. For dollars, for example, this is cents. This should be a negative amount: To hold $1.00 from the account, pass -100 as amount.

descriptionstring

The description you choose to give the hold.

Example request

{
  "account_id": "account_in71c4amph0vgo2qllky",
  "amount": -1000,
  "description": "Hold for pending transaction"
}

Response

Pending Transaction

account_idstring required

The identifier for the account this Pending Transaction belongs to.

amountinteger required

The Pending Transaction amount in the minor unit of its currency. For dollars, for example, this is cents. This amount does not change after the Pending Transaction is created. If a card authorization settles for a different amount, the settled amount is available on the resulting Transaction and on the Card Payment's state.settled_amount.

completed_atstring date-time nullable required

The ISO 8601 date on which the Pending Transaction was completed.

created_atstring date-time required

The ISO 8601 date on which the Pending Transaction occurred.

currency'USD' required

The ISO 4217 code for the Pending Transaction's currency. This will match the currency on the Pending Transaction's Account.

descriptionstring required

For a Pending Transaction related to a transfer, this is the description you provide. For a Pending Transaction related to a payment, this is the description the vendor provides.

held_amountinteger required

The amount that this Pending Transaction decrements the available balance of its Account. This is usually the same as amount, but will differ if the amount is positive.

idstring required

The Pending Transaction identifier.

route_idstring nullable required

The identifier for the route this Pending Transaction came through. Routes are things like cards and ACH details.

route_type'account_number' | 'card' | 'lockbox' nullable required

The type of the route this Pending Transaction came through.

status'pending' | 'complete' required

Whether the Pending Transaction has been confirmed and has an associated Transaction.

type'pending_transaction' required

A constant representing the object's type. For this resource it will always be pending_transaction.

Example response

{
  "account_id": "account_in71c4amph0vgo2qllky",
  "amount": -100,
  "completed_at": null,
  "created_at": "2020-01-31T23:59:59Z",
  "currency": "USD",
  "description": "INVOICE 2468",
  "held_amount": -100,
  "id": "pending_transaction_k1sfetcau2qbvjbzgju4",
  "route_id": null,
  "route_type": null,
  "source": {
    "ach_transfer_instruction": {
      "amount": 100,
      "transfer_id": "ach_transfer_uoxatyh3lt5evrsdvo7q"
    },
    "category": "ach_transfer_instruction"
  },
  "status": "pending",
  "type": "pending_transaction"
}