fluxa Merchant API

fluxa is a pluggable, multi-merchant payment gateway. Use one HMAC-signed Merchant API to create charges through enabled on-chain, card and local fiat channels such as LianLian, track orders, manage subscriptions and receive signed webhooks. Direct channels settle to your own wallet or Stripe account; custodial channels credit your Fluxa balance. Available channels and payment modes depend on your account and environment.

Getting started

Every request to the Merchant API is authenticated with an API key pair (a public key id pk_... and a secret sk_...) and signed with HMAC-SHA256. Create a key pair in the merchant portal, then read the Quickstart to make your first charge, and Authentication to learn the signing scheme.

Guides

Authentication

Sign every request with HMAC-SHA256.

Read more

Pagination

Page through list responses with limit and offset.

Read more

Errors

Understand the error envelope and status codes.

Read more

Webhooks

Receive and verify signed event notifications.

Read more

API reference

Charges

Create a charge to collect a payment across any channel.

Orders

List, retrieve and refund the orders behind your charges.

Subscriptions

Bill a customer on a recurring schedule.

Payouts

Withdraw your available wallet balance.