Software Partner API Reference
Reference EPS Rev 2.0
Most of the methods in the API require the merchant authentication credentials. Send your merchant key and API key with the query to authenticate your request:
While Pathward offers resources to support developers in building solutions for the software, it remains the developer’s responsibility to create their own solution on the chosen platform and ensure proper utilization of Pathward’s services.
-
• Merchant Key - A string of digits assigned to each merchant when its payment processing account was created. It is a permanent assignment. The merchant key parameter name is 'merchantkey'.
-
• API Key - A string which is assigned to your merchant setup when you activate the Intellipay Web API service. The API key parameter name is 'apikey' Keep your API key private and never share it with anyone. Protect it just as you would a password.
Together, the merchantkey and apikey work as a username/password pair which the system uses to authenticate calls made to it and link to the merchant’s account.
To use the web API, you must first set up a merchant account . You will receive a merchant key and an API key that you will use to authenticate your calls to the API.
Testing & Production
-
API URL: https://eps.pathwardportal.com/api/singup
iPay Sign Up
Create An Account
This method will create a Merchant Account which is a link between a client’s Pathward credentials and an established processor merchant account.
HTTP URL: https://eps.pathwardportal.com/api/signup
HTTP Verb: PUT
iPay Sample Request Data
{
"account_type" : "ipay",
"portal_website" : "dev.pathwardportal.com",
"businesslegalname": "A Legal Business LLC",
"doingbusinessas": "A Legal Business LLC",
"address": "120 Test",
"address2": "Mailing Address (If different from business)",
"city": "Atlanta",
"BusinessCountry": "USA",
"us_state": "GA",
"zipcode": "30346",
"firstname": "D",
"lastname": "Freddy",
"phone": "9860668923",
"businesstype": "D",
"email": "dev@gmail.com",
"ein": "193458989",
"years": "Years in Business",
"producttype": "S",
"priorprocess": "C",
"terminated": "C",
"terminationreason": "T",
"owners": [
{
"ownfirstname": "Jane",
"ownlastname": "Doe",
"owntitle": "President",
"ownaddress": "First Union",
"ownpercent": "75",
"ownssn": "193458989",
"ownstate": "GA",
"owncity": "Atlanta",
"ownzip": "30346",
"ownemail": "janetest@test.com",
"owndob": "05-15-1995"
},
{
"ownfirstname": "Joe",
"ownlastname": "Doe",
"owntitle": "CEO",
"ownaddress": "First Union",
"ownpercent": "25",
"ownssn": "193458989",
"ownstate": "GA",
"owncity": "Atlanta",
"ownzip": "30346",
"ownemail": "joetest@yahoo.com",
"owndob": "02-15-1990"
}
]
}
iPay Sample Response
Params |
Demo Data |
Max |
Required |
Notes |
account_type |
ipay |
Required |
iPay: Traditional Merchant |
|
portal_website |
dev.pathwardportal.com |
Required |
URL will be updated to specific portal once live. |
|
businesslegalname |
A Legal Business LLC |
|
Required |
The legal name of the business as registered. |
doingbusinessas |
A Legal Business |
|
Required |
This field can be used to provide DBA information on an account. |
address |
120 Test |
10 |
Required |
Business Physical Address |
address2 |
|
|
If different from business |
|
city |
Atlanta |
Required | ||
us_state |
GA |
2 | Must be one of the standard 2 characters abbreviations. | |
zipcode |
99999 |
5 | Required |
Zip Code should be set 5 characters |
firstname |
Jane |
Required |
|
|
lastname |
Doe |
|
Required |
|
phone |
9860668923 |
10 | Required |
Must be 10 characters with no dashes |
businesstype |
D | Required |
D => C - Corp. (Non-publicly traded) Limited Company |
|
dev@gmail.com |
Required |
Owner Email ID |
||
ein |
193458989 | 9 | Required | EIN should be entered without a dash |
years |
|
Required |
Years in Business |
|
producttype |
Tax Services |
Required |
Type of Product(s) / Service(s) Taking Payments for: |
|
priorprocess |
Yes |
Required |
Have you processed credit cards before? Set as Yes or No |
|
terminated |
No |
|
Required |
Have you ever been terminated from a processor before? Set as Yes or No |
terminationreason |
|
string |
|
Reason for Termination |
ownfirstname |
Jane |
Required |
Name of Owner |
|
ownlastname |
Doe |
Required |
Owner Last Name |
|
owntitle |
President |
Required |
Title Owners Hold |
|
ownpercent |
50 |
|
Required |
Percentage for Owner. Percentage should be in between 0 and 100. |
ownssn |
193458989 |
9 |
Required |
Social Security Number of the Owner. Should be 9 digits |
owndob |
05-15-1995 |
Required |
Date of Birth of the Owner. Must be in ‘mm-dd-yyyy’ format. |
|
ownaddress |
123 Main St |
Required |
Street address where Owner resides. *Required if passing Merchant Beneficiary Owner Information. |
|
owncity |
Atlanta |
Required |
The name of the city where the Owner resides. |
|
ownstate |
GA | 2 |
|
Must be one of the standard 2 characters abbreviations. |
ownzip |
30346 |
Required |
The postal code where the Owner resides. |
|
ownemail |
janetest@test.com | Required |
Owner Email ID. | |
ownfirstname |
John |
Required |
Owner First Name. |
|
ownlastname |
Doe |
Required |
Owner Last Name. |
|
owntitle |
Owner |
Required |
This field contains the Title. |
|
ownpercent |
50 |
Required |
Percentage for Owner. Percentage should be in between 0 and 100. |
|
ownssn |
193458989 |
9 | Required |
Social Security Number of the Owner. Should be 9 digits |
owndob |
02-15-1990 |
9 |
Required |
Date of Birth of the Owner. Must be in ‘mm-dd-yyyy’ format. |
ownaddress |
123 Parkway Dr |
Required |
Street address where Owner resides. *Required if passing Merchant Beneficiary Owner Information. |
|
owncity |
Atlanta |
Required |
The name of the city where the Owner resides. |
|
ownstate |
GA |
2 | Required |
Must be one of the standard 2 characters abbreviations. |
ownzip |
99999 |
Required |
The postal code where the Owner resides. |
|
ownemail |
janetest@test.com |
Required |
Owner Email ID. |
















































































