
Go client integration
Standard library only. Creates deposit addresses and checks the signature on every callback.
Read the API quick startRequirements
- Go 1.24 or newer. The client uses only the standard library.
- A gateway base URL, payout wallet and public callback URL. Public calls need no API key.
Install and configure
- Add github.com/Suawave-Payment-System/suawave/sdk/go to your module and import it as suawave.
- Create a client with suawave.New, a gateway base URL and an empty credential for public operations.
- Call PublicCreate with a ticker, payout address and a unique callback URL for each order. Display AddressIn and the required token amount in your application.
- Fetch PublicCallbackKey once and cache it. VerifyRequest checks the original callback bytes; persist callback UUIDs in the same transaction as your order update and acknowledge stored events with AckPublicCallback.
What the buyer sees
Your application builds the payment screen from the returned address and amounts. The client provides API calls and callback verification, rather than a hosted checkout or automatic shop order updates.
Payment behavior
- PublicInfo, PublicLogs, PublicEstimate, PublicQRCode and conversion helpers cover the public API. Amounts remain decimal strings.
- Fulfil only after a verified confirmed callback. The included ReplayGuard is in memory for a single process; durable order processing needs a database uniqueness check for each callback UUID.