Change Log

This document describes the changes made to the API over time. It is intended to help you understand what has changed and what you need to do to adapt your code to the new version.

1.0.20 - 2026-07-31

Added

1. Added the initiate batch withdrawal request interface。

Changed

1. Changed the field definitions of the withdrawal related interfaces.

1.0.19 - 2026-07-03

Added

1. Added the batch terminate subscriptions interface.
2. Added the initiate automatic refund request interface.

1.0.18 - 2026-05-25

Added

1. Added the query pending sweeping sub-contract list and query pending sweeping blacklist sub-contract list interfaces.
2. Added the batch create user sub-contracts interface.
3. Added sweeping and fund withdrawal callback notifications.
4. Added the query energy balance interface.
5. Added the query chain configuration addresses interface.
6. Added the query sweeping details interface.
7. Added the query fund withdrawal details interface.
8. Added the query max fund withdrawal amounts interface.

Changed

1. Added userWalletAddresses and userWalletIds fields to the signer's sweeping signing form SignAggregateForm.
2. Added the orgId field to recharge, withdrawal, sweeping callback, fund withdrawal callback, and their detail objects in the merchant API.

1.0.17 - 2026-05-07

Added

1. Added subscription related interfaces.

1.0.16 - 2026-03-10

Added

1. Added user sub-contract tag management related interfaces.
2. Added abnormal payment order related interfaces.

Changed

1. Added creation time, sub-contract address, and tag query conditions to the query user sub-contract list interface.
2. Added tagId field to the userWallet object to associate with tags.
3. Added tagName field to the request body of the create payment order interface.

1.0.15 - 2025-08-25

Changed

1. Signer's sign transaction interfaces now require the withdrawItems parameter to support withdrawal order validation.

1.0.14 - 2025-07-10

Changed

1. Added energy purchase related fields to the return value of the query on-chain transaction information interface.
2. Added sortOrder parameter to the query withdrawal list interface.

1.0.13 - 2025-07-02

Changed

1. All interfaces of the signer will return the transaction hash (txHash) when the transaction is successful.

1.0.12 - 2025-06-19

Added

1. Added an interface to add a user's wallet to the blacklist.
2. Added interfaces for signer to sign sweeping.

Changed

1. Added gasFee and getEnergyUsage fields to the return value of the query on-chain transaction information interface.

1.0.11 - 2024-09-04

Removed

1. Removed some interfaces used by the signer.

1.0.10 - 2024-06-13

Added

1. Add the broadcast fund withdrawal interface used by the signer.
2. Add the get balance interface to query the balance of a specified contract address.

Changed

1. The URL of the estimate transaction fee interface is migrated to /transaction/estimate, and the original URL will be deprecated in future versions.

1.0.9 - 2024-04-28

Added

1. Add transferHash to query params of the order list APIs, including recharge, withdrawal, payment, and refund.
2. Add APIs to initiate callback notifications for recharge, withdrawal, payment, and refund.
3. Add a new API to query transaction informationn on the chain.