Approve a disbursement
Approve a disbursement in a pending_approval state. If the disbursement is in a different state, this will return a 400 error.
Path parameters
The unique identifier for the disbursement
Headers
Bearer authentication of the form Bearer <token>, where token is your auth token.
Response
The disbursement was approved
The unique identifier for the disbursement
The unique identifier for the organization that will receive the payment
The payment amount in USD cents. Must be a positive amount.
An Organization
represents an operating nonprofit or an operating sub-organization of a parent or sponsoring nonprofit.
The generally accepted identifier for an organization is its domain. This domain provides proof of identity, ownership and relationship to an entity.
Organizations can receive payments from payers on the network.
A description of the disbursement that will be displayed to the receiving organization.
The date and time the disbursement was created
The date and time the disbursement was last updated
The lifecycle status of the disbursement. Possible values include:
pending_approval
: The disbursement is awaiting approval from the grantmakercanceled
: The disbursement was canceled by the grantmakerawaiting_verification
: The disbursement is awaiting verification from Chariotrejected
: The disbursement was rejected by Chariot before being submittedpending_submission
: The disbursement is awaiting submission to the payment networksubmitted
: The disbursement payment has been submitted to the payment network and is being processedstopped
: The disbursement payment was stopped after it was submittedcompleted
: The disbursement payment has been completed and funds have been received by the receiving organizationfailed
: The disbursement payment failed or the receiving organization did not receive the payment
To see a description of each status, see the “Disbursement Lifecycle” section of the Chariot documentation.
If your account requires approvals for disbursements and the disbursement was not approved, this will contain the details of the cancelation.
If your account requires approvals for disbursements and the disbursement was approved, this will contain the details of the approval.
If the disbursement was rejected by Chariot, this will contain details as to why the disbursement was rejected.
The list of transfers for the disbursement. This can have multiple items if the disbursement’s underlying payment was retried multiple times. For example, if a check was returned or stopped and the disbursement was retried as an ACH transfer. If the disbursement was not retried, this will have a single item.
The list of transactions for the disbursement