Request Sandbox KeysSee a Demo
  • Overview
    • Quickstart
    • Payments and Disbursements
    • Errors
    • Webhooks
  • Guides
    • Compliance
    • Starter Mode
    • KYC
    • Line of Credit program
    • Buy Now Pay Later program
  • API Reference
LogoLogo
Request Sandbox KeysSee a Demo
API ReferenceFacilities

POST
/facilities/:facility_id/disbursements/:disbursement_id/cancel
POST
/api/facilities/:facility_id/disbursements/:disbursement_id/cancel
1curl -X POST https://production.pier-finance.com/api/facilities/fac_18e5a3726b3943cda2635f40e1041ba4/disbursements/dsb_18e5a3726b3943cda2635f40e1041ba4/cancel \
2     -H "Authorization: Bearer <token>"
Try it
1{
2  "id": "dsb_18e5a3726b3943cda2635f40e1041ba4",
3  "facility_id": "fac_18e5a3726b3943cda2635f40e1041ba4",
4  "amount": 100000,
5  "status": "canceled",
6  "created_on": "2023-02-27T00:00:00Z",
7  "transfer_type": "none",
8  "failure_reason": null,
9  "date": "2023-02-27"
10}
Was this page helpful?
Previous

Refund a disbursement

Next
Built with
Cancels a submitted disbursement before it is sent to the ACH network. Disbursements can only be canceled if they are still in the `pending` state and have not been submitted to the ACH network. After a disbursement is sent to the ACH network, you must wait for the it to settle and then you may refund it instead. In some cases if you cancel while the disbursement is in the process of being submitted to the ACH network you may see a status of `cancellation_pending` in the response. In this case, you can check the status of the disbursement or wait for a subsequent webhook to see if it was successfully canceled or processed.
Cancel a disbursement

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path Parameters

facility_idstringRequired
disbursement_idstringRequired

Response

This endpoint returns an object.
idstring
The id of the disbursement
facility_idstring
amountinteger

The amount of the disbursement, in cents (e.g. 1000 = $10.00)

statusenum
The status of the disbursement
created_ondatetime
Timestamp the disbursement object is created on
transfer_typeenum

The type of transfer that the disbursement was (ACH, ledger only, or special cases like refunds)

Allowed values:
failure_reasonstring or null
A reason for the failure if any exists
datestring or null

The date of the disbursement (YYYY-MM-DD)

Errors

Cancels a submitted disbursement before it is sent to the ACH network. Disbursements can only be canceled if they are still in the pending state and have not been submitted to the ACH network. After a disbursement is sent to the ACH network, you must wait for the it to settle and then you may refund it instead.

In some cases if you cancel while the disbursement is in the process of being submitted to the ACH network you may see a status of cancellation_pending in the response. In this case, you can check the status of the disbursement or wait for a subsequent webhook to see if it was successfully canceled or processed.