Custom Plugin
How Feemaker plugins receive payments — no extra infrastructure required.
Step 1: Generate a Payment Address
To start receiving payments, all you need is your Ethereum address. Pass it as the ownerAddress along with a unique index (such as a user ID or order ID):
https://api.feemaker.io/getAddress?ownerAddress=0x1234...1234&index=1
Each unique index generates a deterministic payment address tied to your ownerAddress. Use a different index for each customer or order to easily track who paid.
Step 2: Redirect to Checkout
Once you have the generated payment address, redirect the customer to the Feemaker checkout page:
https://checkout.feemaker.io/?to=0x9cC6...c481&value=10&data=0x&chainId=11155111&token=0xF7a5...d077&description=Order+123
| Parameter | Description |
|---|---|
to | The payment address generated in Step 1 |
value | The payment amount |
data | Transaction data (use 0x for standard transfers) |
chainId | Blockchain chain ID (e.g. 1 for Ethereum Mainnet, 11155111 for Sepolia) |
token | The token contract address (e.g. USDT, USDC) |
description | A human-readable description (e.g. order number) |
The checkout page handles the payment UI — the customer pays directly from their wallet.
Step 3: Listen for Payment Events
To receive notifications about incoming transactions, use long polling — no need to run a public gateway or configure webhooks:
https://api.feemaker.io/events?ownerAddress=0x1234...1234&secretSessionId=YOUR_SECRET_KEY
The secretSessionId is a unique key you generate to reserve resources for your application. Keep this key private and do not share it.
The request will wait until a new payment event occurs, then return the transaction details. Simply repeat the request to continue listening.
For more details, see the full documentation at docs.feemaker.io.
Plugin Configuration
When configuring any Feemaker plugin, you will need:
| Parameter | Description |
|---|---|
ownerAddress | Your Ethereum address that will receive payments |
secretSessionId | A private key you generate for receiving payment notifications |
chainId | The blockchain chain ID for your network |
tokenAddress | The token contract address for payments |
These replace the traditional API Key / IPN secret key approach — Feemaker works directly with the blockchain, so there are no third-party API keys to manage.
Don't see your platform listed? Contact us at support@feemaker.io and we will build a custom plugin tailored to your platform.