Network and Currency

When merchants use the open-api to place orders, they need to provide information about the receiving currency and the receiving network. The receiving currency is a required field, and it must be passed using the currency codes provided below.

Currency Code	Contract Address	Network
ETH	-	Ethereum
USDT	0xdac17f958d2ee523a2206206994597c13d831ec7	Ethereum
USDC	0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48	Ethereum
POL	-	Polygon
USDT	0xc2132d05d31c914a87c6611c10748aeb04b58e8f	Polygon
USDC	0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359	Polygon
IRIS	0x1D1530e3A3719BE0BEe1abba5016Cf2e236f3277	IRISnet
BNB	-	BNB Smart Chain
USDT	0x55d398326f99059ff775485246999027b3197955	BNB Smart Chain
USDC	0x8ac76a51cc950d9822d68b83fe1ad97b32cd580d	BNB Smart Chain

Network Enum	Network Name
2	Ethereum
3	BNB Smart Chain
4	Polygon
5	IRISnet

Example

When using Unified Payment Page, the receive_network field is optional. If multiple networks are required, they should be joined with commas.

For example, if the merchant only wants to receive USDT on the Polygon network, the value should be "4".

When using Unified Payment Page_PRO, the available_payment_currency_networks field is optional.

If the merchant wishes to receive USDT (on Polygon and Ethereum), IRIS (on IRISnet), and ETH (on all supported networks), the parameter should be configured as follows:

{
    "available_payment_currency_networks": [
        {
            "currency": "USDT",
            "networks": [
                2,
                4
            ]
        },
        {
            "currency": "IRIS",
            "networks": [
                5
            ]
        },
        {
            "currency": "ETH",
            "networks": [

            ]
        }
    ]
}

Note

The open-api will verify whether the amount of the payment currency, calculated based on the exchange rate on each network, is greater than or equal to the minimum service fee. The final payment request will only include the networks and currencies that meet this condition. Those that do not will be filtered out. If none meet the criteria, the API call will return an error.

Example#

Note#

Example

Note