APIs

Create Check Stop Payment

The stopPayment created webhook event will be fired.

Verb	POST
URL	https://api.s.unit.sh/stop-payments
Required Scope	payments-write
Data Type	checkStopPayment
Timeout (Seconds)	5

Attributes

Name	Type	Description
amount Optional	integer	Optional. The amount (in cents) to look on payments to stop.
checkNumber	string	The check number to look on a check payment to stop.
tags Optional	object	Optional. See Tags.
idempotencyKey Optional	string	Optional, but strongly recommended . See Idempotency.

Relationships

Name	Type	Description
account	JSON:API Relationship	The account that payments will be stopped for.

Example Request:

curl -X POST 'https://api.s.unit.sh/stop-payments'
-H 'Content-Type: application/vnd.api+json'
-H 'Authorization: Bearer ${TOKEN}'
--data-raw '{
  "data": {
    "type": "checkStopPayment",
    "attributes": {
      "amount": 23,
      "checkNumber": "006753",
      "tags": {
        "test": "test"
      }
    },
    "relationships": {
      "account": {
        "data": {
          "type": "depositAccount",
          "id": "10002"
        }
      }
    }
  }
}'

Response

Response is a JSON:API document.

201 Created

Name	Type	Description
data	checkStopPayment	The requested resource after the operation was completed.

Example Response:

{
  "type": "checkStopPayment",
  "id": "1",
  "attributes": {
    "createdAt": "2023-02-05T18:32:34.682Z",
    "updatedAt": "2023-02-05T18:32:34.682Z",
    "amount": 21,
    "status": "Active",
    "tags": {
      "test": "test"
    },
    "checkNumber": "006753"
  },
  "relationships": {
    "account": {
      "data": {
        "type": "account",
        "id": "10002"
      }
    },
    "customer": {
      "data": {
        "type": "customer",
        "id": "10005"
      }
    },
    "customers": {
      "data": [
        {
          "type": "customer",
          "id": "10005"
        }
      ]
    },
    "stoppedPayments": {
      "data": [
        {
          "type": "checkPayment",
          "id": "12345"
        }
      ]
    }
  }
}

Create ACH Stop Payment

The stopPayment created webhook event will be fired.

Verb	POST
URL	https://api.s.unit.sh/stop-payments
Required Scope	payments-write
Data Type	achStopPayment
Timeout (Seconds)	5

Attributes

Name	Type	Description
minAmount Optional	integer	Optional. The amount (in cents) above which a payment will be stopped. At least one originatorName or minAmount must be provided.
originatorName Optional	Array of strings	Optional. The name of the originator of the payment to look for in payments to stop. At least one originatorName or minAmount must be provided. See guide for further details.
direction	string	Debit only.
expiration Optional	RFC3339 Date string	Optional. Date only (e.g. "2001-08-15").
isMultiUse Optional	Boolean	Optional. Available only for ACH Stop Payments. False by default.
description	String	Up to 255 characters
tags Optional	object	Optional. See Tags.
idempotencyKey Optional	string	Optional, but strongly recommended . See Idempotency.

Relationships

Name	Type	Description
account	JSON:API Relationship	The account that payments will be stopped for.

Example Request:

curl -X POST 'https://api.s.unit.sh/stop-payments'
-H 'Content-Type: application/vnd.api+json'
-H 'Authorization: Bearer ${TOKEN}'
--data-raw '{
  "data": {
    "type": "achStopPayment",
    "attributes": {
      "minAmount": 5001,
      "originatorName": [
        "Pied Pier",
        "Pied Pier Inc."
      ],
      "direction": "Debit",
      "description": "Stop subscription payments greater than $50 to the gym.",
      "isMultiUse": true,
      "expiration": "2025-07-01",
      "tags": {
        "test": "test"
      }
    },
    "relationships": {
      "account": {
        "data": {
          "type": "depositAccount",
          "id": "10002"
        }
      }
    }
  }
}'

Response

Response is a JSON:API document.

201 Created

Name	Type	Description
data	achStopPayment	The requested resource after the operation was completed.

Example Response:

{
  "type": "achStopPayment",
  "id": "1",
  "attributes": {
    "createdAt": "2024-02-05T18:32:34.682Z",
    "minAmount": 5001,
    "originatorName": [
      "Pied Pieper",
      "Pied Piper Inc."
    ],
    "direction": "Debit",
    "isMultiUse": true,
    "expiration": "2025-02-05",
    "description": "Stop payments greater than $50 to the gym.",
    "status": "Active",
    "tags": {
      "test": "test"
    }
  },
  "relationships": {
    "account": {
      "data": {
        "type": "account",
        "id": "10002"
      }
    },
    "customer": {
      "data": {
        "type": "customer",
        "id": "10005"
      }
    },
    "customers": {
      "data": [
        {
          "type": "customer",
          "id": "10005"
        }
      ]
    }
  }
}

Get by Id

Get a stop payment by id.

Verb	GET
URL	https://api.s.unit.sh/stop-payments/{id}
Required Scope	payments
Timeout (Seconds)	5

Response

Response is a JSON:API document.

200 OK

Name	Type	Description
data	Check Stop Payment	checkStopPayment resource.

curl -X GET 'https://api.s.unit.sh/stop-payments/100' \
-H "Authorization: Bearer ${TOKEN}"

List

List stop payment resources. Filtering, paging and sorting can be applied.

Verb	GET
URL	https://api.s.unit.sh/stop-payments
Required Scope	payments
Timeout (Seconds)	5

Query Parameters

Name	Type	Default	Description
page[limit]	integer	100	Maximum number of resources that will be returned. Maximum is 1000 resources. See Pagination.
page[offset]	integer	0	Number of resources to skip. See Pagination.
filter[accountId]	string	(empty)	Optional. Filters the results by the specified account id.
filter[customerId]	string	(empty)	Optional. Filters the results by the specified customer id.
filter[tags]	Tags (JSON)	(empty)	Optional. Filter stop payments by Tags.
sort	string	sort=-createdAt	Optional. Leave empty or provide sort=createdAt for ascending order. Provide sort=-createdAt (leading minus sign) for descending order.
filter[since]	ISO Local Date string	(empty)	Optional. Filters before the specified date. e.g. 2021-06-01
filter[until]	ISO Local Date string	(empty)	Optional. Filters after the specified date. e.g. 2021-07-01
filter[status][]	string	Active	Optional. Filter by status (Active, Disabled). Usage example: filter[status][0]=Disabled
filter[fromAmount]	Integer	(empty)	Optional. Filters the Check Stop Payments that have an amount that is higher or equal to the specified amount (in cents). e.g. 5000
filter[toAmount]	Integer	(empty)	Optional. Filters the Stop Payments that have an amount that is lower or equal to the specified amount (in cents). e.g. 7000
filter[noAmount]	boolean	(empty)	Optional. If set to true, returns only Stop Payments with no amount . If set to false only returns Stop Payments with amount
filter[fromMinAmount]	Integer	Optional. Filters ACH stop Payments that have minAmount higher than the specified amount (cents).
filter[toMinAmount]	Integer	Optional. Filters ACH stop Payments that have minAmount lower than the specified amount (cents).
filter[noMinAmount]	boolean	(empty)	Optional. If set to true, returns only ACH Stop Payments with no minAmount . If set to false only returns Stop Payments with minAmount
filter[originatorName]	String	Optional.
filter[noOriginatorName]	Boolean	Optional.
filter[checkNumber]	String	(empty)	Optional. Filter Stop Payments by check number (trimming leading zeros).
filter[type]	String	(empty)	Optional. Either checkStopPayment or achStopPayment

curl -X GET 'https://api.s.unit.sh/stop-payments?page[limit]=20&page[offset]=10' \
-H "Authorization: Bearer ${TOKEN}"

Response

Response is a JSON:API document.

200 OK

Name	Type	Description
data	Array of Check Stop Payment	Array of check stop payments resources.

Example Response:

{
  "data": [
    {
      "type": "checkStopPayment",
      "id": "1",
      "attributes": {
        "createdAt": "2023-02-05T18:32:34.682Z",
        "updatedAt": "2023-02-05T18:32:34.682Z",
        "amount": 21,
        "status": "Active",
        "tags": {
          "test": "test"
        },
        "checkNumber": "006753"
      },
      "relationships": {
        "account": {
          "data": {
            "type": "account",
            "id": "10002"
          }
        },
        "customer": {
          "data": {
            "type": "customer",
            "id": "10005"
          }
        },
        "customers": {
          "data": [
            {
              "type": "customer",
              "id": "10005"
            }
          ]
        }
      }
    },
    {
      "type": "checkStopPayment",
      "id": "4",
      "attributes": {
        "createdAt": "2023-02-19T17:16:53.115Z",
        "updatedAt": "2023-02-19T17:16:53.115Z",
        "amount": 23,
        "status": "Active",
        "tags": {
          "test": "test"
        },
        "checkNumber": "006753"
      },
      "relationships": {
        "account": {
          "data": {
            "type": "account",
            "id": "10002"
          }
        },
        "customer": {
          "data": {
            "type": "customer",
            "id": "10005"
          }
        },
        "customers": {
          "data": [
            {
              "type": "customer",
              "id": "10005"
            }
          ]
        }
      }
    }
  ],
  "meta": {
    "pagination": {
      "total": 2,
      "limit": 100,
      "offset": 0
    }
  }
}

Update AchStopPayment

Update an AchStopPayment.

Verb	PATCH
URL	https://api.s.unit.sh/stop-payments/:stopPaymentId
Data Type	achStopPayment
Timeout (Seconds)	5

Attributes

Name	Type	Description
tags Optional	object	Optional. See Updating Tags.
expiration Optional	RFC3339 Date string	Optional. Date only (e.g. "2026-08-15").

curl -X PATCH 'https://api.s.unit.sh/stop-payments/42'
-H 'Content-Type: application/vnd.api+json'
-H 'Authorization: Bearer ${TOKEN}'
--data-raw '{
  "data": {
    "type": "achStopPayment",
    "attributes": {
      "tags": {
        "newTag": "New tag value"
      },
      "expiration": "2025-05-05"
    }
  }
}'

Response

Response is a JSON:API document.

200 OK

Name	Type	Description
data	AchStopPayment	The requested resource after the operation was completed.

Example Response:

{
  "data": {
    "type": "achStopPayment",
    "id": "42",
    "attributes": {
      "createdAt": "2024-02-05T18:32:34.682Z",
      "minAmount": 5001,
      "originatorName": [
        "Pied Pieper",
        "Pied Piper Inc."
      ],
      "direction": "Debit",
      "isMultiUse": true,
      "expiration": "2025-05-05",
      "description": "Stop payments greater than $50 to the gym.",
      "status": "Active",
      "tags": {
        "test": "test",
        "newTag": "New tag value"
      }
    },
    "relationships": {
      "account": {
        "data": {
          "type": "account",
          "id": "10002"
        }
      },
      "customer": {
        "data": {
          "type": "customer",
          "id": "10005"
        }
      },
      "customers": {
        "data": [
          {
            "type": "customer",
            "id": "10005"
          }
        ]
      }
    }
  }
}

Disable Stop Payment

Disable a Stop Payment by id. When a Stop Payment is disabled, the checkStopPayment disabled webhook event is fired and future check payments wont be stopped by this stop payment.

Verb	POST
URL	https://api.s.unit.sh/stop-payments/{id}/disable
Required Scope	payments
Timeout (Seconds)	5

Response

Response is a JSON:API document.

200 OK

Name	Type	Description
data	Check Stop Payment	checkStopPayment resource.

curl -X POST 'https://api.s.unit.sh/stop-payments/12/disable'
-H 'Content-Type: application/vnd.api+json'
-H 'Authorization: Bearer ${TOKEN}'