Welcome to TagadaPay API Documentation

TagadaPay is a comprehensive payment processing platform that enables businesses to accept payments globally with advanced features like subscription management, risk assessment, and multi-currency support.

Two Ways to Use a TagadaPay Checkout

There are two main paths to integrate TagadaPay into your business:

Direct Link (Any Website)
Shopify / WooCommerce Integration

Use TagadaPay from any website, landing page, or app — no e-commerce platform required.A direct link redirects your customer to your TagadaPay-hosted checkout. You generate it client-side with a simple JavaScript function — no server, no API key needed.

Your Website → Direct Link → TagadaPay Checkout → Thank You
(any page)     (generated      (hosted on your
                client-side)     custom domain)

How it works:

Add a small JS helper to your page (see guide)
Build a checkout URL with your storeId and product variant IDs
Redirect the customer on button click

// That's it — no auth, no server
window.location.href = createCheckoutUrl({
  baseApiUrl: 'https://app.tagadapay.com/api/public/v1/checkout/init',
  checkoutUrl: 'https://secure.yourdomain.com/checkout',
  storeId: 'store_abc123',
  items: [{ variantId: 'variant_xyz', quantity: 1 }],
});

Direct links can also be generated from the CRM dashboard — no code needed. Go to Storefront → Direct Links.

Want analytics and funnels too? If your landing page is part of a funnel (e.g., landing → checkout → upsell → thank you), add the External Page Tracker to your external page. It connects your page to TagadaPay’s funnel orchestrator and analytics — tracking page views, device data, and enabling funnel navigation.

Use TagadaPay as your store’s checkout — replaces the default Shopify or WooCommerce checkout.TagadaPay integrates directly with your e-commerce platform. Customers go through your store normally, and when they reach checkout, they’re seamlessly redirected to your TagadaPay-hosted checkout.

Shopify Store → Add to Cart → TagadaPay Checkout → Order in Shopify
(your theme)    (normal flow)   (hosted, custom      (synced back)
                                 domain)

How it works:

Connect your Shopify or WooCommerce store in the CRM dashboard
TagadaPay syncs your products and variants
Deploy your checkout (built-in templates or custom plugin)
Enable the checkout redirect on your store

Connect Shopify

Step-by-step Shopify connection guide

Connect Store

General integration setup

The tracker is injected automatically for Shopify/WooCommerce integrations — analytics and funnel tracking work out of the box.

Summary

	Direct Link	Shopify / WooCommerce
Best for	Landing pages, custom sites, apps	E-commerce stores
Setup	Add JS snippet, no auth needed	Connect store in CRM
Products	Pass variant IDs in the URL	Synced from your store
Funnel analytics	Add External Tracker	Automatic
Direct links from CRM	Yes	Yes

Quick Start

Direct Link Guide

Generate checkout URLs from any website

External Page Tracker

Add funnel analytics to external pages

Plugin SDK

Build custom checkout experiences with React

Plugin CLI

Deploy and manage plugins from the command line

Hosting & A/B Testing

Host static pages and run A/B tests

API Reference

Full REST API documentation

Core Features

Payment Processing

Multi-currency support: Accept payments in 150+ currencies
Payment methods: Cards, digital wallets, bank transfers, and more
Smart routing: Intelligent payment routing for optimal approval rates
3DS authentication: Secure customer authentication for compliance

Subscription Management

Flexible billing: Support for various billing cycles and models
Dunning management: Automated retry logic for failed payments
Proration: Automatic calculations for plan changes
Trial periods: Flexible trial configurations

Developer Experience

RESTful API: Clean, predictable API design
Real-time webhooks: Instant notifications for all events
Plugin System: Build custom checkout experiences and landing pages
CLI Tools: Deploy and manage plugins from the terminal
React SDK: Modern React hooks and components for plugin development
Hosting & A/B Testing: Host pages on TagadaPay’s edge network with built-in split testing

API Environments

Environment	Base URL	Purpose
Production	`https://app.tagadapay.com/`	Live transactions
Development	`https://app.tagadapay.dev/`	Testing and development
Local	`http://app.localhost:3000/`	Local development

Support

Need help? We’re here for you:

Email: api-support@tagadapay.com
Documentation: Browse our comprehensive guides
GitHub: Report issues

This documentation is continuously updated. For the latest information, always refer to this online version.

Getting Started

​Welcome to TagadaPay API Documentation

​Two Ways to Use a TagadaPay Checkout

Connect Shopify

Connect Store

​Summary

​Quick Start

Direct Link Guide

External Page Tracker

Plugin SDK

Plugin CLI

Hosting & A/B Testing

API Reference

​Core Features

​Payment Processing

​Subscription Management

​Developer Experience

​API Environments

​Support

Welcome to TagadaPay API Documentation

Two Ways to Use a TagadaPay Checkout

Summary

Quick Start

Core Features

Payment Processing

Subscription Management

Developer Experience

API Environments

Support