API Documentation

API Overview
The Check Issuing API was developed to assist you with integrating your back-office systems with the Check Issuing system. It allows you to notify us of deposits, submit payments for processing, and to look up your payments, deposits, and general account information. The API is utilized by doing standard HTTPS POST requests. It returns XML formatted results.
Live system requests go via https://api.checkissuing.com/
To use our sand box system for integration testing, please use https://apisb.checkissuing.com/ (please contact support for help setting this up if you require it and have not already been granted access)
Authenticating
Before you can begin using the API, you must obtain your user account parameters, Client ID and API Key. To obtain these values, take these steps:
  • 1. Log into your primary Check Issuing user account within the client panel.
  • 2. Go to the your Account page (top right).
  • 3. Navigate to the API Access page (top right). Here you will find both your Client ID and API Key. The API Key must be kept secure and confidential. If the account password is changed, the API key will also be changed and will need to be updated within your application to ensure continued access.
Failure to authenticate will produce the following response from the system: 
<?xml version="1.0" encoding="UTF-8"?>
<wmc-response status="0">
	<error>Access Denied, Invalid API Key Provided</error>
</wmc-response>
Response Format
The API system will respond using standard XML format. This will vary depending on the outcome of the action taken.
Our standard response format will be contained within a wmc-response parent item, with a status attribute to indicate whether your request was successful, with status 1 being success, and status 0 indicating there was an error during your request under most circumstances. This parent item may also contain a fileid attribute applicable to Payment File's uploaded.
As an example success response, please see below: 
<?xml version="1.0" encoding="UTF-8"?>
<wmc-response status="1">
	...
</wmc-response>
In most scenarios dates will be formatted using UNIX stamp format.
Payments can have the following statuses (status ID - status name):
  • 1 - Pending Release
  • 2 - Released
  • 3 - Processing
  • 4 - Sent Out
  • 5 - Posted / Cashed
  • 6 - Returned
  • 7 - Cancelled
  • 8 - Reissued
Postgage Codes can have the following values (code - postage type):
  • 1 - USPS First Class
  • 2 - USPS Priority
  • 3 - USPS Priority + Delivery Confirmation
  • 5 - Two Day Courier Service with FedEx or DHL
  • 6 - One Day Courier Service with FedEx or DHL
  • 8 - USPS Overnight
Error Handling
When the API system responds with a status code of 0, usually you will be given a set of error messages to accompany this.
Error messages will be contained within error elements, as children to the wmc-response parent item. There can be one, or multiple.
As an example error response, please see below: 
<?xml version="1.0" encoding="UTF-8"?>
<wmc-response status="0">
	<error>Please provide an amount</error>
	<error>Please provide a payee</error>
</wmc-response>
API Status Notifications
The API system will perform a HTTP GET request against a URL of your choosing if configured to do so.
To set this up and view full instructions, you can go to your Account page, then API Access as detailed in Authenticating. This option is located toward the bottom. Full history of notifications are also available via a top right menu link, API Status Notification History, with their respective real time status.