Overview

Getting started with Sawfish

Welcome to the Sawfish Payments documentation hub. This guide will help you understand the available resources, how to use them, and what environments and test data are provided so you can begin integrating with Sawfish quickly. This site is intended for software engineers looking to integrate Sawfish Payments into their platform.

Sawfish is a powerful payments platform and engine custom-built for business. Removing compliance, fraud, risk, staffing, and operational headaches; Sawfish helps businesses focus on what matters most without the hassle.

Sawfish Payments supports international payments and multiple transaction types in a wide range of currencies.

Businesses can offer their customers the ability to pay using:

Real time payments (Australian NPP: PayID/PayTo)
Credit & Debit Cards

Sellers/payees can receive their funds by using:

Real time payments (Australian NPP: PayID/PayTo)
ACH Direct Credit

Sawfish provides you with an API to easily and quickly start taking payments in your products.

Available Integration Methods

Sawfish Payments supports multiple payment methods. Currently, Credit Card payments are supported, while PayID and PayTo are under development. The following integration methods are available:

GraphQL API Integration
Sawfish React Payment Widget (includes embedded UI and APIs)
iframe embeddable widget (beta, documentation not yet published)

How to Get Started

Here’s a recommended sequence for using these materials:

Review the Environment Details - Understand what base URLs and credentials you need. Know when to use staging vs production.
Read the Authentication Guide - Set up your access token / API key. Make sure you can successfully authenticate.
Explore the API Reference - Get familiar with the key endpoints you’ll need for your use case: e.g. transactions, payouts, webhooks, etc.
Use the User Flow Guide - Walk through the end-to-end flows relevant for your integration: from authentication, to initiating requests, handling responses, handling errors. Use those as checklists or templates.
Test with Test Cards / Mock Data - Use the test data provided (test cards, test credentials) to simulate different scenarios: success, failures, edge cases.

💬 Need Help?

Our team is here to support you. If you get stuck, email us - or if you would like to chat, request to join our Slack community by emailing hello@sawfish.com.au if you want to say hi to the team and connect with other Sawfish users!