The Hello Clever API suite gives you everything you need to build payment experiences on top of Hello Clever’s fintech platform. This page introduces each API version, describes what it is designed for, and helps you choose the right one for your integration.

​
Base URLs

Each API version has its own base URL. Use the sandbox endpoint during development and switch to production when you go live.
Always use HTTPS for all API requests. Never send credentials over unencrypted connections.

​
API versions at a glance

API v1 — AUD Payment Gateway

The original Hello Clever payment gateway for Australian Dollar transactions. Supports PayID, PayTo, BSB/account number transfers, and AUD payouts. Also includes a cashback campaign integration. Use this API if you are operating exclusively in AUD and need PayID or PayTo support.

API v2 — Multi-Currency Payments

A full-featured payin and payout API that supports multiple currencies. Includes mobile money, virtual account bank transfers, customer and contact management, and bank lookup for VND. Use this API when you need to accept or send payments in currencies beyond AUD.

API v3 — Multi-Currency Gateway

A hosted gateway checkout API that handles all currencies through a single integration point. Provides a step-by-step integration flow and built-in webhook support for status changes. Use this API when you want a managed checkout experience without building payment form UI yourself.

Card API

Accepts card payments via a JavaScript SDK (client-side, AUD and USD) or a Server-to-Server (S2S) integration (server-side, AUD only). Supports card tokenisation for repeat payments, 3DS authentication, regular and unscheduled payment types, and refunds.

Cashback API

Manage cashback campaigns and rewards for your customers. Retrieve campaign lists and perform cashback operations. Use this API to power loyalty and rewards programs on top of your payment integrations.

​
When to use each version

​
Authentication

Every request to the Hello Clever API requires authentication using your app-id and secret-key. See the Authentication page for step-by-step instructions on obtaining credentials and passing them in your requests.

​
Webhooks

Hello Clever uses webhooks to notify your server when payment statuses change. See the Webhooks page for the full payload reference, status list, security setup, and retry behaviour.