接入API

POST /api/v2/order/info

请求

请求参数

名称类型是否必须描述
pidinteger(int64)项目编号
noncestring6位随机字符串
timestampinteger(int64)时间戳
signstring签名
cregis_idstringcregis订单编号
请求示例
{
    "cregis_id": "po20240703132452000",
    "pid": 1382528827416576,
    "nonce": "hwlkk6",
    "timestamp": 1688004243314,
    "sign": "d6eef2de79e39f434a38efb910213ba6"
}

返回

返回数据

名称类型描述
codestring返回码
msgstring返回信息
dataobject返回数据

返回数据 data 对象

名称类型描述
cregis_idstringcregis订单编号
order_idstring调用方订单编号
order_amountstring订单交易金额
order_currencystring订单交易金额单位
created_timeinteger(int64)订单创建时间【13位时间戳】, 例如:1750407942433
cancel_timeinteger(int64)订单取消时间 【13位时间戳】, 例如:1750407942433
transact_timeinteger(int64)订单支付完成时间【13位时间戳】, 例如:1750407942433
valid_timeinteger(int64)提交订单时设置的超时时间【单位/分钟】
statusstring订单支付状态
new - 订单初始状态
paid - 订单已成功支付
expired - 订单超出有效时间
paid_over - 付款超出订单金额
paid_partial - 付款小于订单金额
refund_requestedstring订单是否发生了退款
no:无退款申请记录
yes:有退款申请记录
refund_dataobject退款订单相关讯息
payer_idstring付款人信息
payer_namestring付款人名称
payer_emailstring付款人邮箱
remarkstring订单备注信息
payment_detailarray交易信息数组
payment_infoarray地址信息数组
order_detailsObject商品信息
settlement_statusstring结算状态【unsettled /settling/settled】
settlement_typestring结算类型 【system/manual】
sub_merchantstring子商户信息

payment_detail object

名称类型描述
payment_addressstring充值地址
from_addressstringfrom地址
receive_amountstring汇率转换后的订单金额
receive_currencystring汇率转换后的订单货币代码
pay_amountstring实际到账金额
pay_currencystring到账货币代码
exchange_ratestring货币汇率
tx_idstring交易hash
blockchainstring货币网络
token_namestring货币名称

payment_info object

名称类型描述
payment_addressstring充值地址
token_symbolstring货币标识
blockchainstring货币网络
token_namestring货币名称
logo_urlstring货币logo地址
token_decimalsinteger货币精度
receive_amountstring汇率转换后的订单金额
receive_currencystring汇率转换后订单货币代码
exchange_ratestring货币汇率
asset_logostring资产logo

refund_data object

名称类型描述
refund_idlongCregis退款订单编号
cregis_idlongCregis支付订单唯一编号
reference_idstring商家内部的原订单编号
recipient_idstring商家内部的客户编号
recipient_namestring退款收款人姓名
recipient_emailstring退款收款人邮箱
recipient_addressstring退款收款人的链上地址
tokenstring退款订单的币种填入加密货币token_name,格式:USDT-BEP20,USDT-TRC20
networkstring退款订单的网络 blockchain
refund_amountstring退款金额
refund_feestring退款所需gas fee
actual_refund_amountstring扣减矿工费后的实际退款金额 = 退款订单金额amount - gas_fee_amount
typeint退款类型
1:部分退款
2:全额退款
refund_statusint退款状态
0: 退款处理中
1:退款成功
2:退款失败
refund_tx_idstring退款交易哈希
refund_created_timestring退款订单创建时间【13位时间戳】
e.g. 1720508269092 即 2024-07-09 14:57:49 092
refund_transact_timestring退款订单最后更新时间【13位时间戳】
e.g. 1720508269092 即 2024-07-09 14:57:49 092
返回示例
{
    "code": "00000",
    "msg": "ok",
    "data": {
        "cregis_id": "po1420761885130752",
        "order_id": "merchant_order_id_123",
        "order_amount": "5",
        "order_currency": "HKD",
        "created_time": 1734328473070,
        "cancel_time": null,
        "transact_time": 1734328473872,
        "valid_time": 60,
        "status": "paid",
        "payer_id": "payer001",
        "payer_name": "payer",
        "payer_email": "[email protected]",
        "remark": "收银台备注",
        "payment_detail": [
            {
                "payment_address": "TUX9zGoPFVXd6RC7pg18nfVLATeN9vgBeX",
                "from_address": "THMxY6QeMYqACWs8fiL4VGBz2ZJRp4mDhT",
                "receive_amount": "10.00",
                "receive_currency": "USDT",
                "pay_amount": "10",
                "pay_currency": "USDT",
                "exchange_rate": "1",
                "tx_id": "d51bc829da5ad05c14f8f0a6ae16708129e485346ad91b8d5f2d33e490b91815",
                "blockchain": "TRON",
                "token_name": "USDT-TRC20"
            }
        ],
        "payment_info": [
            {
                "payment_address": "0xf9d70ab23195cfc9c0c14b384a1fd3a3f12cd4f8",
                "token_symbol": "USDT",
                "blockchain": "BNB-BSC",
                "token_name": "USDT-BEP20",
                "logo_url": "https://static.cregis.io/pic/coin/USDT-BNB%[email protected]",
                "token_decimals": 18,
                "receive_amount": "0.642951",
                "receive_currency": "USDT",
                "exchange_rate": "0.1285902181",
                "asset_logo": "https://static.cregis.io/pic/coin/tether%[email protected]"
            },
            {
                "payment_address": "TX8GZJfLYPtmzRgd3FoiXuCHbptiQ37NSM",
                "token_symbol": "USDT",
                "blockchain": "TRON",
                "token_name": "USDT-TRC20",
                "logo_url": "https://static.cregis.io/pic/coin/[email protected]",
                "token_decimals": 6,
                "receive_amount": "0.642951",
                "receive_currency": "USDT",
                "exchange_rate": "0.1285902181",
                "asset_logo": "https://static.cregis.io/pic/coin/tether%[email protected]"
            }
        ],
        "order_details": {
            "items": [
                {
                    "item_id": "1",
                    "item_name": "Product1",
                    "item_price": 123,
                    "price_currency": "HKD",
                    "item_quantity": 1
                },
                {
                    "item_id": "1",
                    "item_name": "Product2",
                    "item_price": 124,
                    "price_currency": "HKD",
                    "item_quantity": 1
                }
            ],
            "shopping_cost": 10.88,
            "tax_cost": 100
        },
        "settlement_status": "unsettled",
        "settlement_type": "",
        "sub_merchant": {
            "sub_merchant_id": "123",
            "sub_merchant_name": "kg"
        }
    }
}