Skip to content

ACH Blocks

Use these endpoints to view and manage the ACH receiving blocks on a Pocket. A block returns incoming ACH entries in one direction, DEBIT or CREDIT, unless one of its filters admits the entry. A filter admits entries by the originator's Company ID, up to a maximum amount, or both. An entry is admitted if any one of the block's filters admits it, so a filter with only a maximum amount admits every originator up to that amount. A block has at most one such filter.

Blocks can be registered only on Pockets of business Customers, in either direction. A request for any other Customer is rejected with a 422.

Only active blocks and filters are returned. A block or filter that has been removed, or does not exist, returns 404. Removing a block also removes its filters.

A filter's maximum amount and label cannot be changed. To change them, remove the filter and add a new one. Between the two calls, the entries it admitted are refused.

ACH blocks aren't available by default and must be enabled; contact your Jiko point of contact to learn more. Requests made without them enabled are rejected with a 403.

List ACH Blocks

Request

Returns the active ACH receiving blocks on a Pocket, each with its active filters. A Pocket has at most one active block per direction, so the list is not paginated.

Security
HTTPBearer
Path
pocket_idstring, (uuid)(Pocket Id)required
Headers
x-jiko-idempotencystring, (uuid)(X-Jiko-Idempotency)required

A new UUID that you generate for each request, reads included. It is part of the request signature and prevents replay of a request. A value that was already sent in the last hour is rejected with 409 jiko.errors.DuplicateRequestError, even if the first request failed. When you retry a request, generate a new value and sign the request again.

x-jiko-signaturestring(X-Jiko-Signature)required

Base64-encoded HMAC-SHA256 hash of x-jiko-idempotency + request pathname + body, keyed with your shared secret. See Authentication for the full algorithm and a code sample.

curl -i -X GET \
  'https://your-partner-name.sandbox-api.jikoservices.com/api/v2/pockets/{pocket_id}/ach-receiving-blocks/' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'x-jiko-idempotency: 497f6eca-6276-4993-bfeb-53cbbbba6f08' \
  -H 'x-jiko-signature: string'

Responses

Successful Response

Bodyapplication/json
itemsArray of objects(Items)required
Response
{ "items": [ { … } ] }