Before you begin
Before using AinePay, create an account first.
1. Merchant status
After you register, the dashboard shows a processing-fee deposit address. You need to top up any amount above 10 USD to activate payment features; this balance is used to deduct fees when your customers pay. When the balance drops below 0 USD, merchant status becomes inactive—AinePay sends you an email reminder to top up before that happens.
2. Enable two-factor authentication
You must enable two-factor authentication on the Profile page before you can configure the other required settings.
3. Set your fund collection address
The fund collection address is the address you designate to ultimately receive payment funds. Your customers’ payment addresses are all deterministically derived from this collection address according to the smart contract, so be sure this address belongs to you.
You can configure multiple collection addresses. When creating an order, you can specify which one to use. If you do not specify one, AinePay uses your latest collection address by default.
Once you complete the three steps above, you can start using Payment Links. If you want to use the plugin or API integration, the following steps are also required.
4. Create your merchant API keys
AinePay provides two kinds of merchant keys to keep information secure. You fill them in when using the payment plugin, and they are also needed for API integration.
Key secrets are shown only once when first created, and are permanently hidden afterwards. If you forget a secret, delete that key and create a new one. Keep these keys safe.
For the full signing and verification flow, see API Authentication.
5. Set your notify URL
The notify URL is where your site receives the payment messages AinePay pushes to you. Because AinePay tests this link when you set it, you need to have your site ready beforehand, otherwise the setup will fail.
The notify URL is used by both the plugin and API integration, and must be a valid HTTPS link. See the Webhooks section for the detailed callback model and notification fields.
If you only want to use Payment Links or the payment plugin, the documentation so far is enough. If you want to use API integration, continue with the API Reference section that follows.