TandemPay

Documentation

Integration guides, API reference, and resources for building with TandemPay

Getting Started

Integration Overview

Understand TandemPay's payment flow, settlement process, and non-custodial architecture before integrating.

See How It Works →

API Reference

Explore the live API contract, request schemas, response examples, authentication, and signed webhook behavior.

Read the API guide →
W

Using WooCommerce?

Plugin available

Install the TandemPay plugin to add embedded checkout, synchronize WooCommerce order statuses, and receive verified payment updates without building directly against the API.

Available from your merchant dashboard after approval.

Apply for merchant access

Core Concepts

Payment Gateway Integration

Embed TandemPay checkout in your application using our JavaScript SDK or server-side API. Support for multiple integration patterns: hosted checkout, embedded forms, and API-driven flows.

// Create a checkout session
const session = await tandemPay.checkout.create({
amount: 100.00,
currency: 'USD',
successUrl: 'https://your-store.com/success',
cancelUrl: 'https://your-store.com/cancel'
});

See the API reference for authentication, complete schemas, and webhook events

Webhooks & Events

Receive real-time notifications for payment events: successful transactions, settlement completion, and status updates. Configure webhook endpoints in your merchant dashboard.

payment.completedCustomer payment successful
settlement.confirmedFunds settled to your wallet
payment.failedPayment processing failed

Wallet Configuration

Configure settlement wallet addresses in your merchant dashboard. Smart contracts enforce these addresses for non-custodial settlement. Supports hot wallets, cold storage, and multi-signature configurations.

Best Practices

  • • Use hardware wallets or secure key management systems
  • • Test with small amounts before processing large volumes
  • • Consider multi-signature wallets for high-value settlements
  • • Verify addresses carefully — TandemPay cannot reverse settlements

Testing & Sandbox

Test your integration in a sandbox environment before going live. Sandbox access and test credentials provided in merchant dashboard after approval. Test all payment flows, webhook delivery, and settlement scenarios without real funds.

SDKs & Platform Guides

JavaScript / TypeScript

SDK available

React / Next.js

SDK available

Node.js

SDK available

Python

REST examples

PHP

REST examples

Ruby

REST examples

Need Help?

For integration assistance, technical questions, or developer support, contact our team.

contact@tandempay.ioRead FAQ →

Not a Merchant Yet?

Apply to become a merchant and get access to full API documentation, sandbox environment, and integration support.

Apply Now

Additional Resources

Security Architecture →How It Works →Pricing & Fees →