跳到主要内容

获取Pay交易历史记录(USER_DATA)

接口描述​

获取Pay交易历史记录

HTTP请求​

GET /sapi/v1/pay/transactions

请求权重(UID)​

3000

请求参数​

名称类型是否必需描述
startTimeLONGNO
endTimeLONGNO
limitINTNO默认 100, 最大 100
recvWindowLONGNO
timestampLONGYES
  • 若startTime和endTime均未发送,只返回最近90天数据
  • startTime和endTime的最大时间间隔为90天
  • 支持查询日期范围：近18个月以内的订单
  • 对于payerInfo和receiverInfo，在不同的orderType会有不同的返回值
    • orderType为C2C时的发送方视角
      • payerInfo : binanceId
      • receiverInfo : name, binanceId/accountId/email/countryCode/phoneNumber/mobileCode（根据用户的输入返回）
    • orderType为C2C时的接收方视角
      • payerInfo : name, accountId
      • receiverInfo : binanceId
    • orderType为CRYPTO_BOX的发送方视角
      • payerInfo : binanceId
      • receiverInfo : name(值为"Crypto Box")
    • orderType为CRYPTO_BOX的接收方视角
      • payerInfo : name, accountId
      • receiverInfo : binanceId
    • orderType为C2B的发送方视角
      • payerInfo : binanceId
      • receiverInfo : name
    • orderType为C2B的接收方视角
      • payerInfo : name, accountId
      • receiverInfo : binanceId, name
    • orderType为PAY_REFUND的退款发起方视角
      • payerInfo : binanceId, name
      • receiverInfo : name, accountId
    • orderType为PAY_REFUND的退款接收方视角
      • payerInfo : name
      • receiverInfo : binanceId
    • orderType为PAYOUT的发送方视角
      • payerInfo : binanceId, name
      • receiverInfo : name, accountId
    • orderType为PAYOUT的接收方视角
      • payerInfo : name
      • receiverInfo : binanceId
    • orderType为CRYPTO_BOX_RF的接收方视角
      • payerInfo : name(值为"Crypto Box")
      • receiverInfo : binanceId
    • orderType为REMITTANCE的发送方视角
      • payerInfo : binanceId
      • receiverInfo : name, institutionName, cardNumber, digitalWalletId

响应示例​

{
   "code": "000000",
   "message": "success",
   "data": [
   {
       "orderType": "C2C", //交易类型 枚举值：PAY（C端用户在商户侧消费）, PAY_REFUND（C端用户商户侧消费，退款）, C2C（C端用户间的转账）,CRYPTO_BOX（红包交易）, CRYPTO_BOX_RF（红包交易，退款）, C2C_HOLDING（C端用户转账给非币安用户）, C2C_HOLDING_RF（C端用户转账给非币安用户，退款）, PAYOUT（商户给其用户付款）, REMITTANCE（汇款）
       "transactionId": "M_P_71505104267788288", //流水编号
       "transactionTime": 1610090460133, //交易时间戳
       "amount": "23.72469206", //订单金额 最多8位小数 正为收入，负为支出
       "currency": "BNB", //订单币种
       "walletType": 1, //主钱包类型，1 资金钱包；2 现货钱包；3 法币钱包；4 或 6 卡支付；5 理财钱包
       "walletTypes": [1,2], //数组格式，当使用组合支付时会有多个值
       "fundsDetail": [ //使用资金明细
               {
                "currency": "USDT", //使用资金币种  
                "amount": "1.2", //使用资金金额 为正 最多8位小数
                "walletAssetCost":[ //每个钱包的资金支出明细
                    {"1":"0.6"},
                    {"2":"0.6"}
                 ]
               },
               {
                "currency": "ETH",
                "amount": "0.0001",
                "walletAssetCost":[
                    {"1":"0.00005"},
                    {"2":"0.00005"}
                 ]
               }
          ],
       "payerInfo":{
               "name":"Jack", //个人昵称或商户名称
               "type":"USER", //账户类型，USER表示个人账户，MERCHANT表示商家
               "binanceId":"12345678", //binance uid
               "accountId":"67736251" //binance pay id
           },
       "receiverInfo":{
               "name":"Alan", //个人昵称或商户名称
               "type":"MERCHANT", //账户类型，USER表示个人账户，MERCHANT表示商家
               "email":"alan@binance.com", //邮箱
               "binanceId":"34355667", //binance uid
               "accountId":"21326891", /binance pay id
               "countryCode":"1", //国际区号
               "phoneNumber":"8057651210", //手机号
               "mobileCode":"US", //国家代码                
               "extend":[ //extension field
                    "institutionName": "", //银行名或者电子钱包名称
                    "cardNumber": "",  
                    "digitalWalletId": ""
               ] 
           }
     }
   ],
  "success": true
}