Skip to content

Register ACH Block

Request

Registers an ACH receiving block on a Pocket. From then on, incoming ACH entries in the block's direction are returned unless one of its filters admits the entry. Blocks can be registered only on Pockets of business customers, in either direction; a request for any other customer is rejected with a 422. A Pocket has at most one active block per direction.

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.

Bodyapplication/jsonrequired
idstring or null(Id)
Any of:

An id you choose for the new resource. A retry with the same id and body returns the resource it created rather than creating another.

string (uuid)
directionstring(Direction)required

The direction of incoming entries the block returns.

Enum:"DEBIT""CREDIT"
curl -i -X POST \
  'https://your-partner-name.sandbox-api.jikoservices.com/api/v2/pockets/{pocket_id}/ach-receiving-blocks/' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'x-jiko-idempotency: 497f6eca-6276-4993-bfeb-53cbbbba6f08' \
  -H 'x-jiko-signature: string' \
  -d '{
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "direction": "DEBIT"
  }'

Responses

Successful Response

Bodyapplication/json
idstring, (uuid)(Id)required
pocket_idstring, (uuid)(Pocket Id)required
directionstring(Direction)required

The direction of incoming entries the block returns.

Enum:"DEBIT""CREDIT"
registered_bystring(Registered By)required

JIKO when Jiko placed it, otherwise the username of the Partner API user that did.

time_createdstring, (date-time)(Time Created)required

When the block was registered and took effect.

filtersArray of objects(Filters)required

The filters that admit entries the block would otherwise return.

Response
{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "pocket_id": "8a7ec6c0-2701-40a1-8954-68870964b50d", "direction": "DEBIT", "registered_by": "partner_user", "time_created": "2026-01-01T12:00:00Z", "filters": [] }