Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.ionicfi.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Hey there! 👋

Welcome to Ionic’s developer docs. We’re here to help you get payments up and running quickly and securely. Whether you’re building a brand new checkout experience or upgrading an existing one, we’ve got you covered with flexible integration options that actually make sense for how you work.

​
Pick Your Integration Style

Here’s what works best for most developers:

Collect Checkout

Easiest - Hosted checkout page. Send customers to us, we handle everything, send them back. No code, no complexity.

Ionic Payment Buttons

Quick Start - Pre-built payment buttons that handle the entire checkout flow. Just embed and go, with or without code.

Collect.js

Most Popular - Drop in our JavaScript library for custom checkout pages. Handles tokenization automatically so you never touch card data.

Payment API

Full Control - Direct API integration for when you need complete control over the payment flow. Perfect for custom implementations.

Gateway.js

Enhanced Security - Add 3D Secure authentication and fraud detection to any integration.

​
Other Integration Options

For in-person payments with card readers and POS devices. Great for retail and mobile businesses.Learn more →
Legacy redirect-based integration. Note: We recommend using Collect.js or Collect Checkout for new integrations instead.Learn more →

​
What You Can Accept

Cards

Visa, Mastercard, Amex, Discover, and more

Bank Payments

ACH and eCheck transactions

Digital Wallets

Apple Pay and Google Pay

In-Person

EMV chip, contactless (tap), and swipe

​
Built-In Features You’ll Love

Recurring Billing - Set up subscriptions and automatic payments without the headache. Customer Vault - Securely store payment info for one-click checkouts. We handle the PCI compliance stuff. Advanced Security - 3D Secure authentication, fraud detection, and Level 1 PCI certified infrastructure. Smart Commerce - Level II/III processing for B2B, HSA/FSA support, and payment facilitator capabilities.

​
Getting Started (It’s Easy!)

1

Pick your integration method

Choose what makes sense for your tech stack. Collect Checkout is the simplest - just redirect to our hosted page. Want more control? Try Collect.js.
2

Get your API key from the dashboard

Log into the Ionic Dashboard, switch to test mode, and generate your API key.
3

Build and test

Use our testing guide with test card numbers and amounts.
4

Go live

Turn off test mode in the dashboard to start processing real payments. Test mode transactions are simulated only and not actually processed.

Testing Guide

Test card numbers, amounts, and everything you need to verify your integration

Response Codes

What do all those response codes mean? We’ve got you covered.

Webhooks

Get real-time notifications when things happen (payments, refunds, disputes, etc.)

Customer Vault

Store payment methods securely for returning customers

​
Need Help?

We’re here for you: Let’s get you accepting payments! 🚀