SparkPay OpenAPI 文档
简体中文
  • 简体中文
  • English
简体中文
  • 简体中文
  • English
  1. 接入必读
  • 产品介绍
  • 快速指引
    • 接入准备
    • 接口加签说明
  • 接入必读
    • 接口规则
    • 异步通知
    • 接口错误码
    • 网络与币种
  • 对接场景
    • 支付
    • 关闭订单
  • API列表
    • 统一收银台付款
      POST
    • 支付订单关闭
      POST
    • 支付订单查询
      GET
    • 统一收银台付款(专业版)
      POST
    • 支付订单查询(专业版)
      GET
  • 常见问题
    • 通知相关问题
    • 跳转失败问题
    • 接口报错提示问题
    • 测试币领取/测试网连接
  • 对接示例
    • 接口签名示例-Postman
    • 接口签名示例-php
  • 版本说明
    • 版本说明
  1. 接入必读

网络与币种

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

币种枚举#

币种枚举合约地址网络
ETH-Ethereum
USDT0xdac17f958d2ee523a2206206994597c13d831ec7Ethereum
USDC0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48Ethereum
HSK0xe7c6bf469e97eeb0bfb74c8dbff5bd47d4c1c98aEthereum
POL-Polygon
USDT0xc2132d05d31c914a87c6611c10748aeb04b58e8fPolygon
USDC0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359Polygon
IRIS0x1D1530e3A3719BE0BEe1abba5016Cf2e236f3277IRISnet
BNB-BNB Smart Chain
USDT0x55d398326f99059ff775485246999027b3197955BNB Smart Chain
USDC0x8ac76a51cc950d9822d68b83fe1ad97b32cd580dBNB Smart Chain

网络枚举#

以下为Spark支持的网络枚举信息:
网络枚举网络名称
2Ethereum
3BNB Smart Chain
4Polygon
5IRISnet
填写示例
在使用统一收银台付款时,receive_network为选填项,若有多个网络需求,需用“,”进行拼接。
例如,若商户仅希望在 Polygon 网络上接收 USDT,则应传入“4”。
在使用统一收银台付款_PRO时,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会校验支付币种在各个网络下按汇率计算后的数量是否 ≥ 最小服务费。最终下单的支付请求只包含符合条件的网络和币种,不符合的进行过滤。若全都不符合,则接口调用报错。
修改于 2025-05-06 09:08:45
上一页
接口错误码
下一页
支付
Built with