网络与币种

商户在使用 open-api 进行下单操作时，需传入接收币种以及接收网络相关信息。其中，接收币种为必填项，需使用下方所提供的币种枚举进行传入。

币种枚举

定价币种（Pricing Currency）：显示商品/服务价格时所使用的单位（可以是法币或加密货币）。

支付币种（Payment Currency）：客户实际付款使用的币种（仅支持加密货币）。

法币

币种枚举	描述
USD	美元
HKD	港币

加密货币

币种枚举	合约地址	网络
ETH	-	Ethereum
USDT	0xdac17f958d2ee523a2206206994597c13d831ec7	Ethereum
USDC	0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48	Ethereum
HSK	0xe7c6bf469e97eeb0bfb74c8dbff5bd47d4c1c98a	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

网络枚举

以下为Spark支持的网络枚举信息：

网络枚举	网络名称
2	Ethereum
3	BNB Smart Chain
4	Polygon
5	IRISnet

填写示例

在使用统一收银台付款时，receive_network为选填项，若有多个网络需求，需用“,”进行拼接。

例如，若商户仅希望在 Polygon 网络上接收 USDT，则应传入“4”。

在使用统一收银台付款(专业版)时，available_payment_currency_networks为选填项。

如果商户希望，接收USDT(Ploygn、Ethereum)或者IRIS(Irshub)以及ETH(所有支持的网络)，那么填写参数如下：

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

            ]
        }
    ]
}

注意

open-api会校验支付币种在各个网络下按汇率计算后的数量是否 ≥ 最小服务费。最终下单的支付请求只包含符合条件的网络和币种，不符合的进行过滤。若全都不符合，则接口调用报错。

用户常见问题

Q1: 为什么我要选择“定价币种”？

A：定价币种只是用来展示价格，方便您理解。例如，您更熟悉美元，那商品可以显示为“100 USD”。

Q2: 我可以用美元支付吗？

A：不能，只能用加密货币支付。比如 USDT、ETH 等。但我们会自动根据当前汇率把 USD 金额换算成等值加密货币金额供您支付。

币种枚举#

网络枚举#

注意#

用户常见问题#

币种枚举

网络枚举

注意

用户常见问题