ACH Transactions
Transaction Controller
The search API will return paginated results. Default page-size (results per page) is 25. Dates are stored in UTC - any date related searches should account for this. HATEOAS links will be returned to the response, allowing you to page to the next set of results or the previous.
Unique id of the ach transaction
Type. Allowed values: Debit,Credit
Amount of the transaction
Routing number
Account type. Allowed values: Checking, Savings
Trace number
Check number
Invoice number
Predefined date ranges that can be searched on (Dates are stored in UTC). Allowed values: last_24_hours, yesterday, last_week, last_month, last_180_days, custom_range
Filters the transactions list by the created date/time (Dates are stored in UTC). Setting start date will return transactions that were processed after this date/time. Setting both start and end date creates a range
Use with start date to create range (Dates are stored in UTC)
Date format being used for start or end date (Dates are stored in UTC). Allowed values: MM-dd-yyyy hh:mm a, MM-dd-yy HH:mm, MM-dd-yy HH:mm z, yyyy-MM-dd HH:mm, yyyy-MM-dd HH:mm z
Order Id
Page number
Page Size
List results in descending order, default is true
Provide the name of one of the allowed search fields and the results will be ordered by this field. Use in combination with descending field.
Purchase order
Customer Id
Description
Status of transaction. Allowed values: Pending, Settling, Settled, Returned
PPD = Predetermined Payment and Deposit
Email address
api-key-value
GET //rest/v2/ach/transactions HTTP/1.1
Host: gateway-sb.clearent.net
Accept: */*
<?xml version="1.0"?>
<object>
<ach-transaction>
<check-field>invoice</check-field>
<client-ip>111.22.22.333</client-ip>
<dob-year>dob-year</dob-year>
<email-receipt>true</email-receipt>
<software-type-version>1.0</software-type-version>
<type>Debit</type>
<validate-account>true</validate-account>
<amount>text</amount>
<routing-number>text</routing-number>
<account-number>text</account-number>
<account-type>Checking</account-type>
<standard-entry-class-code>PPD</standard-entry-class-code>
<check-number>text</check-number>
<create-token>false</create-token>
<create-description>false</create-description>
<individual-name>text</individual-name>
<token-id>1188888888888888</token-id>
<id>text</id>
<status>Pending</status>
<billing>
<city>City</city>
<company>Company</company>
<country>Country</country>
<first-name>John</first-name>
<last-name>Doe</last-name>
<phone>Phone</phone>
<state>State</state>
<street>Street</street>
<street2>Street2</street2>
<zip>Zip</zip>
</billing>
<shipping>
<city>City</city>
<company>Company</company>
<country>Country</country>
<first-name>John</first-name>
<last-name>Doe</last-name>
<phone>Phone</phone>
<state>State</state>
<street>Street</street>
<street2>Street2</street2>
<zip>Zip</zip>
</shipping>
<invoice>text</invoice>
<purchase-order>text</purchase-order>
<customer-id>text</customer-id>
<order-id>text</order-id>
<email-address>text</email-address>
<description>text</description>
<comments>text</comments>
<billing-is-shipping>true</billing-is-shipping>
<status-change-date>text</status-change-date>
<display-message>text</display-message>
<provider-transaction-id>text</provider-transaction-id>
<trace-number>text</trace-number>
<settled-date>text</settled-date>
<returned-date>text</returned-date>
<returned-code>text</returned-code>
<returned-message>text</returned-message>
<ach-token>
<account-number>1111</account-number>
<account-type>Checking</account-type>
<created>1100000000000000</created>
<customer-key>customer123</customer-key>
<default>false</default>
<individual-name>John Doe</individual-name>
<last-used>1100000000000000</last-used>
<merchant-id>000008888</merchant-id>
<routing-number>081009813</routing-number>
<times-used>14</times-used>
<token-description>Travel checking account</token-description>
<token-id>1100000000000000</token-id>
<updated>1100000000000000</updated>
</ach-token>
<merchant-id>text</merchant-id>
<terminal-id>text</terminal-id>
<software-type>MySoftware_Version1.3</software-type>
<paya-authorization>text</paya-authorization>
</ach-transaction>
</object>
All ACH transaction types can be performed through this endpoint by specifying within the “type” keypair. We also provide convenience endpoints for each ACH transaction type independently (/ach/transactions/debit or /ach/transactions/credit). The "check-field" keypair can check for a duplicate transaction attempt. The “check-field” points to another field you provide within the request. The field you select needs to have a value. Fields supported: invoice, order-id, purchase-order, check-number.
Example: "check-field": "invoice", "invoice": "invoice1"
A customer's bank account can be validated using the field "validate-account". If the validation fails, an appropriate error message is returned.
Example: "validate-account": "true".
apiKeyValue
This model represents the ach transaction in the response
Field to check for duplicate transactions on such as invoice
invoice
Possible values: Optional client ip address
111.22.22.333
1999, 2000, 2009
dob-year
Boolean which signifies whether or not a receipt should be sent
true
Include the version of software-type
1.0
Set to true when validating account information.
true
Possible values: An absolute number with two decimal places.
9 digits.
Account number masked to only show last four
PPD = Predetermined Payment and Deposit
This value helps with duplicate transaction checking
Set to true if you would like to create a token as part of the transaction
false
Pass in when creating a token if you would like to save a description wiht the token
false
The name of the account holder.
Pass in if you would like to run the transaction with a previously created token. The token replaces routing-number, account-number, account-type and individual name; making those fields unnecessary when paying with a token
1188888888888888
Unique id of the ach transaction.
Returned from GET and can be used with search filter.
This value helps with duplicate transaction checking
This value helps with duplicate transaction checking
This value helps with duplicate transaction checking
This value helps with duplicate transaction checking
Email Address of customer
A brief description of the product being sold
Any additional comments to be made of the transaction
Is the billing address the same as the shipping address?
Last date that the status of the transaction changed
message to be displayed
transaction id from the ach provider
Trace number associated with a returned or settled transaction
Date of settled transaction
Date of a returned transaction
Code associated with a returned transaction (NACHA)
Message associated with a returned transaction (NACHA)
Merchant Id of the transaction
Terminal Id of the api-key used to create the transaction
Static field referencing the software name you are building
MySoftware_Version1.3
Paya Authorization
POST //rest/v2/ach/transactions HTTP/1.1
Host: gateway-sb.clearent.net
Content-Type: application/xml
Accept: */*
Content-Length: 1683
"<?xml version=1.0?>
<check-field>invoice</check-field>
<client-ip>111.22.22.333</client-ip>
<dob-year>dob-year</dob-year>
<email-receipt>true</email-receipt>
<software-type-version>1.0</software-type-version>
<type>Debit</type>
<validate-account>true</validate-account>
<amount>text</amount>
<routing-number>text</routing-number>
<account-number>text</account-number>
<account-type>Checking</account-type>
<standard-entry-class-code>PPD</standard-entry-class-code>
<check-number>text</check-number>
<create-token>false</create-token>
<create-description>false</create-description>
<individual-name>text</individual-name>
<token-id>1188888888888888</token-id>
<id>text</id>
<status>Pending</status>
<billing>
<city>City</city>
<company>Company</company>
<country>Country</country>
<first-name>John</first-name>
<last-name>Doe</last-name>
<phone>Phone</phone>
<state>State</state>
<street>Street</street>
<street2>Street2</street2>
<zip>Zip</zip>
</billing>
<shipping>
<city>City</city>
<company>Company</company>
<country>Country</country>
<first-name>John</first-name>
<last-name>Doe</last-name>
<phone>Phone</phone>
<state>State</state>
<street>Street</street>
<street2>Street2</street2>
<zip>Zip</zip>
</shipping>
<invoice>text</invoice>
<purchase-order>text</purchase-order>
<customer-id>text</customer-id>
<order-id>text</order-id>
<email-address>text</email-address>
<description>text</description>
<comments>text</comments>
<billing-is-shipping>true</billing-is-shipping>
<status-change-date>text</status-change-date>
<display-message>text</display-message>
<provider-transaction-id>text</provider-transaction-id>
<trace-number>text</trace-number>
<settled-date>text</settled-date>
<returned-date>text</returned-date>
<returned-code>text</returned-code>
<returned-message>text</returned-message>
<ach-token>
<account-number>1111</account-number>
<account-type>Checking</account-type>
<created>1100000000000000</created>
<customer-key>customer123</customer-key>
<default>false</default>
<individual-name>John Doe</individual-name>
<last-used>1100000000000000</last-used>
<merchant-id>000008888</merchant-id>
<routing-number>081009813</routing-number>
<times-used>14</times-used>
<token-description>Travel checking account</token-description>
<token-id>1100000000000000</token-id>
<updated>1100000000000000</updated>
</ach-token>
<merchant-id>text</merchant-id>
<terminal-id>text</terminal-id>
<software-type>MySoftware_Version1.3</software-type>
<paya-authorization>text</paya-authorization>
"
<?xml version="1.0"?>
<object>
<check-field>invoice</check-field>
<client-ip>111.22.22.333</client-ip>
<dob-year>dob-year</dob-year>
<email-receipt>true</email-receipt>
<software-type-version>1.0</software-type-version>
<type>Debit</type>
<validate-account>true</validate-account>
<amount>text</amount>
<routing-number>text</routing-number>
<account-number>text</account-number>
<account-type>Checking</account-type>
<standard-entry-class-code>PPD</standard-entry-class-code>
<check-number>text</check-number>
<create-token>false</create-token>
<create-description>false</create-description>
<individual-name>text</individual-name>
<token-id>1188888888888888</token-id>
<id>text</id>
<status>Pending</status>
<billing>
<city>City</city>
<company>Company</company>
<country>Country</country>
<first-name>John</first-name>
<last-name>Doe</last-name>
<phone>Phone</phone>
<state>State</state>
<street>Street</street>
<street2>Street2</street2>
<zip>Zip</zip>
</billing>
<shipping>
<city>City</city>
<company>Company</company>
<country>Country</country>
<first-name>John</first-name>
<last-name>Doe</last-name>
<phone>Phone</phone>
<state>State</state>
<street>Street</street>
<street2>Street2</street2>
<zip>Zip</zip>
</shipping>
<invoice>text</invoice>
<purchase-order>text</purchase-order>
<customer-id>text</customer-id>
<order-id>text</order-id>
<email-address>text</email-address>
<description>text</description>
<comments>text</comments>
<billing-is-shipping>true</billing-is-shipping>
<status-change-date>text</status-change-date>
<display-message>text</display-message>
<provider-transaction-id>text</provider-transaction-id>
<trace-number>text</trace-number>
<settled-date>text</settled-date>
<returned-date>text</returned-date>
<returned-code>text</returned-code>
<returned-message>text</returned-message>
<ach-token>
<account-number>1111</account-number>
<account-type>Checking</account-type>
<created>1100000000000000</created>
<customer-key>customer123</customer-key>
<default>false</default>
<individual-name>John Doe</individual-name>
<last-used>1100000000000000</last-used>
<merchant-id>000008888</merchant-id>
<routing-number>081009813</routing-number>
<times-used>14</times-used>
<token-description>Travel checking account</token-description>
<token-id>1100000000000000</token-id>
<updated>1100000000000000</updated>
</ach-token>
<merchant-id>text</merchant-id>
<terminal-id>text</terminal-id>
<software-type>MySoftware_Version1.3</software-type>
<paya-authorization>text</paya-authorization>
</object>
An ACH credit transaction takes money out of the merchant's account and puts it into your customer's account.
The "check-field" keypair can check for a duplicate transaction attempt. The “check-field” points to another field you provide within the request. The field you select needs to have a value.
Fields supported: invoice, order-id, purchase-order, check-number.
Example: "check-field": "invoice", "invoice": "invoice1"
A customer's bank account can be validated using the field "validate-account". If the validation fails, an appropriate error message is returned.
Example: "validate-account": "true".
apiKeyValue
This model represents the ach transaction in the response
Field to check for duplicate transactions on such as invoice
invoice
Possible values: Optional client ip address
111.22.22.333
1999, 2000, 2009
dob-year
Boolean which signifies whether or not a receipt should be sent
true
Include the version of software-type
1.0
Set to true when validating account information.
true
Possible values: An absolute number with two decimal places.
9 digits.
Account number masked to only show last four
PPD = Predetermined Payment and Deposit
This value helps with duplicate transaction checking
Set to true if you would like to create a token as part of the transaction
false
Pass in when creating a token if you would like to save a description wiht the token
false
The name of the account holder.
Pass in if you would like to run the transaction with a previously created token. The token replaces routing-number, account-number, account-type and individual name; making those fields unnecessary when paying with a token
1188888888888888
Unique id of the ach transaction.
Returned from GET and can be used with search filter.
This value helps with duplicate transaction checking
This value helps with duplicate transaction checking
This value helps with duplicate transaction checking
This value helps with duplicate transaction checking
Email Address of customer
A brief description of the product being sold
Any additional comments to be made of the transaction
Is the billing address the same as the shipping address?
Last date that the status of the transaction changed
message to be displayed
transaction id from the ach provider
Trace number associated with a returned or settled transaction
Date of settled transaction
Date of a returned transaction
Code associated with a returned transaction (NACHA)
Message associated with a returned transaction (NACHA)
Merchant Id of the transaction
Terminal Id of the api-key used to create the transaction
Static field referencing the software name you are building
MySoftware_Version1.3
Paya Authorization
POST //rest/v2/ach/transactions/credit HTTP/1.1
Host: gateway-sb.clearent.net
Content-Type: application/xml
Accept: */*
Content-Length: 1683
"<?xml version=1.0?>
<check-field>invoice</check-field>
<client-ip>111.22.22.333</client-ip>
<dob-year>dob-year</dob-year>
<email-receipt>true</email-receipt>
<software-type-version>1.0</software-type-version>
<type>Debit</type>
<validate-account>true</validate-account>
<amount>text</amount>
<routing-number>text</routing-number>
<account-number>text</account-number>
<account-type>Checking</account-type>
<standard-entry-class-code>PPD</standard-entry-class-code>
<check-number>text</check-number>
<create-token>false</create-token>
<create-description>false</create-description>
<individual-name>text</individual-name>
<token-id>1188888888888888</token-id>
<id>text</id>
<status>Pending</status>
<billing>
<city>City</city>
<company>Company</company>
<country>Country</country>
<first-name>John</first-name>
<last-name>Doe</last-name>
<phone>Phone</phone>
<state>State</state>
<street>Street</street>
<street2>Street2</street2>
<zip>Zip</zip>
</billing>
<shipping>
<city>City</city>
<company>Company</company>
<country>Country</country>
<first-name>John</first-name>
<last-name>Doe</last-name>
<phone>Phone</phone>
<state>State</state>
<street>Street</street>
<street2>Street2</street2>
<zip>Zip</zip>
</shipping>
<invoice>text</invoice>
<purchase-order>text</purchase-order>
<customer-id>text</customer-id>
<order-id>text</order-id>
<email-address>text</email-address>
<description>text</description>
<comments>text</comments>
<billing-is-shipping>true</billing-is-shipping>
<status-change-date>text</status-change-date>
<display-message>text</display-message>
<provider-transaction-id>text</provider-transaction-id>
<trace-number>text</trace-number>
<settled-date>text</settled-date>
<returned-date>text</returned-date>
<returned-code>text</returned-code>
<returned-message>text</returned-message>
<ach-token>
<account-number>1111</account-number>
<account-type>Checking</account-type>
<created>1100000000000000</created>
<customer-key>customer123</customer-key>
<default>false</default>
<individual-name>John Doe</individual-name>
<last-used>1100000000000000</last-used>
<merchant-id>000008888</merchant-id>
<routing-number>081009813</routing-number>
<times-used>14</times-used>
<token-description>Travel checking account</token-description>
<token-id>1100000000000000</token-id>
<updated>1100000000000000</updated>
</ach-token>
<merchant-id>text</merchant-id>
<terminal-id>text</terminal-id>
<software-type>MySoftware_Version1.3</software-type>
<paya-authorization>text</paya-authorization>
"
<?xml version="1.0"?>
<object>
<check-field>invoice</check-field>
<client-ip>111.22.22.333</client-ip>
<dob-year>dob-year</dob-year>
<email-receipt>true</email-receipt>
<software-type-version>1.0</software-type-version>
<type>Debit</type>
<validate-account>true</validate-account>
<amount>text</amount>
<routing-number>text</routing-number>
<account-number>text</account-number>
<account-type>Checking</account-type>
<standard-entry-class-code>PPD</standard-entry-class-code>
<check-number>text</check-number>
<create-token>false</create-token>
<create-description>false</create-description>
<individual-name>text</individual-name>
<token-id>1188888888888888</token-id>
<id>text</id>
<status>Pending</status>
<billing>
<city>City</city>
<company>Company</company>
<country>Country</country>
<first-name>John</first-name>
<last-name>Doe</last-name>
<phone>Phone</phone>
<state>State</state>
<street>Street</street>
<street2>Street2</street2>
<zip>Zip</zip>
</billing>
<shipping>
<city>City</city>
<company>Company</company>
<country>Country</country>
<first-name>John</first-name>
<last-name>Doe</last-name>
<phone>Phone</phone>
<state>State</state>
<street>Street</street>
<street2>Street2</street2>
<zip>Zip</zip>
</shipping>
<invoice>text</invoice>
<purchase-order>text</purchase-order>
<customer-id>text</customer-id>
<order-id>text</order-id>
<email-address>text</email-address>
<description>text</description>
<comments>text</comments>
<billing-is-shipping>true</billing-is-shipping>
<status-change-date>text</status-change-date>
<display-message>text</display-message>
<provider-transaction-id>text</provider-transaction-id>
<trace-number>text</trace-number>
<settled-date>text</settled-date>
<returned-date>text</returned-date>
<returned-code>text</returned-code>
<returned-message>text</returned-message>
<ach-token>
<account-number>1111</account-number>
<account-type>Checking</account-type>
<created>1100000000000000</created>
<customer-key>customer123</customer-key>
<default>false</default>
<individual-name>John Doe</individual-name>
<last-used>1100000000000000</last-used>
<merchant-id>000008888</merchant-id>
<routing-number>081009813</routing-number>
<times-used>14</times-used>
<token-description>Travel checking account</token-description>
<token-id>1100000000000000</token-id>
<updated>1100000000000000</updated>
</ach-token>
<merchant-id>text</merchant-id>
<terminal-id>text</terminal-id>
<software-type>MySoftware_Version1.3</software-type>
<paya-authorization>text</paya-authorization>
</object>
An ACH debit transaction takes money out of the customer’s account and puts it into your merchant's account.
The "check-field" keypair can check for a duplicate transaction attempt. The “check-field” points to another field you provide within the request. The field you select needs to have a value.
Fields supported: invoice, order-id, purchase-order, check-number.
Example: "check-field": "invoice", "invoice": "invoice1"
A customer's bank account can be validated using the field "validate-account". If the validation fails, an appropriate error message is returned.
Example: "validate-account": "true".
apiKeyValue
This model represents the ach transaction in the response
Field to check for duplicate transactions on such as invoice
invoice
Possible values: Optional client ip address
111.22.22.333
1999, 2000, 2009
dob-year
Boolean which signifies whether or not a receipt should be sent
true
Include the version of software-type
1.0
Set to true when validating account information.
true
Possible values: An absolute number with two decimal places.
9 digits.
Account number masked to only show last four
PPD = Predetermined Payment and Deposit
This value helps with duplicate transaction checking
Set to true if you would like to create a token as part of the transaction
false
Pass in when creating a token if you would like to save a description wiht the token
false
The name of the account holder.
Pass in if you would like to run the transaction with a previously created token. The token replaces routing-number, account-number, account-type and individual name; making those fields unnecessary when paying with a token
1188888888888888
Unique id of the ach transaction.
Returned from GET and can be used with search filter.
This value helps with duplicate transaction checking
This value helps with duplicate transaction checking
This value helps with duplicate transaction checking
This value helps with duplicate transaction checking
Email Address of customer
A brief description of the product being sold
Any additional comments to be made of the transaction
Is the billing address the same as the shipping address?
Last date that the status of the transaction changed
message to be displayed
transaction id from the ach provider
Trace number associated with a returned or settled transaction
Date of settled transaction
Date of a returned transaction
Code associated with a returned transaction (NACHA)
Message associated with a returned transaction (NACHA)
Merchant Id of the transaction
Terminal Id of the api-key used to create the transaction
Static field referencing the software name you are building
MySoftware_Version1.3
Paya Authorization
POST //rest/v2/ach/transactions/debit HTTP/1.1
Host: gateway-sb.clearent.net
Content-Type: application/xml
Accept: */*
Content-Length: 1683
"<?xml version=1.0?>
<check-field>invoice</check-field>
<client-ip>111.22.22.333</client-ip>
<dob-year>dob-year</dob-year>
<email-receipt>true</email-receipt>
<software-type-version>1.0</software-type-version>
<type>Debit</type>
<validate-account>true</validate-account>
<amount>text</amount>
<routing-number>text</routing-number>
<account-number>text</account-number>
<account-type>Checking</account-type>
<standard-entry-class-code>PPD</standard-entry-class-code>
<check-number>text</check-number>
<create-token>false</create-token>
<create-description>false</create-description>
<individual-name>text</individual-name>
<token-id>1188888888888888</token-id>
<id>text</id>
<status>Pending</status>
<billing>
<city>City</city>
<company>Company</company>
<country>Country</country>
<first-name>John</first-name>
<last-name>Doe</last-name>
<phone>Phone</phone>
<state>State</state>
<street>Street</street>
<street2>Street2</street2>
<zip>Zip</zip>
</billing>
<shipping>
<city>City</city>
<company>Company</company>
<country>Country</country>
<first-name>John</first-name>
<last-name>Doe</last-name>
<phone>Phone</phone>
<state>State</state>
<street>Street</street>
<street2>Street2</street2>
<zip>Zip</zip>
</shipping>
<invoice>text</invoice>
<purchase-order>text</purchase-order>
<customer-id>text</customer-id>
<order-id>text</order-id>
<email-address>text</email-address>
<description>text</description>
<comments>text</comments>
<billing-is-shipping>true</billing-is-shipping>
<status-change-date>text</status-change-date>
<display-message>text</display-message>
<provider-transaction-id>text</provider-transaction-id>
<trace-number>text</trace-number>
<settled-date>text</settled-date>
<returned-date>text</returned-date>
<returned-code>text</returned-code>
<returned-message>text</returned-message>
<ach-token>
<account-number>1111</account-number>
<account-type>Checking</account-type>
<created>1100000000000000</created>
<customer-key>customer123</customer-key>
<default>false</default>
<individual-name>John Doe</individual-name>
<last-used>1100000000000000</last-used>
<merchant-id>000008888</merchant-id>
<routing-number>081009813</routing-number>
<times-used>14</times-used>
<token-description>Travel checking account</token-description>
<token-id>1100000000000000</token-id>
<updated>1100000000000000</updated>
</ach-token>
<merchant-id>text</merchant-id>
<terminal-id>text</terminal-id>
<software-type>MySoftware_Version1.3</software-type>
<paya-authorization>text</paya-authorization>
"
<?xml version="1.0"?>
<object>
<check-field>invoice</check-field>
<client-ip>111.22.22.333</client-ip>
<dob-year>dob-year</dob-year>
<email-receipt>true</email-receipt>
<software-type-version>1.0</software-type-version>
<type>Debit</type>
<validate-account>true</validate-account>
<amount>text</amount>
<routing-number>text</routing-number>
<account-number>text</account-number>
<account-type>Checking</account-type>
<standard-entry-class-code>PPD</standard-entry-class-code>
<check-number>text</check-number>
<create-token>false</create-token>
<create-description>false</create-description>
<individual-name>text</individual-name>
<token-id>1188888888888888</token-id>
<id>text</id>
<status>Pending</status>
<billing>
<city>City</city>
<company>Company</company>
<country>Country</country>
<first-name>John</first-name>
<last-name>Doe</last-name>
<phone>Phone</phone>
<state>State</state>
<street>Street</street>
<street2>Street2</street2>
<zip>Zip</zip>
</billing>
<shipping>
<city>City</city>
<company>Company</company>
<country>Country</country>
<first-name>John</first-name>
<last-name>Doe</last-name>
<phone>Phone</phone>
<state>State</state>
<street>Street</street>
<street2>Street2</street2>
<zip>Zip</zip>
</shipping>
<invoice>text</invoice>
<purchase-order>text</purchase-order>
<customer-id>text</customer-id>
<order-id>text</order-id>
<email-address>text</email-address>
<description>text</description>
<comments>text</comments>
<billing-is-shipping>true</billing-is-shipping>
<status-change-date>text</status-change-date>
<display-message>text</display-message>
<provider-transaction-id>text</provider-transaction-id>
<trace-number>text</trace-number>
<settled-date>text</settled-date>
<returned-date>text</returned-date>
<returned-code>text</returned-code>
<returned-message>text</returned-message>
<ach-token>
<account-number>1111</account-number>
<account-type>Checking</account-type>
<created>1100000000000000</created>
<customer-key>customer123</customer-key>
<default>false</default>
<individual-name>John Doe</individual-name>
<last-used>1100000000000000</last-used>
<merchant-id>000008888</merchant-id>
<routing-number>081009813</routing-number>
<times-used>14</times-used>
<token-description>Travel checking account</token-description>
<token-id>1100000000000000</token-id>
<updated>1100000000000000</updated>
</ach-token>
<merchant-id>text</merchant-id>
<terminal-id>text</terminal-id>
<software-type>MySoftware_Version1.3</software-type>
<paya-authorization>text</paya-authorization>
</object>
This method is only supported if Paya is your ACH provider.
apiKeyValue
This model represents the ach transaction in the response
Field to check for duplicate transactions on such as invoice
invoice
Possible values: Optional client ip address
111.22.22.333
1999, 2000, 2009
dob-year
Boolean which signifies whether or not a receipt should be sent
true
Include the version of software-type
1.0
Set to true when validating account information.
true
Possible values: An absolute number with two decimal places.
9 digits.
Account number masked to only show last four
PPD = Predetermined Payment and Deposit
This value helps with duplicate transaction checking
Set to true if you would like to create a token as part of the transaction
false
Pass in when creating a token if you would like to save a description wiht the token
false
The name of the account holder.
Pass in if you would like to run the transaction with a previously created token. The token replaces routing-number, account-number, account-type and individual name; making those fields unnecessary when paying with a token
1188888888888888
Unique id of the ach transaction.
Returned from GET and can be used with search filter.
This value helps with duplicate transaction checking
This value helps with duplicate transaction checking
This value helps with duplicate transaction checking
This value helps with duplicate transaction checking
Email Address of customer
A brief description of the product being sold
Any additional comments to be made of the transaction
Is the billing address the same as the shipping address?
Last date that the status of the transaction changed
message to be displayed
transaction id from the ach provider
Trace number associated with a returned or settled transaction
Date of settled transaction
Date of a returned transaction
Code associated with a returned transaction (NACHA)
Message associated with a returned transaction (NACHA)
Merchant Id of the transaction
Terminal Id of the api-key used to create the transaction
Static field referencing the software name you are building
MySoftware_Version1.3
Paya Authorization
POST //rest/v2/ach/transactions/reversal HTTP/1.1
Host: gateway-sb.clearent.net
Content-Type: application/xml
Accept: */*
Content-Length: 1683
"<?xml version=1.0?>
<check-field>invoice</check-field>
<client-ip>111.22.22.333</client-ip>
<dob-year>dob-year</dob-year>
<email-receipt>true</email-receipt>
<software-type-version>1.0</software-type-version>
<type>Debit</type>
<validate-account>true</validate-account>
<amount>text</amount>
<routing-number>text</routing-number>
<account-number>text</account-number>
<account-type>Checking</account-type>
<standard-entry-class-code>PPD</standard-entry-class-code>
<check-number>text</check-number>
<create-token>false</create-token>
<create-description>false</create-description>
<individual-name>text</individual-name>
<token-id>1188888888888888</token-id>
<id>text</id>
<status>Pending</status>
<billing>
<city>City</city>
<company>Company</company>
<country>Country</country>
<first-name>John</first-name>
<last-name>Doe</last-name>
<phone>Phone</phone>
<state>State</state>
<street>Street</street>
<street2>Street2</street2>
<zip>Zip</zip>
</billing>
<shipping>
<city>City</city>
<company>Company</company>
<country>Country</country>
<first-name>John</first-name>
<last-name>Doe</last-name>
<phone>Phone</phone>
<state>State</state>
<street>Street</street>
<street2>Street2</street2>
<zip>Zip</zip>
</shipping>
<invoice>text</invoice>
<purchase-order>text</purchase-order>
<customer-id>text</customer-id>
<order-id>text</order-id>
<email-address>text</email-address>
<description>text</description>
<comments>text</comments>
<billing-is-shipping>true</billing-is-shipping>
<status-change-date>text</status-change-date>
<display-message>text</display-message>
<provider-transaction-id>text</provider-transaction-id>
<trace-number>text</trace-number>
<settled-date>text</settled-date>
<returned-date>text</returned-date>
<returned-code>text</returned-code>
<returned-message>text</returned-message>
<ach-token>
<account-number>1111</account-number>
<account-type>Checking</account-type>
<created>1100000000000000</created>
<customer-key>customer123</customer-key>
<default>false</default>
<individual-name>John Doe</individual-name>
<last-used>1100000000000000</last-used>
<merchant-id>000008888</merchant-id>
<routing-number>081009813</routing-number>
<times-used>14</times-used>
<token-description>Travel checking account</token-description>
<token-id>1100000000000000</token-id>
<updated>1100000000000000</updated>
</ach-token>
<merchant-id>text</merchant-id>
<terminal-id>text</terminal-id>
<software-type>MySoftware_Version1.3</software-type>
<paya-authorization>text</paya-authorization>
"
<?xml version="1.0"?>
<object>
<check-field>invoice</check-field>
<client-ip>111.22.22.333</client-ip>
<dob-year>dob-year</dob-year>
<email-receipt>true</email-receipt>
<software-type-version>1.0</software-type-version>
<type>Debit</type>
<validate-account>true</validate-account>
<amount>text</amount>
<routing-number>text</routing-number>
<account-number>text</account-number>
<account-type>Checking</account-type>
<standard-entry-class-code>PPD</standard-entry-class-code>
<check-number>text</check-number>
<create-token>false</create-token>
<create-description>false</create-description>
<individual-name>text</individual-name>
<token-id>1188888888888888</token-id>
<id>text</id>
<status>Pending</status>
<billing>
<city>City</city>
<company>Company</company>
<country>Country</country>
<first-name>John</first-name>
<last-name>Doe</last-name>
<phone>Phone</phone>
<state>State</state>
<street>Street</street>
<street2>Street2</street2>
<zip>Zip</zip>
</billing>
<shipping>
<city>City</city>
<company>Company</company>
<country>Country</country>
<first-name>John</first-name>
<last-name>Doe</last-name>
<phone>Phone</phone>
<state>State</state>
<street>Street</street>
<street2>Street2</street2>
<zip>Zip</zip>
</shipping>
<invoice>text</invoice>
<purchase-order>text</purchase-order>
<customer-id>text</customer-id>
<order-id>text</order-id>
<email-address>text</email-address>
<description>text</description>
<comments>text</comments>
<billing-is-shipping>true</billing-is-shipping>
<status-change-date>text</status-change-date>
<display-message>text</display-message>
<provider-transaction-id>text</provider-transaction-id>
<trace-number>text</trace-number>
<settled-date>text</settled-date>
<returned-date>text</returned-date>
<returned-code>text</returned-code>
<returned-message>text</returned-message>
<ach-token>
<account-number>1111</account-number>
<account-type>Checking</account-type>
<created>1100000000000000</created>
<customer-key>customer123</customer-key>
<default>false</default>
<individual-name>John Doe</individual-name>
<last-used>1100000000000000</last-used>
<merchant-id>000008888</merchant-id>
<routing-number>081009813</routing-number>
<times-used>14</times-used>
<token-description>Travel checking account</token-description>
<token-id>1100000000000000</token-id>
<updated>1100000000000000</updated>
</ach-token>
<merchant-id>text</merchant-id>
<terminal-id>text</terminal-id>
<software-type>MySoftware_Version1.3</software-type>
<paya-authorization>text</paya-authorization>
</object>
Use this endpoint to validate an ACH account. This does NOT submit a transaction it will only verify if the ACH account is in good standing. While we allow you to pass in an amount, we are unable to verify that the amount is in the account.
apiKeyValue
This model represents the ach transaction in the response
Field to check for duplicate transactions on such as invoice
invoice
Possible values: Optional client ip address
111.22.22.333
1999, 2000, 2009
dob-year
Boolean which signifies whether or not a receipt should be sent
true
Include the version of software-type
1.0
Set to true when validating account information.
true
Possible values: An absolute number with two decimal places.
9 digits.
Account number masked to only show last four
PPD = Predetermined Payment and Deposit
This value helps with duplicate transaction checking
Set to true if you would like to create a token as part of the transaction
false
Pass in when creating a token if you would like to save a description wiht the token
false
The name of the account holder.
Pass in if you would like to run the transaction with a previously created token. The token replaces routing-number, account-number, account-type and individual name; making those fields unnecessary when paying with a token
1188888888888888
Unique id of the ach transaction.
Returned from GET and can be used with search filter.
This value helps with duplicate transaction checking
This value helps with duplicate transaction checking
This value helps with duplicate transaction checking
This value helps with duplicate transaction checking
Email Address of customer
A brief description of the product being sold
Any additional comments to be made of the transaction
Is the billing address the same as the shipping address?
Last date that the status of the transaction changed
message to be displayed
transaction id from the ach provider
Trace number associated with a returned or settled transaction
Date of settled transaction
Date of a returned transaction
Code associated with a returned transaction (NACHA)
Message associated with a returned transaction (NACHA)
Merchant Id of the transaction
Terminal Id of the api-key used to create the transaction
Static field referencing the software name you are building
MySoftware_Version1.3
Paya Authorization
POST //rest/v2/ach/transactions/validate HTTP/1.1
Host: gateway-sb.clearent.net
Content-Type: application/xml
Accept: */*
Content-Length: 1683
"<?xml version=1.0?>
<check-field>invoice</check-field>
<client-ip>111.22.22.333</client-ip>
<dob-year>dob-year</dob-year>
<email-receipt>true</email-receipt>
<software-type-version>1.0</software-type-version>
<type>Debit</type>
<validate-account>true</validate-account>
<amount>text</amount>
<routing-number>text</routing-number>
<account-number>text</account-number>
<account-type>Checking</account-type>
<standard-entry-class-code>PPD</standard-entry-class-code>
<check-number>text</check-number>
<create-token>false</create-token>
<create-description>false</create-description>
<individual-name>text</individual-name>
<token-id>1188888888888888</token-id>
<id>text</id>
<status>Pending</status>
<billing>
<city>City</city>
<company>Company</company>
<country>Country</country>
<first-name>John</first-name>
<last-name>Doe</last-name>
<phone>Phone</phone>
<state>State</state>
<street>Street</street>
<street2>Street2</street2>
<zip>Zip</zip>
</billing>
<shipping>
<city>City</city>
<company>Company</company>
<country>Country</country>
<first-name>John</first-name>
<last-name>Doe</last-name>
<phone>Phone</phone>
<state>State</state>
<street>Street</street>
<street2>Street2</street2>
<zip>Zip</zip>
</shipping>
<invoice>text</invoice>
<purchase-order>text</purchase-order>
<customer-id>text</customer-id>
<order-id>text</order-id>
<email-address>text</email-address>
<description>text</description>
<comments>text</comments>
<billing-is-shipping>true</billing-is-shipping>
<status-change-date>text</status-change-date>
<display-message>text</display-message>
<provider-transaction-id>text</provider-transaction-id>
<trace-number>text</trace-number>
<settled-date>text</settled-date>
<returned-date>text</returned-date>
<returned-code>text</returned-code>
<returned-message>text</returned-message>
<ach-token>
<account-number>1111</account-number>
<account-type>Checking</account-type>
<created>1100000000000000</created>
<customer-key>customer123</customer-key>
<default>false</default>
<individual-name>John Doe</individual-name>
<last-used>1100000000000000</last-used>
<merchant-id>000008888</merchant-id>
<routing-number>081009813</routing-number>
<times-used>14</times-used>
<token-description>Travel checking account</token-description>
<token-id>1100000000000000</token-id>
<updated>1100000000000000</updated>
</ach-token>
<merchant-id>text</merchant-id>
<terminal-id>text</terminal-id>
<software-type>MySoftware_Version1.3</software-type>
<paya-authorization>text</paya-authorization>
"
<?xml version="1.0"?>
<object>
<check-field>invoice</check-field>
<client-ip>111.22.22.333</client-ip>
<dob-year>dob-year</dob-year>
<email-receipt>true</email-receipt>
<software-type-version>1.0</software-type-version>
<type>Debit</type>
<validate-account>true</validate-account>
<amount>text</amount>
<routing-number>text</routing-number>
<account-number>text</account-number>
<account-type>Checking</account-type>
<standard-entry-class-code>PPD</standard-entry-class-code>
<check-number>text</check-number>
<create-token>false</create-token>
<create-description>false</create-description>
<individual-name>text</individual-name>
<token-id>1188888888888888</token-id>
<id>text</id>
<status>Pending</status>
<billing>
<city>City</city>
<company>Company</company>
<country>Country</country>
<first-name>John</first-name>
<last-name>Doe</last-name>
<phone>Phone</phone>
<state>State</state>
<street>Street</street>
<street2>Street2</street2>
<zip>Zip</zip>
</billing>
<shipping>
<city>City</city>
<company>Company</company>
<country>Country</country>
<first-name>John</first-name>
<last-name>Doe</last-name>
<phone>Phone</phone>
<state>State</state>
<street>Street</street>
<street2>Street2</street2>
<zip>Zip</zip>
</shipping>
<invoice>text</invoice>
<purchase-order>text</purchase-order>
<customer-id>text</customer-id>
<order-id>text</order-id>
<email-address>text</email-address>
<description>text</description>
<comments>text</comments>
<billing-is-shipping>true</billing-is-shipping>
<status-change-date>text</status-change-date>
<display-message>text</display-message>
<provider-transaction-id>text</provider-transaction-id>
<trace-number>text</trace-number>
<settled-date>text</settled-date>
<returned-date>text</returned-date>
<returned-code>text</returned-code>
<returned-message>text</returned-message>
<ach-token>
<account-number>1111</account-number>
<account-type>Checking</account-type>
<created>1100000000000000</created>
<customer-key>customer123</customer-key>
<default>false</default>
<individual-name>John Doe</individual-name>
<last-used>1100000000000000</last-used>
<merchant-id>000008888</merchant-id>
<routing-number>081009813</routing-number>
<times-used>14</times-used>
<token-description>Travel checking account</token-description>
<token-id>1100000000000000</token-id>
<updated>1100000000000000</updated>
</ach-token>
<merchant-id>text</merchant-id>
<terminal-id>text</terminal-id>
<software-type>MySoftware_Version1.3</software-type>
<paya-authorization>text</paya-authorization>
</object>
Use the id returned in response of original POST
apiKeyValue
GET //rest/v2/ach/transactions/{id} HTTP/1.1
Host: gateway-sb.clearent.net
Accept: */*
<?xml version="1.0"?>
<object>
<check-field>invoice</check-field>
<client-ip>111.22.22.333</client-ip>
<dob-year>dob-year</dob-year>
<email-receipt>true</email-receipt>
<software-type-version>1.0</software-type-version>
<type>Debit</type>
<validate-account>true</validate-account>
<amount>text</amount>
<routing-number>text</routing-number>
<account-number>text</account-number>
<account-type>Checking</account-type>
<standard-entry-class-code>PPD</standard-entry-class-code>
<check-number>text</check-number>
<create-token>false</create-token>
<create-description>false</create-description>
<individual-name>text</individual-name>
<token-id>1188888888888888</token-id>
<id>text</id>
<status>Pending</status>
<billing>
<city>City</city>
<company>Company</company>
<country>Country</country>
<first-name>John</first-name>
<last-name>Doe</last-name>
<phone>Phone</phone>
<state>State</state>
<street>Street</street>
<street2>Street2</street2>
<zip>Zip</zip>
</billing>
<shipping>
<city>City</city>
<company>Company</company>
<country>Country</country>
<first-name>John</first-name>
<last-name>Doe</last-name>
<phone>Phone</phone>
<state>State</state>
<street>Street</street>
<street2>Street2</street2>
<zip>Zip</zip>
</shipping>
<invoice>text</invoice>
<purchase-order>text</purchase-order>
<customer-id>text</customer-id>
<order-id>text</order-id>
<email-address>text</email-address>
<description>text</description>
<comments>text</comments>
<billing-is-shipping>true</billing-is-shipping>
<status-change-date>text</status-change-date>
<display-message>text</display-message>
<provider-transaction-id>text</provider-transaction-id>
<trace-number>text</trace-number>
<settled-date>text</settled-date>
<returned-date>text</returned-date>
<returned-code>text</returned-code>
<returned-message>text</returned-message>
<ach-token>
<account-number>1111</account-number>
<account-type>Checking</account-type>
<created>1100000000000000</created>
<customer-key>customer123</customer-key>
<default>false</default>
<individual-name>John Doe</individual-name>
<last-used>1100000000000000</last-used>
<merchant-id>000008888</merchant-id>
<routing-number>081009813</routing-number>
<times-used>14</times-used>
<token-description>Travel checking account</token-description>
<token-id>1100000000000000</token-id>
<updated>1100000000000000</updated>
</ach-token>
<merchant-id>text</merchant-id>
<terminal-id>text</terminal-id>
<software-type>MySoftware_Version1.3</software-type>
<paya-authorization>text</paya-authorization>
</object>
Only transactions with a "status": "PENDING" can be voided.
Use the id returned in response of original POST
apiKeyValue
DELETE //rest/v2/ach/transactions/{id} HTTP/1.1
Host: gateway-sb.clearent.net
Accept: */*
<?xml version="1.0"?>
<object>
<check-field>invoice</check-field>
<client-ip>111.22.22.333</client-ip>
<dob-year>dob-year</dob-year>
<email-receipt>true</email-receipt>
<software-type-version>1.0</software-type-version>
<type>Debit</type>
<validate-account>true</validate-account>
<amount>text</amount>
<routing-number>text</routing-number>
<account-number>text</account-number>
<account-type>Checking</account-type>
<standard-entry-class-code>PPD</standard-entry-class-code>
<check-number>text</check-number>
<create-token>false</create-token>
<create-description>false</create-description>
<individual-name>text</individual-name>
<token-id>1188888888888888</token-id>
<id>text</id>
<status>Pending</status>
<billing>
<city>City</city>
<company>Company</company>
<country>Country</country>
<first-name>John</first-name>
<last-name>Doe</last-name>
<phone>Phone</phone>
<state>State</state>
<street>Street</street>
<street2>Street2</street2>
<zip>Zip</zip>
</billing>
<shipping>
<city>City</city>
<company>Company</company>
<country>Country</country>
<first-name>John</first-name>
<last-name>Doe</last-name>
<phone>Phone</phone>
<state>State</state>
<street>Street</street>
<street2>Street2</street2>
<zip>Zip</zip>
</shipping>
<invoice>text</invoice>
<purchase-order>text</purchase-order>
<customer-id>text</customer-id>
<order-id>text</order-id>
<email-address>text</email-address>
<description>text</description>
<comments>text</comments>
<billing-is-shipping>true</billing-is-shipping>
<status-change-date>text</status-change-date>
<display-message>text</display-message>
<provider-transaction-id>text</provider-transaction-id>
<trace-number>text</trace-number>
<settled-date>text</settled-date>
<returned-date>text</returned-date>
<returned-code>text</returned-code>
<returned-message>text</returned-message>
<ach-token>
<account-number>1111</account-number>
<account-type>Checking</account-type>
<created>1100000000000000</created>
<customer-key>customer123</customer-key>
<default>false</default>
<individual-name>John Doe</individual-name>
<last-used>1100000000000000</last-used>
<merchant-id>000008888</merchant-id>
<routing-number>081009813</routing-number>
<times-used>14</times-used>
<token-description>Travel checking account</token-description>
<token-id>1100000000000000</token-id>
<updated>1100000000000000</updated>
</ach-token>
<merchant-id>text</merchant-id>
<terminal-id>text</terminal-id>
<software-type>MySoftware_Version1.3</software-type>
<paya-authorization>text</paya-authorization>
</object>
Was this helpful?