Stop Payments
Account Services
>
API Reference
>
v1
>
Stop Payments
Overview
Stop Payments can be placed on accounts to prevent matching transactions from being posted to the account. This includes configuring whether the Stop Type is one-time or recurring. A payee can be added to describe which transactions might be marked as suspects for the Stop Payment. Dates for the Stop can be configured, such as the date it becomes effective for the account, and when it expires. A ten-digit Originator Id or SEC Code can also be added for the suspect transaction.
openapi: 3.0.3
info:
title: Account Services APIs - Stop Payments
version: v1
description: APIs for Account Services
contact:
name: Digital Core @ Jack Henry and Associates, inc.
url: https://www.jackhenry.com/
email: DC-Operations@jackhenry.com
servers:
- url: https://{API_ENDPOINT}
variables:
API_ENDPOINT:
default: digital.garden-fi.com
security:
- bearerAuth: []
tags:
- name: Stop Payments
description: APIs for Stop Payments to Accounts
paths:
/a/api/acct-svcs/v1/{InstitutionUniversalId}/stop-payments:
post:
operationId: CreateStopPayment
tags:
- Stop Payments
summary: API to add a stop payment record on the account.
description: API to add a stop payment record on the account.
parameters:
- name: InstitutionUniversalId
in: path
description: A unique identifier to establish the identity of an Institution/Environment/Brand combination
required: true
schema:
type: string
requestBody:
description: API to add a new stop payment record.
content:
application/json:
schema:
type: object
required:
- accountId
- stopType
- payee
- amount
- reason
properties:
accountId:
description: This attribute defines the account id generated by the system for the account.
type: string
format: uuid
amount:
type: object
properties:
value:
type: string
description: This defines the amount value.
nullable: false
currencyType:
type: string
description: The ISO 4217 three character currency type. USD is the default value.
nullable: true
default: usd
additionalProperties: false
effectiveDate:
type: string
format: date
description: This attribute defines the effective date of the transaction in the stop payment request.
nullable: true
expirationDate:
type: string
format: date
description: This attribute defines the date when the stop payment is no longer active. If the expiration date is left blank, a default expiration date is used.
originatorId:
type: integer
description: This attribute defines a 10-digit unique identifier used to identify the originator of the transaction.
example: 1234567890
nullable: true
originatorSecCode:
type: string
description: This attribute defines the type of ACH transaction a stop payment is being place on. This can include PPD (personal payment/debit), CCD (commercial cash concentration/disbursement), etc.
maxLength: 3
nullable: true
payee:
type: string
description: This attribute defines the originator of the transaction.
maxLength: 25
reason:
type: string
description: This attribute defines the reason for the stop payment request.
maxLength: 50
stopType:
type: string
description: This enum attribute defines the type of transaction to stop.
enum:
- one_time
- recurring
additionalProperties: false
responses:
'201':
description: Success - Created
content:
application/json:
schema:
type: object
required:
- id
properties:
id:
type: string
format: uuid
description: This attribute defines the Id generated by the system for the stop payment.
additionalProperties: false
'400':
description: The server could not process the request due to an invalid request.
content:
application/problem+json:
schema:
type: object
required:
- type
- title
- details
properties:
type:
description: A string path which uniquely classifies the domain of the error.
type: string
nullable: false
example: jackhenry/operation-failed
title:
description: A end-user readable string title of the error type.
nullable: false
type: string
details:
description: An array of end-user readable strings which provide additional details for the error message.
type: array
nullable: false
items:
type: string
fieldDetails:
type: array
description: An array of objects which provide additional details to specific fields in the request that caused the error.
items:
type: object
properties:
field:
type: string
description: The name or path of the field in the request that caused the error.
detail:
type: string
description: A end-user readable message describing the error related to the field.
data:
type: object
description: |
Additional data that could be useful to a developer or for handing the error programmatically. The schema for the data in this object is intentionally left undefined.
nullable: true
examples:
badRequest:
summary: Bad request
value:
type: acct-svcs/bad-request
title: Rule violation
details:
- exampleField is invalid or malformed.
fieldDetails:
- field: exampleField
detail: Provide a valid value for this field.
'401':
description: Although the HTTP standard specifies "unauthorized", semantically this response means "unauthenticated". That is, the client must authenticate itself to get the requested response.
'403':
description: The client does not have access rights to the content; that is, it is unauthorized, so the server is refusing to give the requested resource. Unlike 401, the clients identity is known to the server.
'404':
description: The server can not find the requested resource. In an API, this can also mean that the endpoint is valid but the resource itself does not exist. Servers may also send this response instead of 403 to hide the existence of a resource from an unauthorized client.
'500':
description: An unexpected internal server error occurred while processing the request.
content:
application/problem+json:
schema:
type: object
required:
- type
- title
- details
properties:
type:
description: A string path which uniquely classifies the domain of the error.
type: string
nullable: false
example: jackhenry/operation-failed
title:
description: A end-user readable string title of the error type.
nullable: false
type: string
details:
description: An array of end-user readable strings which provide additional details for the error message.
type: array
nullable: false
items:
type: string
data:
type: object
description: |
Additional data that could be useful to a developer or for handing the error programmatically. The schema for the data in this object is intentionally left undefined.
nullable: true
examples:
internalServerError:
summary: Internal server error
value:
type: acct-svcs/internal-server-error
title: Unexpected error
details:
- An unexpected error occurred. Please contact your service provider and/or try again later.
/a/api/acct-svcs/v1/{InstitutionUniversalId}/enterprise/{EnterpriseUserId}/stop-payments:
post:
operationId: CreateStopPaymentWithEnterpriseUserId
tags:
- Stop Payments
summary: API to add a stop payment record on the account.
description: API to add a stop payment record on the account.
parameters:
- name: InstitutionUniversalId
in: path
description: A unique identifier to establish the identity of an Institution/Environment/Brand combination
required: true
schema:
type: string
- in: path
name: EnterpriseUserId
required: true
schema:
type: string
format: uuid
description: The ID of the enterprise user.
requestBody:
description: API to add a new stop payment record.
content:
application/json:
schema:
type: object
required:
- accountId
- stopType
- payee
- amount
- reason
properties:
accountId:
description: This attribute defines the account id generated by the system for the account.
type: string
format: uuid
amount:
type: object
properties:
value:
type: string
description: This defines the amount value.
nullable: false
currencyType:
type: string
description: The ISO 4217 three character currency type. USD is the default value.
nullable: true
default: usd
additionalProperties: false
effectiveDate:
type: string
format: date
description: This attribute defines the effective date of the transaction in the stop payment request.
nullable: true
expirationDate:
type: string
format: date
description: This attribute defines the date when the stop payment is no longer active. If the expiration date is left blank, a default expiration date is used.
originatorId:
type: integer
description: This attribute defines a 10-digit unique identifier used to identify the originator of the transaction.
example: 1234567890
nullable: true
originatorSecCode:
type: string
description: This attribute defines the type of ACH transaction a stop payment is being place on. This can include PPD (personal payment/debit), CCD (commercial cash concentration/disbursement), etc.
maxLength: 3
nullable: true
payee:
type: string
description: This attribute defines the originator of the transaction.
maxLength: 25
reason:
type: string
description: This attribute defines the reason for the stop payment request.
maxLength: 50
stopType:
type: string
description: This enum attribute defines the type of transaction to stop.
enum:
- one_time
- recurring
additionalProperties: false
responses:
'201':
description: Success - Created
content:
application/json:
schema:
type: object
required:
- id
properties:
id:
type: string
format: uuid
description: This attribute defines the Id generated by the system for the stop payment.
additionalProperties: false
'400':
description: The server could not process the request due to an invalid request.
content:
application/problem+json:
schema:
type: object
required:
- type
- title
- details
properties:
type:
description: A string path which uniquely classifies the domain of the error.
type: string
nullable: false
example: jackhenry/operation-failed
title:
description: A end-user readable string title of the error type.
nullable: false
type: string
details:
description: An array of end-user readable strings which provide additional details for the error message.
type: array
nullable: false
items:
type: string
fieldDetails:
type: array
description: An array of objects which provide additional details to specific fields in the request that caused the error.
items:
type: object
properties:
field:
type: string
description: The name or path of the field in the request that caused the error.
detail:
type: string
description: A end-user readable message describing the error related to the field.
data:
type: object
description: |
Additional data that could be useful to a developer or for handing the error programmatically. The schema for the data in this object is intentionally left undefined.
nullable: true
examples:
badRequest:
summary: Bad request
value:
type: acct-svcs/bad-request
title: Rule violation
details:
- exampleField is invalid or malformed.
fieldDetails:
- field: exampleField
detail: Provide a valid value for this field.
'401':
description: Although the HTTP standard specifies "unauthorized", semantically this response means "unauthenticated". That is, the client must authenticate itself to get the requested response.
'403':
description: The client does not have access rights to the content; that is, it is unauthorized, so the server is refusing to give the requested resource. Unlike 401, the clients identity is known to the server.
'404':
description: The server can not find the requested resource. In an API, this can also mean that the endpoint is valid but the resource itself does not exist. Servers may also send this response instead of 403 to hide the existence of a resource from an unauthorized client.
'500':
description: An unexpected internal server error occurred while processing the request.
content:
application/problem+json:
schema:
type: object
required:
- type
- title
- details
properties:
type:
description: A string path which uniquely classifies the domain of the error.
type: string
nullable: false
example: jackhenry/operation-failed
title:
description: A end-user readable string title of the error type.
nullable: false
type: string
details:
description: An array of end-user readable strings which provide additional details for the error message.
type: array
nullable: false
items:
type: string
data:
type: object
description: |
Additional data that could be useful to a developer or for handing the error programmatically. The schema for the data in this object is intentionally left undefined.
nullable: true
examples:
internalServerError:
summary: Internal server error
value:
type: acct-svcs/internal-server-error
title: Unexpected error
details:
- An unexpected error occurred. Please contact your service provider and/or try again later.
/a/api/acct-svcs/v1/{InstitutionUniversalId}/stop-payments/{Id}:
get:
operationId: GetStopPayment
tags:
- Stop Payments
summary: API to retrieve a stop payment record with a key.
description: API to retrieve stop payment information by stop payment identifier.
parameters:
- name: InstitutionUniversalId
in: path
description: A unique identifier to establish the identity of an Institution/Environment/Brand combination
required: true
schema:
type: string
- name: Id
in: path
description: The Stop Payment Identifier.
required: true
schema:
type: string
format: uuid
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
required:
- accountId
- accountNumber
- accountType
properties:
id:
type: string
format: uuid
description: This attribute defines the Id generated by the system for the stop payment.
accountId:
description: This attribute defines the account id generated by the system for the account.
type: string
format: uuid
accountNumber:
description: This attribute defines the account number on which stop payment exists.
type: string
nullable: false
maxLength: 34
accountType:
type: string
description: This enum attribute defines the account type.
enum:
- checking
- savings
accountTypeDisplay:
type: string
description: This attribute defines the display value for the associated enum.
nullable: false
amount:
type: object
properties:
value:
type: string
description: This defines the amount value.
nullable: false
currencyType:
type: string
description: The ISO 4217 three character currency type. USD is the default value.
nullable: true
default: usd
additionalProperties: false
effectiveDate:
type: string
format: date
description: This attribute defines the effective date of the transaction in the stop payment request.
nullable: true
expirationDate:
type: string
format: date
description: This attribute defines the date when the stop payment is no longer active. If the expiration date is left blank, a default expiration date is used.
originatorId:
type: integer
description: This attribute defines a 10-digit unique identifier used to identify the originator of the transaction.
example: 1234567890
nullable: true
originatorSecCode:
type: string
description: This attribute defines the type of ACH transaction a stop payment is being place on. This can include PPD (personal payment/debit), CCD (commercial cash concentration/disbursement), etc.
maxLength: 3
nullable: true
payee:
type: string
description: This attribute defines the originator of the transaction.
maxLength: 25
reason:
type: string
description: This attribute defines the reason for the stop payment request.
maxLength: 50
stopType:
type: string
description: This enum attribute defines the type of transaction to stop.
enum:
- one_time
- recurring
stopTypeDisplay:
type: string
description: This attribute defines the display value for the associated enum.
nullable: false
additionalProperties: false
'400':
description: The server could not process the request due to an invalid request.
content:
application/problem+json:
schema:
type: object
required:
- type
- title
- details
properties:
type:
description: A string path which uniquely classifies the domain of the error.
type: string
nullable: false
example: jackhenry/operation-failed
title:
description: A end-user readable string title of the error type.
nullable: false
type: string
details:
description: An array of end-user readable strings which provide additional details for the error message.
type: array
nullable: false
items:
type: string
fieldDetails:
type: array
description: An array of objects which provide additional details to specific fields in the request that caused the error.
items:
type: object
properties:
field:
type: string
description: The name or path of the field in the request that caused the error.
detail:
type: string
description: A end-user readable message describing the error related to the field.
data:
type: object
description: |
Additional data that could be useful to a developer or for handing the error programmatically. The schema for the data in this object is intentionally left undefined.
nullable: true
examples:
badRequest:
summary: Bad request
value:
type: acct-svcs/bad-request
title: Rule violation
details:
- exampleField is invalid or malformed.
fieldDetails:
- field: exampleField
detail: Provide a valid value for this field.
'401':
description: Although the HTTP standard specifies "unauthorized", semantically this response means "unauthenticated". That is, the client must authenticate itself to get the requested response.
'403':
description: The client does not have access rights to the content; that is, it is unauthorized, so the server is refusing to give the requested resource. Unlike 401, the clients identity is known to the server.
'404':
description: The server can not find the requested resource. In an API, this can also mean that the endpoint is valid but the resource itself does not exist. Servers may also send this response instead of 403 to hide the existence of a resource from an unauthorized client.
'500':
description: An unexpected internal server error occurred while processing the request.
content:
application/problem+json:
schema:
type: object
required:
- type
- title
- details
properties:
type:
description: A string path which uniquely classifies the domain of the error.
type: string
nullable: false
example: jackhenry/operation-failed
title:
description: A end-user readable string title of the error type.
nullable: false
type: string
details:
description: An array of end-user readable strings which provide additional details for the error message.
type: array
nullable: false
items:
type: string
data:
type: object
description: |
Additional data that could be useful to a developer or for handing the error programmatically. The schema for the data in this object is intentionally left undefined.
nullable: true
examples:
internalServerError:
summary: Internal server error
value:
type: acct-svcs/internal-server-error
title: Unexpected error
details:
- An unexpected error occurred. Please contact your service provider and/or try again later.
put:
operationId: UpdateStopPayment
tags:
- Stop Payments
summary: API to update a stop payment record with a key.
description: API to update stop payment record by stop payment identifier.
parameters:
- name: InstitutionUniversalId
in: path
description: A unique identifier to establish the identity of an Institution/Environment/Brand combination
required: true
schema:
type: string
- name: Id
in: path
description: The Stop Payment Identifier.
required: true
schema:
type: string
format: uuid
requestBody:
description: The stop payment to be updated
content:
application/json:
schema:
type: object
required:
- stopType
- payee
- amount
- reason
properties:
amount:
type: object
properties:
value:
type: string
description: This defines the amount value.
nullable: false
currencyType:
type: string
description: The ISO 4217 three character currency type. USD is the default value.
nullable: true
default: usd
additionalProperties: false
effectiveDate:
type: string
format: date
description: This attribute defines the effective date of the transaction in the stop payment request.
nullable: true
expirationDate:
type: string
format: date
description: This attribute defines the date when the stop payment is no longer active. If the expiration date is left blank, a default expiration date is used.
originatorId:
type: integer
description: This attribute defines a 10-digit unique identifier used to identify the originator of the transaction.
example: 1234567890
nullable: true
originatorSecCode:
type: string
description: This attribute defines the type of ACH transaction a stop payment is being place on. This can include PPD (personal payment/debit), CCD (commercial cash concentration/disbursement), etc.
maxLength: 3
nullable: true
payee:
type: string
description: This attribute defines the originator of the transaction.
maxLength: 25
reason:
type: string
description: This attribute defines the reason for the stop payment request.
maxLength: 50
stopType:
type: string
description: This enum attribute defines the type of transaction to stop.
enum:
- one_time
- recurring
additionalProperties: false
responses:
'204':
description: Success - No Content
'400':
description: The server could not process the request due to an invalid request.
content:
application/problem+json:
schema:
type: object
required:
- type
- title
- details
properties:
type:
description: A string path which uniquely classifies the domain of the error.
type: string
nullable: false
example: jackhenry/operation-failed
title:
description: A end-user readable string title of the error type.
nullable: false
type: string
details:
description: An array of end-user readable strings which provide additional details for the error message.
type: array
nullable: false
items:
type: string
fieldDetails:
type: array
description: An array of objects which provide additional details to specific fields in the request that caused the error.
items:
type: object
properties:
field:
type: string
description: The name or path of the field in the request that caused the error.
detail:
type: string
description: A end-user readable message describing the error related to the field.
data:
type: object
description: |
Additional data that could be useful to a developer or for handing the error programmatically. The schema for the data in this object is intentionally left undefined.
nullable: true
examples:
badRequest:
summary: Bad request
value:
type: acct-svcs/bad-request
title: Rule violation
details:
- exampleField is invalid or malformed.
fieldDetails:
- field: exampleField
detail: Provide a valid value for this field.
'401':
description: Although the HTTP standard specifies "unauthorized", semantically this response means "unauthenticated". That is, the client must authenticate itself to get the requested response.
'403':
description: The client does not have access rights to the content; that is, it is unauthorized, so the server is refusing to give the requested resource. Unlike 401, the clients identity is known to the server.
'404':
description: The server can not find the requested resource. In an API, this can also mean that the endpoint is valid but the resource itself does not exist. Servers may also send this response instead of 403 to hide the existence of a resource from an unauthorized client.
'500':
description: An unexpected internal server error occurred while processing the request.
content:
application/problem+json:
schema:
type: object
required:
- type
- title
- details
properties:
type:
description: A string path which uniquely classifies the domain of the error.
type: string
nullable: false
example: jackhenry/operation-failed
title:
description: A end-user readable string title of the error type.
nullable: false
type: string
details:
description: An array of end-user readable strings which provide additional details for the error message.
type: array
nullable: false
items:
type: string
data:
type: object
description: |
Additional data that could be useful to a developer or for handing the error programmatically. The schema for the data in this object is intentionally left undefined.
nullable: true
examples:
internalServerError:
summary: Internal server error
value:
type: acct-svcs/internal-server-error
title: Unexpected error
details:
- An unexpected error occurred. Please contact your service provider and/or try again later.
delete:
operationId: DeleteStopPayment
tags:
- Stop Payments
summary: API to delete a stop payment record with a key.
description: API to delete a stop payment record by stop payment identifier.
parameters:
- name: InstitutionUniversalId
in: path
description: A unique identifier to establish the identity of an Institution/Environment/Brand combination
required: true
schema:
type: string
- name: Id
in: path
description: The Stop Payment Identifier.
required: true
schema:
type: string
format: uuid
responses:
'204':
description: Success - No Content
'400':
description: The server could not process the request due to an invalid request.
content:
application/problem+json:
schema:
type: object
required:
- type
- title
- details
properties:
type:
description: A string path which uniquely classifies the domain of the error.
type: string
nullable: false
example: jackhenry/operation-failed
title:
description: A end-user readable string title of the error type.
nullable: false
type: string
details:
description: An array of end-user readable strings which provide additional details for the error message.
type: array
nullable: false
items:
type: string
fieldDetails:
type: array
description: An array of objects which provide additional details to specific fields in the request that caused the error.
items:
type: object
properties:
field:
type: string
description: The name or path of the field in the request that caused the error.
detail:
type: string
description: A end-user readable message describing the error related to the field.
data:
type: object
description: |
Additional data that could be useful to a developer or for handing the error programmatically. The schema for the data in this object is intentionally left undefined.
nullable: true
examples:
badRequest:
summary: Bad request
value:
type: acct-svcs/bad-request
title: Rule violation
details:
- exampleField is invalid or malformed.
fieldDetails:
- field: exampleField
detail: Provide a valid value for this field.
'401':
description: Although the HTTP standard specifies "unauthorized", semantically this response means "unauthenticated". That is, the client must authenticate itself to get the requested response.
'403':
description: The client does not have access rights to the content; that is, it is unauthorized, so the server is refusing to give the requested resource. Unlike 401, the clients identity is known to the server.
'404':
description: The server can not find the requested resource. In an API, this can also mean that the endpoint is valid but the resource itself does not exist. Servers may also send this response instead of 403 to hide the existence of a resource from an unauthorized client.
'500':
description: An unexpected internal server error occurred while processing the request.
content:
application/problem+json:
schema:
type: object
required:
- type
- title
- details
properties:
type:
description: A string path which uniquely classifies the domain of the error.
type: string
nullable: false
example: jackhenry/operation-failed
title:
description: A end-user readable string title of the error type.
nullable: false
type: string
details:
description: An array of end-user readable strings which provide additional details for the error message.
type: array
nullable: false
items:
type: string
data:
type: object
description: |
Additional data that could be useful to a developer or for handing the error programmatically. The schema for the data in this object is intentionally left undefined.
nullable: true
examples:
internalServerError:
summary: Internal server error
value:
type: acct-svcs/internal-server-error
title: Unexpected error
details:
- An unexpected error occurred. Please contact your service provider and/or try again later.
/a/api/acct-svcs/v1/{InstitutionUniversalId}/enterprise/{EnterpriseUserId}/stop-payments/{Id}:
get:
operationId: GetStopPaymentWithEnterpriseUserId
tags:
- Stop Payments
summary: API to retrieve a stop payment record with a key.
description: API to retrieve stop payment information by stop payment identifier.
parameters:
- name: InstitutionUniversalId
in: path
description: A unique identifier to establish the identity of an Institution/Environment/Brand combination
required: true
schema:
type: string
- in: path
name: EnterpriseUserId
required: true
schema:
type: string
format: uuid
description: The ID of the enterprise user.
- name: Id
in: path
description: The Stop Payment Identifier.
required: true
schema:
type: string
format: uuid
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
required:
- accountId
- accountNumber
- accountType
properties:
id:
type: string
format: uuid
description: This attribute defines the Id generated by the system for the stop payment.
accountId:
description: This attribute defines the account id generated by the system for the account.
type: string
format: uuid
accountNumber:
description: This attribute defines the account number on which stop payment exists.
type: string
nullable: false
maxLength: 34
accountType:
type: string
description: This enum attribute defines the account type.
enum:
- checking
- savings
accountTypeDisplay:
type: string
description: This attribute defines the display value for the associated enum.
nullable: false
amount:
type: object
properties:
value:
type: string
description: This defines the amount value.
nullable: false
currencyType:
type: string
description: The ISO 4217 three character currency type. USD is the default value.
nullable: true
default: usd
additionalProperties: false
effectiveDate:
type: string
format: date
description: This attribute defines the effective date of the transaction in the stop payment request.
nullable: true
expirationDate:
type: string
format: date
description: This attribute defines the date when the stop payment is no longer active. If the expiration date is left blank, a default expiration date is used.
originatorId:
type: integer
description: This attribute defines a 10-digit unique identifier used to identify the originator of the transaction.
example: 1234567890
nullable: true
originatorSecCode:
type: string
description: This attribute defines the type of ACH transaction a stop payment is being place on. This can include PPD (personal payment/debit), CCD (commercial cash concentration/disbursement), etc.
maxLength: 3
nullable: true
payee:
type: string
description: This attribute defines the originator of the transaction.
maxLength: 25
reason:
type: string
description: This attribute defines the reason for the stop payment request.
maxLength: 50
stopType:
type: string
description: This enum attribute defines the type of transaction to stop.
enum:
- one_time
- recurring
stopTypeDisplay:
type: string
description: This attribute defines the display value for the associated enum.
nullable: false
additionalProperties: false
'400':
description: The server could not process the request due to an invalid request.
content:
application/problem+json:
schema:
type: object
required:
- type
- title
- details
properties:
type:
description: A string path which uniquely classifies the domain of the error.
type: string
nullable: false
example: jackhenry/operation-failed
title:
description: A end-user readable string title of the error type.
nullable: false
type: string
details:
description: An array of end-user readable strings which provide additional details for the error message.
type: array
nullable: false
items:
type: string
fieldDetails:
type: array
description: An array of objects which provide additional details to specific fields in the request that caused the error.
items:
type: object
properties:
field:
type: string
description: The name or path of the field in the request that caused the error.
detail:
type: string
description: A end-user readable message describing the error related to the field.
data:
type: object
description: |
Additional data that could be useful to a developer or for handing the error programmatically. The schema for the data in this object is intentionally left undefined.
nullable: true
examples:
badRequest:
summary: Bad request
value:
type: acct-svcs/bad-request
title: Rule violation
details:
- exampleField is invalid or malformed.
fieldDetails:
- field: exampleField
detail: Provide a valid value for this field.
'401':
description: Although the HTTP standard specifies "unauthorized", semantically this response means "unauthenticated". That is, the client must authenticate itself to get the requested response.
'403':
description: The client does not have access rights to the content; that is, it is unauthorized, so the server is refusing to give the requested resource. Unlike 401, the clients identity is known to the server.
'404':
description: The server can not find the requested resource. In an API, this can also mean that the endpoint is valid but the resource itself does not exist. Servers may also send this response instead of 403 to hide the existence of a resource from an unauthorized client.
'500':
description: An unexpected internal server error occurred while processing the request.
content:
application/problem+json:
schema:
type: object
required:
- type
- title
- details
properties:
type:
description: A string path which uniquely classifies the domain of the error.
type: string
nullable: false
example: jackhenry/operation-failed
title:
description: A end-user readable string title of the error type.
nullable: false
type: string
details:
description: An array of end-user readable strings which provide additional details for the error message.
type: array
nullable: false
items:
type: string
data:
type: object
description: |
Additional data that could be useful to a developer or for handing the error programmatically. The schema for the data in this object is intentionally left undefined.
nullable: true
examples:
internalServerError:
summary: Internal server error
value:
type: acct-svcs/internal-server-error
title: Unexpected error
details:
- An unexpected error occurred. Please contact your service provider and/or try again later.
put:
operationId: UpdateStopPaymentWithEnterpriseUserId
tags:
- Stop Payments
summary: API to update a stop payment record with a key.
description: API to update stop payment record by stop payment identifier.
parameters:
- name: InstitutionUniversalId
in: path
description: A unique identifier to establish the identity of an Institution/Environment/Brand combination
required: true
schema:
type: string
- in: path
name: EnterpriseUserId
required: true
schema:
type: string
format: uuid
description: The ID of the enterprise user.
- name: Id
in: path
description: The Stop Payment Identifier.
required: true
schema:
type: string
format: uuid
requestBody:
description: The stop payment to be updated
content:
application/json:
schema:
type: object
required:
- stopType
- payee
- amount
- reason
properties:
amount:
type: object
properties:
value:
type: string
description: This defines the amount value.
nullable: false
currencyType:
type: string
description: The ISO 4217 three character currency type. USD is the default value.
nullable: true
default: usd
additionalProperties: false
effectiveDate:
type: string
format: date
description: This attribute defines the effective date of the transaction in the stop payment request.
nullable: true
expirationDate:
type: string
format: date
description: This attribute defines the date when the stop payment is no longer active. If the expiration date is left blank, a default expiration date is used.
originatorId:
type: integer
description: This attribute defines a 10-digit unique identifier used to identify the originator of the transaction.
example: 1234567890
nullable: true
originatorSecCode:
type: string
description: This attribute defines the type of ACH transaction a stop payment is being place on. This can include PPD (personal payment/debit), CCD (commercial cash concentration/disbursement), etc.
maxLength: 3
nullable: true
payee:
type: string
description: This attribute defines the originator of the transaction.
maxLength: 25
reason:
type: string
description: This attribute defines the reason for the stop payment request.
maxLength: 50
stopType:
type: string
description: This enum attribute defines the type of transaction to stop.
enum:
- one_time
- recurring
additionalProperties: false
responses:
'204':
description: Success - No Content
'400':
description: The server could not process the request due to an invalid request.
content:
application/problem+json:
schema:
type: object
required:
- type
- title
- details
properties:
type:
description: A string path which uniquely classifies the domain of the error.
type: string
nullable: false
example: jackhenry/operation-failed
title:
description: A end-user readable string title of the error type.
nullable: false
type: string
details:
description: An array of end-user readable strings which provide additional details for the error message.
type: array
nullable: false
items:
type: string
fieldDetails:
type: array
description: An array of objects which provide additional details to specific fields in the request that caused the error.
items:
type: object
properties:
field:
type: string
description: The name or path of the field in the request that caused the error.
detail:
type: string
description: A end-user readable message describing the error related to the field.
data:
type: object
description: |
Additional data that could be useful to a developer or for handing the error programmatically. The schema for the data in this object is intentionally left undefined.
nullable: true
examples:
badRequest:
summary: Bad request
value:
type: acct-svcs/bad-request
title: Rule violation
details:
- exampleField is invalid or malformed.
fieldDetails:
- field: exampleField
detail: Provide a valid value for this field.
'401':
description: Although the HTTP standard specifies "unauthorized", semantically this response means "unauthenticated". That is, the client must authenticate itself to get the requested response.
'403':
description: The client does not have access rights to the content; that is, it is unauthorized, so the server is refusing to give the requested resource. Unlike 401, the clients identity is known to the server.
'404':
description: The server can not find the requested resource. In an API, this can also mean that the endpoint is valid but the resource itself does not exist. Servers may also send this response instead of 403 to hide the existence of a resource from an unauthorized client.
'500':
description: An unexpected internal server error occurred while processing the request.
content:
application/problem+json:
schema:
type: object
required:
- type
- title
- details
properties:
type:
description: A string path which uniquely classifies the domain of the error.
type: string
nullable: false
example: jackhenry/operation-failed
title:
description: A end-user readable string title of the error type.
nullable: false
type: string
details:
description: An array of end-user readable strings which provide additional details for the error message.
type: array
nullable: false
items:
type: string
data:
type: object
description: |
Additional data that could be useful to a developer or for handing the error programmatically. The schema for the data in this object is intentionally left undefined.
nullable: true
examples:
internalServerError:
summary: Internal server error
value:
type: acct-svcs/internal-server-error
title: Unexpected error
details:
- An unexpected error occurred. Please contact your service provider and/or try again later.
delete:
operationId: DeleteStopPaymentWithEnterpriseUserId
tags:
- Stop Payments
summary: API to delete a stop payment record with a key.
description: API to delete a stop payment record by stop payment identifier.
parameters:
- name: InstitutionUniversalId
in: path
description: A unique identifier to establish the identity of an Institution/Environment/Brand combination
required: true
schema:
type: string
- in: path
name: EnterpriseUserId
required: true
schema:
type: string
format: uuid
description: The ID of the enterprise user.
- name: Id
in: path
description: The Stop Payment Identifier.
required: true
schema:
type: string
format: uuid
responses:
'204':
description: Success - No Content
'400':
description: The server could not process the request due to an invalid request.
content:
application/problem+json:
schema:
type: object
required:
- type
- title
- details
properties:
type:
description: A string path which uniquely classifies the domain of the error.
type: string
nullable: false
example: jackhenry/operation-failed
title:
description: A end-user readable string title of the error type.
nullable: false
type: string
details:
description: An array of end-user readable strings which provide additional details for the error message.
type: array
nullable: false
items:
type: string
fieldDetails:
type: array
description: An array of objects which provide additional details to specific fields in the request that caused the error.
items:
type: object
properties:
field:
type: string
description: The name or path of the field in the request that caused the error.
detail:
type: string
description: A end-user readable message describing the error related to the field.
data:
type: object
description: |
Additional data that could be useful to a developer or for handing the error programmatically. The schema for the data in this object is intentionally left undefined.
nullable: true
examples:
badRequest:
summary: Bad request
value:
type: acct-svcs/bad-request
title: Rule violation
details:
- exampleField is invalid or malformed.
fieldDetails:
- field: exampleField
detail: Provide a valid value for this field.
'401':
description: Although the HTTP standard specifies "unauthorized", semantically this response means "unauthenticated". That is, the client must authenticate itself to get the requested response.
'403':
description: The client does not have access rights to the content; that is, it is unauthorized, so the server is refusing to give the requested resource. Unlike 401, the clients identity is known to the server.
'404':
description: The server can not find the requested resource. In an API, this can also mean that the endpoint is valid but the resource itself does not exist. Servers may also send this response instead of 403 to hide the existence of a resource from an unauthorized client.
'500':
description: An unexpected internal server error occurred while processing the request.
content:
application/problem+json:
schema:
type: object
required:
- type
- title
- details
properties:
type:
description: A string path which uniquely classifies the domain of the error.
type: string
nullable: false
example: jackhenry/operation-failed
title:
description: A end-user readable string title of the error type.
nullable: false
type: string
details:
description: An array of end-user readable strings which provide additional details for the error message.
type: array
nullable: false
items:
type: string
data:
type: object
description: |
Additional data that could be useful to a developer or for handing the error programmatically. The schema for the data in this object is intentionally left undefined.
nullable: true
examples:
internalServerError:
summary: Internal server error
value:
type: acct-svcs/internal-server-error
title: Unexpected error
details:
- An unexpected error occurred. Please contact your service provider and/or try again later.
/a/api/acct-svcs/v1/{InstitutionUniversalId}/stop-payments/search:
post:
operationId: SearchStopPayment
tags:
- Stop Payments
summary: API to search for stop payments.
description: API to search for stop payments.
parameters:
- name: InstitutionUniversalId
in: path
description: A unique identifier to establish the identity of an Institution/Environment/Brand combination
required: true
schema:
type: string
- schema:
type: string
default: '0'
name: Offset
in: query
required: false
description: |
When returning a list of results, the offset determines the number of records to skip before returning the result. If the offset is not provided, the server will return the first set of records.
Example: `.../resource?Offset=50`
- schema:
type: string
default: '10'
name: Count
in: query
required: false
description: |
The count of records requested. The server may limit the number of records returned in a single response. If the count is not provided, the server will return a default number of records.
Example: `.../resource?Count=100`'
requestBody:
description: Request parameters
content:
application/json:
schema:
type: object
properties:
stopType:
type: string
description: This enum attribute defines the type of transaction to stop.
enum:
- one_time
- recurring
accountId:
description: This attribute defines the account id generated by the system for the account.
type: string
format: uuid
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
properties:
stopPayments:
type: array
items:
type: object
required:
- accountId
- accountNumber
- accountType
properties:
id:
type: string
format: uuid
description: This attribute defines the Id generated by the system for the stop payment.
accountId:
description: This attribute defines the account id generated by the system for the account.
type: string
format: uuid
accountNumber:
description: This attribute defines the account number on which stop payment exists.
type: string
nullable: false
maxLength: 34
accountType:
type: string
description: This enum attribute defines the account type.
enum:
- checking
- savings
accountTypeDisplay:
type: string
description: This attribute defines the display value for the associated enum.
nullable: false
amount:
type: object
properties:
value:
type: string
description: This defines the amount value.
nullable: false
currencyType:
type: string
description: The ISO 4217 three character currency type. USD is the default value.
nullable: true
default: usd
additionalProperties: false
effectiveDate:
type: string
format: date
description: This attribute defines the effective date of the transaction in the stop payment request.
nullable: true
expirationDate:
type: string
format: date
description: This attribute defines the date when the stop payment is no longer active. If the expiration date is left blank, a default expiration date is used.
originatorId:
type: integer
description: This attribute defines a 10-digit unique identifier used to identify the originator of the transaction.
example: 1234567890
nullable: true
originatorSecCode:
type: string
description: This attribute defines the type of ACH transaction a stop payment is being place on. This can include PPD (personal payment/debit), CCD (commercial cash concentration/disbursement), etc.
maxLength: 3
nullable: true
payee:
type: string
description: This attribute defines the originator of the transaction.
maxLength: 25
reason:
type: string
description: This attribute defines the reason for the stop payment request.
maxLength: 50
stopType:
type: string
description: This enum attribute defines the type of transaction to stop.
enum:
- one_time
- recurring
stopTypeDisplay:
type: string
description: This attribute defines the display value for the associated enum.
nullable: false
additionalProperties: false
paging:
type: object
properties:
nextOffset:
description: 'The next offset is the start position of the read pointer for pagination '
type: string
results:
description: The number of records sent for pagination
type: integer
total:
description: The total number of records requested for pagination
type: integer
'400':
description: The server could not process the request due to an invalid request.
content:
application/problem+json:
schema:
type: object
required:
- type
- title
- details
properties:
type:
description: A string path which uniquely classifies the domain of the error.
type: string
nullable: false
example: jackhenry/operation-failed
title:
description: A end-user readable string title of the error type.
nullable: false
type: string
details:
description: An array of end-user readable strings which provide additional details for the error message.
type: array
nullable: false
items:
type: string
fieldDetails:
type: array
description: An array of objects which provide additional details to specific fields in the request that caused the error.
items:
type: object
properties:
field:
type: string
description: The name or path of the field in the request that caused the error.
detail:
type: string
description: A end-user readable message describing the error related to the field.
data:
type: object
description: |
Additional data that could be useful to a developer or for handing the error programmatically. The schema for the data in this object is intentionally left undefined.
nullable: true
examples:
badRequest:
summary: Bad request
value:
type: acct-svcs/bad-request
title: Rule violation
details:
- exampleField is invalid or malformed.
fieldDetails:
- field: exampleField
detail: Provide a valid value for this field.
'401':
description: Although the HTTP standard specifies "unauthorized", semantically this response means "unauthenticated". That is, the client must authenticate itself to get the requested response.
'403':
description: The client does not have access rights to the content; that is, it is unauthorized, so the server is refusing to give the requested resource. Unlike 401, the clients identity is known to the server.
'404':
description: The server can not find the requested resource. In an API, this can also mean that the endpoint is valid but the resource itself does not exist. Servers may also send this response instead of 403 to hide the existence of a resource from an unauthorized client.
'500':
description: An unexpected internal server error occurred while processing the request.
content:
application/problem+json:
schema:
type: object
required:
- type
- title
- details
properties:
type:
description: A string path which uniquely classifies the domain of the error.
type: string
nullable: false
example: jackhenry/operation-failed
title:
description: A end-user readable string title of the error type.
nullable: false
type: string
details:
description: An array of end-user readable strings which provide additional details for the error message.
type: array
nullable: false
items:
type: string
data:
type: object
description: |
Additional data that could be useful to a developer or for handing the error programmatically. The schema for the data in this object is intentionally left undefined.
nullable: true
examples:
internalServerError:
summary: Internal server error
value:
type: acct-svcs/internal-server-error
title: Unexpected error
details:
- An unexpected error occurred. Please contact your service provider and/or try again later.
/a/api/acct-svcs/v1/{InstitutionUniversalId}/enterprise/{EnterpriseUserId}/stop-payments/search:
post:
operationId: SearchStopPaymentWithEnterpriseUserId
tags:
- Stop Payments
summary: API to search for stop payments.
description: API to search for stop payments.
parameters:
- name: InstitutionUniversalId
in: path
description: A unique identifier to establish the identity of an Institution/Environment/Brand combination
required: true
schema:
type: string
- in: path
name: EnterpriseUserId
required: true
schema:
type: string
format: uuid
description: The ID of the enterprise user.
- schema:
type: string
default: '0'
name: Offset
in: query
required: false
description: |
When returning a list of results, the offset determines the number of records to skip before returning the result. If the offset is not provided, the server will return the first set of records.
Example: `.../resource?Offset=50`
- schema:
type: string
default: '10'
name: Count
in: query
required: false
description: |
The count of records requested. The server may limit the number of records returned in a single response. If the count is not provided, the server will return a default number of records.
Example: `.../resource?Count=100`'
requestBody:
description: Request parameters
content:
application/json:
schema:
type: object
properties:
stopType:
type: string
description: This enum attribute defines the type of transaction to stop.
enum:
- one_time
- recurring
accountId:
description: This attribute defines the account id generated by the system for the account.
type: string
format: uuid
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
properties:
stopPayments:
type: array
items:
type: object
required:
- accountId
- accountNumber
- accountType
properties:
id:
type: string
format: uuid
description: This attribute defines the Id generated by the system for the stop payment.
accountId:
description: This attribute defines the account id generated by the system for the account.
type: string
format: uuid
accountNumber:
description: This attribute defines the account number on which stop payment exists.
type: string
nullable: false
maxLength: 34
accountType:
type: string
description: This enum attribute defines the account type.
enum:
- checking
- savings
accountTypeDisplay:
type: string
description: This attribute defines the display value for the associated enum.
nullable: false
amount:
type: object
properties:
value:
type: string
description: This defines the amount value.
nullable: false
currencyType:
type: string
description: The ISO 4217 three character currency type. USD is the default value.
nullable: true
default: usd
additionalProperties: false
effectiveDate:
type: string
format: date
description: This attribute defines the effective date of the transaction in the stop payment request.
nullable: true
expirationDate:
type: string
format: date
description: This attribute defines the date when the stop payment is no longer active. If the expiration date is left blank, a default expiration date is used.
originatorId:
type: integer
description: This attribute defines a 10-digit unique identifier used to identify the originator of the transaction.
example: 1234567890
nullable: true
originatorSecCode:
type: string
description: This attribute defines the type of ACH transaction a stop payment is being place on. This can include PPD (personal payment/debit), CCD (commercial cash concentration/disbursement), etc.
maxLength: 3
nullable: true
payee:
type: string
description: This attribute defines the originator of the transaction.
maxLength: 25
reason:
type: string
description: This attribute defines the reason for the stop payment request.
maxLength: 50
stopType:
type: string
description: This enum attribute defines the type of transaction to stop.
enum:
- one_time
- recurring
stopTypeDisplay:
type: string
description: This attribute defines the display value for the associated enum.
nullable: false
additionalProperties: false
paging:
type: object
properties:
nextOffset:
description: 'The next offset is the start position of the read pointer for pagination '
type: string
results:
description: The number of records sent for pagination
type: integer
total:
description: The total number of records requested for pagination
type: integer
'400':
description: The server could not process the request due to an invalid request.
content:
application/problem+json:
schema:
type: object
required:
- type
- title
- details
properties:
type:
description: A string path which uniquely classifies the domain of the error.
type: string
nullable: false
example: jackhenry/operation-failed
title:
description: A end-user readable string title of the error type.
nullable: false
type: string
details:
description: An array of end-user readable strings which provide additional details for the error message.
type: array
nullable: false
items:
type: string
fieldDetails:
type: array
description: An array of objects which provide additional details to specific fields in the request that caused the error.
items:
type: object
properties:
field:
type: string
description: The name or path of the field in the request that caused the error.
detail:
type: string
description: A end-user readable message describing the error related to the field.
data:
type: object
description: |
Additional data that could be useful to a developer or for handing the error programmatically. The schema for the data in this object is intentionally left undefined.
nullable: true
examples:
badRequest:
summary: Bad request
value:
type: acct-svcs/bad-request
title: Rule violation
details:
- exampleField is invalid or malformed.
fieldDetails:
- field: exampleField
detail: Provide a valid value for this field.
'401':
description: Although the HTTP standard specifies "unauthorized", semantically this response means "unauthenticated". That is, the client must authenticate itself to get the requested response.
'403':
description: The client does not have access rights to the content; that is, it is unauthorized, so the server is refusing to give the requested resource. Unlike 401, the clients identity is known to the server.
'404':
description: The server can not find the requested resource. In an API, this can also mean that the endpoint is valid but the resource itself does not exist. Servers may also send this response instead of 403 to hide the existence of a resource from an unauthorized client.
'500':
description: An unexpected internal server error occurred while processing the request.
content:
application/problem+json:
schema:
type: object
required:
- type
- title
- details
properties:
type:
description: A string path which uniquely classifies the domain of the error.
type: string
nullable: false
example: jackhenry/operation-failed
title:
description: A end-user readable string title of the error type.
nullable: false
type: string
details:
description: An array of end-user readable strings which provide additional details for the error message.
type: array
nullable: false
items:
type: string
data:
type: object
description: |
Additional data that could be useful to a developer or for handing the error programmatically. The schema for the data in this object is intentionally left undefined.
nullable: true
examples:
internalServerError:
summary: Internal server error
value:
type: acct-svcs/internal-server-error
title: Unexpected error
details:
- An unexpected error occurred. Please contact your service provider and/or try again later.
Did this page help you?
Why was this page helpful?
Why wasn't this page helpful?
Thank you for your feedback!
Last updated Fri Jan 23 2026