PayCloud SaaS

交易列表

开发中

POST

/api/cashier/entry

cashier2

最后修改时间：2024-03-26 01:34:34

责任人：王煜翔

交易列表

请求参数

Header 参数

app_version

string

可选

cashier版本号

示例值:

2122060266

Body 参数application/json

method

string

请求方法

必需

固定值：cashier.trans.list

version

string

版本

必需

timestamp

string

时间戳

必需

terminal_sn

string

设备编号

必需

app_id

string

应用编号

必需

price_currency

string

标价币种

必需

trans_status

integer

交易状态

可选

0-交易创建；1-交易关闭；2-交易完成；3-已撤销；9-预下单默认： 2-交易完成

银行卡交易状态只有 0-交易创建；1-交易关闭；2-交易完成；
扫码交易存在：3-已撤销；9-预下单

trans_statuses

array[integer]

交易状态数组

可选

多个交易状态查询，最好通过交易创建时间查询

pay_method_id

string

支付方式

可选

pay_method_ids

array[string]

支付方式列表

可选

pay_scenario

string

支付场景

可选

pay_scenario_list

array[string]

支付场景列表

可选

store_no

string

门店编号

可选

trans_end_time_min

string

交易完成时间开始

可选

trans_end_time_max

string

交易完成时间结束

可选

trans_start_time_min

string

交易创建时间开始

可选

trans_start_time_max

string

交易创建时间结束

可选

trans_type

string

交易类型

可选

1: Purchase2: Purchase cancellation3: Refund4: Pre-auth5: Pre-auth Cancellation6: Pre-auth Completion7: Pre-auth Completion Cancellation8: Pre-auth Completion Refund11: Cashback12: CashWithdraw

settlement_currency

string

结算币种

可选

trans_amount_min

string

交易金额最小

必需

trans_amount_max

string

交易金额最大

必需

trans_keywords

string

交易关键字查询

可选

trans_no, merchant_order_no, pay_channel_trans_no， ref_no

fuzzy_search

boolean

是否开启模糊匹配

可选

开启模糊匹配必须传时间

pay_user_account_name

string

卡号

可选

encrypt_pan

string

加密卡号

可选

page_num

integer

分页页码.默认1

必需

page_size

integer

分页大小。默认20

必需

示例

{
    "method": "string",
    "version": "string",
    "timestamp": "string",
    "terminal_sn": "string",
    "app_id": "string",
    "price_currency": "string",
    "trans_status": 0,
    "trans_statuses": [
        0
    ],
    "pay_method_id": "string",
    "pay_method_ids": [
        "string"
    ],
    "pay_scenario": "string",
    "pay_scenario_list": [
        "string"
    ],
    "store_no": "string",
    "trans_end_time_min": "string",
    "trans_end_time_max": "string",
    "trans_start_time_min": "string",
    "trans_start_time_max": "string",
    "trans_type": "string",
    "settlement_currency": "string",
    "trans_amount_min": "string",
    "trans_amount_max": "string",
    "trans_keywords": "string",
    "fuzzy_search": true,
    "pay_user_account_name": "string",
    "encrypt_pan": "string",
    "page_num": 0,
    "page_size": 0
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/cashier/entry' \
--header 'app_version: 2122060266' \
--header 'Content-Type: application/json' \
--data-raw '{
    "method": "string",
    "version": "string",
    "timestamp": "string",
    "terminal_sn": "string",
    "app_id": "string",
    "price_currency": "string",
    "trans_status": 0,
    "trans_statuses": [
        0
    ],
    "pay_method_id": "string",
    "pay_method_ids": [
        "string"
    ],
    "pay_scenario": "string",
    "pay_scenario_list": [
        "string"
    ],
    "store_no": "string",
    "trans_end_time_min": "string",
    "trans_end_time_max": "string",
    "trans_start_time_min": "string",
    "trans_start_time_max": "string",
    "trans_type": "string",
    "settlement_currency": "string",
    "trans_amount_min": "string",
    "trans_amount_max": "string",
    "trans_keywords": "string",
    "fuzzy_search": true,
    "pay_user_account_name": "string",
    "encrypt_pan": "string",
    "page_num": 0,
    "page_size": 0
}'

返回响应

🟢200成功

application/json

Body

code

string

必需

msg

string

必需

data

object

必需

total

integer

总数

必需

list

array [object {17}]

列表

必需

psn

string

必需

示例

{
    "code": "string",
    "msg": "string",
    "data": {
        "total": 0,
        "list": [
            {
                "app_id": "string",
                "app_name": "string",
                "terminal_sn": "string",
                "pay_method_id": "string",
                "pay_method_name": "string",
                "pay_method_icon_url": "string",
                "trans_no": "string",
                "trans_status": "string",
                "trans_type": "string",
                "pay_scenario": "string",
                "timezone": "string",
                "order_amount": "string",
                "trans_amount": "string",
                "price_currency": "string",
                "settlement_currency": "string",
                "created_time": "string",
                "trans_end_time": "string"
            }
        ]
    },
    "psn": "string"
}

🔴500失败

交易汇总（按日期+交易类型）

交易列表 (简化版)