交易管理

交易记录相关接口

根据订单号查询交易详情

post

根据订单号或交易记录ID查询详细的交易信息。

功能说明

• 支持通过 trans_id（交易记录ID）或 order_id（第三方订单号）查询

• 返回详细的交易信息，包括：

  • 开卡交易：包含充值地址、交易哈希、汇率等信息

  • 充值交易：包含充值地址、交易哈希、手续费、汇率等信息

  • 支付交易：包含商户信息、支付详情等

  • 提现交易：包含提现地址、交易哈希、手续费、汇率等信息

使用场景

• 查询开卡交易的详细信息

• 查询充值交易的详细信息

• 查询支付交易的详细信息

• 查询提现交易的详细信息

授权

BearerAuth

Authorizationstring必填

使用从 /thirdPartyLogin 接口获取的 userToken 进行身份验证。

在请求头中添加：

Authorization: Bearer {userToken}

示例：

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyX2lkIjoxMjM0LCJ1c2VyX2tleSI6InVzZXJAZXhhbXBsZS5jb20iLCJleHAiOjE2OTgyMDMzOTV9.xxxxx

注意：

• /thirdPartyLogin 接口不需要 Authorization header（用于获取 token）
• 其他所有接口都需要在请求头中携带 Authorization header
• Token 过期后需要重新调用 /thirdPartyLogin 获取新 Token

请求体

application/json

trans_idinteger必填

交易记录ID（与order_id二选一）

Example: 12345

order_idstring可选

第三方订单号（与trans_id二选一）

Example: open_card_12345_39_abc123

响应

200

查询成功

application/json

codeinteger可选

响应状态码，200 表示成功

Example: 200

statusstring可选

响应状态，"true" 表示成功

Example: true

messagestring可选

响应消息

Example: success

400

请求参数错误

application/json

401

未授权

application/json

404

交易记录不存在

application/json

500

服务器内部错误

application/json

post

/getRecordDetail

HTTPcURLJavaScriptPython

POST /v1/api/getRecordDetail HTTP/1.1
Host: api.payall.pro
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 18

{
  "trans_id": 12345
}

通过交易记录ID查询通过订单号查询

{
  "code": 200,
  "status": "true",
  "message": "success",
  "data": {
    "trans_id": 12345,
    "third_party_order_id": "open_card_12345_39_abc123",
    "trans_type": "open_card",
    "status": "success",
    "amount": "30.00",
    "currency": "USD",
    "fee": "10.00",
    "fee_currency": "USD",
    "create_time": "2024-10-25 10:30:00",
    "finish_time": "2024-10-25 10:35:00",
    "open_card_transaction": {
      "network": "TRON",
      "deposit_address": "TXYZabcdefghijklmnopqrstuvwxyz123456",
      "transaction_hash": "0x1234567890abcdef...",
      "transaction_hash_url": "https://tronscan.org/#/transaction/0x1234567890abcdef..."
    },
    "exchange_rate": "1.0"
  }
}

查询所有交易记录

get

查询用户的所有交易记录，支持分页和多种筛选条件。

功能说明

• 支持按交易类型筛选（recharge、payment、open_card）

• 支持按卡片绑定ID筛选

• 支持按日期范围筛选

• 支持分页查询

交易类型说明

• recharge: 充值交易

• payment: 支付交易

• open_card: 开卡交易

授权

BearerAuth

Authorizationstring必填

使用从 /thirdPartyLogin 接口获取的 userToken 进行身份验证。

在请求头中添加：

Authorization: Bearer {userToken}

示例：

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyX2lkIjoxMjM0LCJ1c2VyX2tleSI6InVzZXJAZXhhbXBsZS5jb20iLCJleHAiOjE2OTgyMDMzOTV9.xxxxx

注意：

• /thirdPartyLogin 接口不需要 Authorization header（用于获取 token）
• 其他所有接口都需要在请求头中携带 Authorization header
• Token 过期后需要重新调用 /thirdPartyLogin 获取新 Token

查询参数

pageinteger可选

页码（从1开始）

Default: 1Example: 1

page_numinteger可选

每页数量

Default: 20Example: 20

trans_typestring · enum可选

交易类型筛选（recharge、payment、open_card）

Example: recharge可能的值:

card_binding_idinteger可选

卡片绑定ID筛选

Example: 12345

start_datestring可选

开始日期（格式：YYYY-MM-DD 或时间戳）

Example: 2024-10-01

end_datestring可选

结束日期（格式：YYYY-MM-DD 或时间戳）

Example: 2024-10-31

响应

200

查询成功

application/json

codeinteger可选

响应状态码，200 表示成功

Example: 200

statusstring可选

响应状态，"true" 表示成功

Example: true

messagestring可选

响应消息

Example: success

400

请求参数错误

application/json

401

未授权

application/json

500

服务器内部错误

application/json

get

/userTrans

HTTPcURLJavaScriptPython

GET /v1/api/userTrans HTTP/1.1
Host: api.payall.pro
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "code": 200,
  "status": "true",
  "message": "success",
  "data": {
    "list": [
      {
        "trans_id": 12345,
        "card": "PayAll Crypto Card **** 1234",
        "time": "2024-10-25 10:30:00",
        "amount": "100.00",
        "desc": "USD recharge",
        "trans_type": "recharge",
        "transaction_id": "tx_123456",
        "deposit_addr": "",
        "status": "success"
      }
    ],
    "pagination": {
      "total": 100,
      "page": 1,
      "page_num": 20,
      "total_pages": 5
    }
  }
}

查询某条记录详情

get

根据交易ID查询单条交易记录的详情。

功能说明

• 通过 transaction_id 查询交易记录

• 返回完整的交易记录信息

授权

BearerAuth

Authorizationstring必填

使用从 /thirdPartyLogin 接口获取的 userToken 进行身份验证。

在请求头中添加：

Authorization: Bearer {userToken}

示例：

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyX2lkIjoxMjM0LCJ1c2VyX2tleSI6InVzZXJAZXhhbXBsZS5jb20iLCJleHAiOjE2OTgyMDMzOTV9.xxxxx

注意：

• /thirdPartyLogin 接口不需要 Authorization header（用于获取 token）
• 其他所有接口都需要在请求头中携带 Authorization header
• Token 过期后需要重新调用 /thirdPartyLogin 获取新 Token

查询参数

transaction_idstring必填

交易ID

Example: tx_123456

响应

200

查询成功

application/json

codeinteger可选

响应状态码，200 表示成功

Example: 200

statusstring可选

响应状态，"true" 表示成功

Example: true

messagestring可选

响应消息

Example: success

dataobject可选

交易记录详情

400

请求参数错误

application/json

401

未授权

application/json

500

服务器内部错误

application/json

get

/userTransRecord

HTTPcURLJavaScriptPython

GET /v1/api/userTransRecord?transaction_id=tx_123456 HTTP/1.1
Host: api.payall.pro
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "code": 200,
  "status": "true",
  "message": "success",
  "data": {}
}