| Environment | Base URL |
|---|---|
| Sandbox | https://enrollment-api-sandbox.paymentshub.com |
| Production | https://enrollment-api.paymentshub.com |
| Authentication | https://enrollment-api-auth.paymentshub.com |
How To Start
- Sign up for a free North Developer account.
- Contact us to set up an Agent ID and get test credentials. Once test credentials are provisioned, they can be referenced when logged in by selecting the User profile icon in the top right corner of the screen and selecting Credentials. The test credentials consist of a Client ID and Client Secret. The Client ID will be associated with your Agent ID, and using it will provide access to all merchant applications associated with your ID.
- Use the API specification or the Postman Collection to build your app against the test environment. When logged in, you can use the Integration Tracker to view the status of your integration, notes from meetings with Integration Engineers, resources related to your solution, and more by clicking the User profile icon in the top right corner of the screen and selecting Integrations.
- When development is complete, contact us and once we ensure things are working properly, you will receive Production credentials that will be associated with your Agent ID. Your Production credentials will provide access to all merchant applications associated with your Agent ID.
How To Test
Contact us for test credentials that can be used to try out the payment API in a test environment. Once test credentials are provisioned, they can be referenced when logged in by selecting the User profile icon in the top right corner of the screen and selecting Credentials. The test credentials consist of a Client ID and Client Secret. The Client ID is associated with an Agent ID, and using it will provide access to all merchant applications under the associated agent.
The following set of Merchant IDs (MIDs) and application external keys are preconfigured with various Underwriting statuses for you to test with in the Sandbox environment. See the Underwriting Status Descriptions section for details about what each status means.
| Underwriting Status | Sandbox Test MID | Sandbox Test External Key |
|---|---|---|
| Approved (A) | 1122923014539 | c377bc29-5290-491d-9261-9fcad60b6d5e |
| Approved - Collections (AC) | 2233837440794 | c389bc29-5290-491d-9261-9fcad60b6d5e |
| Approved - Conditional (A) | 3344750572822 | d477bc29-5290-491d-9261-9fcad60b7e6f |
| Declined (D) | 4455648061691 | e577bc29-5290-491d-9261-9fcad60b8f7g |
| Pending (P) | 5566595480122 | f677bc29-5290-491d-9261-9fcad60b9g8h |
| Pending (PX) | 6677426246898 | g877bc29-5290-491d-9261-9fcad60b0h9i |
How To Authenticate
Authentication is required every time an API request is made. Authentication is granted through the use of a token. A token is granted when a user calls the Authentication endpoint and submits a matching Client ID and Client Secret pair. A Client ID and Client Secret are provided when a user initially requests access to the API.
When calling any endpoint, first call the auth endpoint to obtain a bearer token which is valid for 5 minutes, and use that token in subsequent API calls within the timeframe. The header content should look like the following:
Authorization: Bearer Token
Each token is a signed JWT that expires 5 minutes after its creation. Each time a token is submitted with a call, it is verified to be valid and not expired. If the token expires, the user must retrieve a new token by calling the authentication endpoint and submitting a matching Client ID and Client Secret again. The same token can be used for all endpoints, until it expires. The Client ID is associated with an Agent ID and that API key will be able to access all merchant applications under that agent.
Underwriting Status Descriptions
| Underwriting Status Code | Underwriting Status Description |
|---|---|
| A | Approved: The account has been approved by Underwriting to process payments. |
| A | Approved - Conditional: The account has been approved by Underwriting to process payments with a funding reserve. |
| AC | Approved - Collections: The merchant has an unresolved collections balance and the account is being managed internally by the Collections department. |
| B1 | Enrollment: The application has not yet been submitted to Underwriting. |
| C | Closed: The merchant has closed their account and is no longer processing payments |
| CC | Closed - Collections: The merchant's prior collections balance has been satisfied and the account is closed. |
| CR | Closed - Risk: The account has been closed by Risk due to failure to process within the approved parameters of the merchant's agreement. |
| D | Declined: The account has gone through the Underwriting approval process and has been declined to process payments. |
| DX | Declined - Threatmatrix: The account was declined during the application process due to the use of an unaccepted IP address. |
| F | Fraud: The account has been closed due to fraudulent activity. |
| P | Pending: The application has been submitted and is under review by our Underwriting team. Merchant action may be required to bring the application to Approved status. |
| PM | Enrollment: The application has not yet been submitted to Underwriting. |
| PX | Pending: The application has been submitted and has not yet been reviewed by Underwriting. |
| W | Withdrawn: The merchant or sales agent has withdrawn the account prior to it being approved. |