developer.heartlandpaymentsystems.comDevelopers | Heartland Payment Systems

Get Started Card Payments Check Payments Recurring Payments Gift & Loyalty Payments Fraud Plugins & Integrations Reporting Demo Heartland Pay App Other Solutions Fully Integrated POS Middleware Connectors Portico Gateway Documentation API Overview Gift & Loyalty Bill Pay Payroll Introduction Developer Support Authentication Credit Card Gift Card eCheck & ACH Recurring Reporting Error Handling Semi-Integrated Devices Heartland Profac Global Payments eCommerce Tokenization Demo Testing Knowledge Center GitHub Partnerships Get sandbox account Get sandbox account Get Started Getting Started Online Payments In-Person Payments Internet of Things (IoT) Testing & Certification Other Click an option below for steps on getting started with your integration. Online/Card Not Present In Person/Card Present Bill Pay Not Sure/Other Ecommerce Overview An overview of our Ecommerce products. Card Payments Tokenize and take payments with credit cards. Check Payments Take payments with ACH/eCheck. Gift & Loyalty Payments Take payments with gift and loyalty. Recurring Payments Take tokenized, subscription card and check payments. Fraud Stop fraud before the payment is complete. Plugins & Integrations Plugins for leading carts, platforms and online ordering. Reporting Pull transactions and details for a date range. Demo How Heartland tokenization works Ecommerce Plugins & Integrations Get up and running quickly and easily with our feature-rich extensions into the world’s leading retail shopping carts and Ecommerce platforms. Browse All References Explore our SDK documentation and get started with our in-depth guides to each request and response type. SDK Documentation Useful Resources Test Cards Support Logos and Assets Portico Gateway Semi Integrated This solution allows you to build requests from your POS to an already EMV certified payment application. This type of integration is the desired route for anyone looking to integrate quickly to Heartland. Fully Integrated This solution allows you to build requests from the ground up allowing you to fully customize the solution. This type of integration is the desired route for anyone looking for full control over the integration to Heartland. POS EMV Middleware Connectors Heartland for MicrosOPI & Aloha Learn More Terminals Check out terminal and hardware options for semi-integrated payments. Learn More Portico Gateway Documentation Heartland Portico Gateway Documentation Learn More References Explore our SDK documentation and get started with our in-depth guides to each request and response type. SDK Documentation Useful Resources Test Cards Support Logos and Assets Portico Gateway IoT Overview An overview of our IoT offerings. Payments Credit, Debit and gift payments. eWallet Securely vault credit and debit cards. Subscriptions Take subscription payments. Stored Value Save money by avoiding frequent small charges. Loyalty Extend offers to customers. API Overview An overview of a few of Heartland’s APIs. Gift & Loyalty Direct, non-SDK integration to gift & loyalty. Bill Pay Explore solutions for paying invoices and bills. Payroll Explorer payroll, time and attendance. References Explore our SDK documentation and get started with our in-depth guides to each request and response type. SDK Documentation Useful Resources Test Cards Support Logos and Assets Portico Gateway Certification & Testing The certification process will differ depending on the solutions and equipment in your unique integration with Heartland. Integration type Choose your integration type to get started with certification. ECommerce Semi Integrated Devices Other To receive production keys for a customized payment solution created using our SDKs, you must begin certification following the steps below. **The use of a Plugin does NOT require this process. If you are using an existing Heartland plugin or extension, or have previously certified your solution in the past, please reach out to your Relationship Manager or our Online Payments Team with questions.** Creating a custom payment solution using our SDKs Register for an account on the Heartland Developer Portal (if you haven’t already). Fill out the CRF (Certification Request Form here). Upon receiving your completed CRF, you will receive a developer ID, version number, and test cases. The transaction value(s)/dollar amount needs to be run as requested so we can retrieve the correct data for all card brands that are being certified. If the developer needs to test a different value they must let us know what value/dollar amount is being tested and what card brand the amount is being assigned to. There shouldn’t be any exceptions aside from the whole dollar amount vs having change on the amount being tested. Once the tests have been completed, click the link in the body of the certification credentials eMail. This will send an eMail notification to the Online Payments Team that you have completed all your test cases in order and they are ready to be checked. If a transaction needs to be re-processed, the Online Payments team will advise. Upon successful completion of the test script, you will receive a Certification Announcement Letter via email. **Note: if you have not received your certification announcement, please reach out to onlinepayments@heartland.us to verify your test cases were completed successfully** Certification is required for any integration wishing to receive production API keys for card-not-present payment processing. If you have any questions about the process, please reach out to our support team at onlinepayments@heartland.us . Fill out the form below to begin certification. If you do not see the form, you must create an account by clicking the "Get Sandbox Account" button on this site. If you have already created an account click "Sign In". Once you are ready to certify your card-present integration, fill out the Validation Request Form (VRF) and one of our team members will start the process with you. Browse Heartland Pay App Devices or Other Solutions . Fill out the VRF . Upon receiving your completed VRF, we will determine your need for a test device and provide test cases based on your responses in the Validation Request Form. Respond to that email for integration questions or reach out to us at integratormanagement@e-hps.com once you have processed the requested transactions. Our Integration team will check each transaction to make sure all data is correct for compliance purposes. We will alert you of any issues or changes you’ll need to make, or finalize a certification announcement letter based on our review. Certification is required for any integration for card-present payment processing. If you have any questions about the process, please reach out to our support team at integratormanagement@e-hps.com . This section can pertain to certifications including Portico, Petro, Ecommerce, MOTO, lodging, retail, restaurant, MSR, ACH, EMV, Gift, Recurring Payments and more Review Portico or Portico Exchange Certification Process . Work with Heartland Integration Team to discuss integration: integratormanagement@e-hps.com Send Certification Request Form to Integrator Management integratormanagement@e-hps.com . Develop and test your integration. Contact us with any questions. Once your development is complete, work with your assigned certification analyst to complete required tests. EMV Integrators Guide EMV Documentation SOAP UI Examples BIN Guide Support If you have been assigned a Portico or Exchange integration you may reach out to Portico Integration Support or Exchange Integration Support References Explore our SDK documentation and get started with our in-depth guides to each request and response type. SDK Documentation Useful Resources Test Cards Support Logos and Assets Portico Gateway Getting Started Online Payments Choose an option below to continue through the online payment/card not present integration path. I am using a Plugin?(WooCommerce, WordPress, Drupel, etc) I...