> ## Documentation Index > Fetch the complete documentation index at: https://developers-sandbox.uqpaytech.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # List Cards Transactions > 返回签发交易对象的列表。对象按创建时间降序排列，最近创建的对象排在最前。 ## OpenAPI ````yaml /zh/card-issuance/v1.6/issuing.yaml get /v1/issuing/transactions openapi: 3.0.2 info: title: Issuing API version: 0.0.1 x-source-en-commit: 6841624 x-source-en-path: card-issuance/v1.6/issuing.yaml description: > UQPAY Issuing API 让你签发虚拟卡、管理持卡人，并监控卡交易。 ## 功能概览 - 创建并管理虚拟卡（签发、激活、冻结、注销） - 通过 KYC 完成持卡人入驻与验证 - 设置消费限额与卡控制 - 为卡余额充值与提现 - 查询卡交易与账户余额 - 在发卡账户之间转账 - 生成并下载报表 ## 身份认证 所有请求都需要携带有效的鉴权 Token，Token 通过 [Access Token](/zh/account-center/v1.6/api-reference/access-token) 接口获取。请在 `x-auth-token` 请求头中携带该 Token。 ## 幂等性 POST 请求支持 `x-idempotency-key` 请求头，可安全重试而不会创建重复资源。 contact: name: UQPAY Support Team url: https://www.uqpay.com/support email: support@uqpay.com license: name: Proprietary url: https://www.uqpay.com/legal/api-terms termsOfService: https://www.uqpay.com/legal/terms x-api-id: uqpay-issuing-api-v1.6.0 x-categories: - Card Issuing - Transaction Processing x-features: - Virtual Card Issuance - Real-time Processing - Webhook Notifications - Comprehensive Reporting - Transaction Monitoring servers: - url: https://api-sandbox.uqpaytech.com/api description: 沙盒环境基础 URL。 - url: https://api.uqpay.com/api description: 生产环境基础 URL。 security: [] tags: - name: Card Lifecycle description: 创建卡片并管理其完整生命周期——签发、查询、更新、激活、绑定与变更状态。 - name: Card Secure Data description: 通过 PCI 合规接口或令牌化 iframe 访问敏感卡数据（PAN、CVV）。是否可用取决于你的 PCI 状态，而非卡产品。 - name: Card Funding description: 为预付类卡片充值或提取其卡内储值余额。 - name: Card PIN description: 设置并管理卡片 PIN 码。`reset-pin` 用于实体卡，`manage-card-pin` 用于虚拟卡。 - name: Card Add-ons description: >- 产品专属的卡功能。每个操作仅适用于特定卡产品——参见 [卡产品](/zh/card-issuance/v1.6/guide/card-products)。 - name: Card Arts description: >- 管理发卡账户可用的视觉设计（卡面）。可设置账户级默认卡面，或在签发/更新卡片时传入 `card_art_id` 以按卡覆盖。仅 Personal Visa 支持。 - name: Cardholders description: 你可以创建持卡人。持卡人是你企业的授权代表，可被签发卡片。 - name: Transactions description: 这些接口用于查询在你用户卡片上发生的交易信息。 - name: Products description: 通过这组接口，你可以为客户创建卡订单。 - name: Balances description: 各币种的可用金额与待处理金额会进一步按资金来源类型细分。你可以查询它，查看发卡账户当前的余额。 - name: Transfers description: 在发卡账户之间转账。 - name: Reports description: 生成并下载发卡报表。 - name: Simulator description: 在沙盒环境中模拟卡交易。 paths: /v1/issuing/transactions: get: tags: - Transactions summary: List Cards Transactions description: 返回签发交易对象的列表。对象按创建时间降序排列，最近创建的对象排在最前。 operationId: list-cards-transactions parameters: - $ref: '#/components/parameters/XOnBehalfOf' - $ref: '#/components/parameters/PageSize' - $ref: '#/components/parameters/PageNumber' - $ref: '#/components/parameters/PathCardId' - name: start_time in: query required: false description: > 用于筛选的最早交易创建时间，ISO 8601 格式。`start_time` 与 `end_time` 之间的最大时间间隔为 90 天。 当取值包含时区偏移（如 `+08:00`）时，查询字符串中的 `+` 字符必须 URL 编码为 `%2B`——否则服务端会将其解析为空格并拒绝请求。示例：`start_time=2024-03-21T17:17:32%2B08:00`。以 `Z` 结尾的 UTC 取值（如 `2024-03-21T09:17:32Z`）无需编码。 schema: type: string example: '2024-03-21T09:17:32Z' - name: end_time in: query required: false description: > 用于筛选的最晚交易创建时间，ISO 8601 格式。`start_time` 与 `end_time` 之间的最大时间间隔为 90 天。 当取值包含时区偏移（如 `+08:00`）时，查询字符串中的 `+` 字符必须 URL 编码为 `%2B`——否则服务端会将其解析为空格并拒绝请求。示例：`end_time=2024-03-21T17:17:32%2B08:00`。以 `Z` 结尾的 UTC 取值（如 `2024-03-21T09:17:32Z`）无需编码。 schema: type: string example: '2024-03-21T09:17:32Z' responses: '200': description: 成功返回卡片交易。 headers: x-response-id: $ref: '#/components/headers/XResponseId' content: application/json: examples: sandbox: summary: Sandbox response value: total_items: 58 total_pages: 6 data: - card_id: ecfc3211-9f9a-4b57-90c3-f0fbb307e9bd card_number: '************0884' cardholder_id: 9efdc467-ec15-4d7b-bdb9-61f375f809f6 transaction_id: c3dbfba4-c9db-47fd-8d6f-4d2e58eb535f short_transaction_id: T260909-2PD70R2OP728 original_transaction_id: '' transaction_type: FUND COLLECTION card_available_balance: '21.88' authorization_code: '' billing_amount: '0' billing_currency: USD transaction_amount: '0.1' transaction_currency: USD transaction_fee: '0' transaction_fee_currency: '' fee_pass_through: 'N' transaction_time: '2026-09-09T16:07:03.249+08:00' merchant_data: category_code: '5734' city: SINGAPORE country: US name: WMc08ed90f oct description: High Risk Transaction transaction_status: DECLINED wallet_type: '' - card_id: ecfc3211-9f9a-4b57-90c3-f0fbb307e9bd card_number: '************0884' cardholder_id: 9efdc467-ec15-4d7b-bdb9-61f375f809f6 transaction_id: 72691771-811a-45f5-9e38-586a8e9d8e44 short_transaction_id: T260909-2PD70QCBRRPC original_transaction_id: d3fb10e2-0f7b-4fe8-986c-5abbb2d51ea4 transaction_type: REVERSAL card_available_balance: '21.88' authorization_code: RSDJLMR billing_amount: '0.1' billing_currency: USD transaction_amount: '0.1' transaction_currency: USD transaction_fee: '0' transaction_fee_currency: '' fee_pass_through: 'N' transaction_time: '2026-09-09T16:07:02.836+08:00' merchant_data: category_code: '5734' city: SINGAPORE country: US name: WMc08ed90f aftreverse description: '' transaction_status: APPROVED wallet_type: '' - card_id: ecfc3211-9f9a-4b57-90c3-f0fbb307e9bd card_number: '************0884' cardholder_id: 9efdc467-ec15-4d7b-bdb9-61f375f809f6 transaction_id: d3fb10e2-0f7b-4fe8-986c-5abbb2d51ea4 short_transaction_id: T260909-2PD70P4Z17NK original_transaction_id: '' transaction_type: AUTHORIZATION card_available_balance: '21.78' authorization_code: RSDJLM billing_amount: '0.1' billing_currency: USD transaction_amount: '0.1' transaction_currency: USD transaction_fee: '0' transaction_fee_currency: '' fee_pass_through: 'N' transaction_time: '2026-09-09T16:07:02.197+08:00' merchant_data: category_code: '5734' city: SINGAPORE country: US name: WMc08ed90f aft description: '' transaction_status: APPROVED wallet_type: '' - card_id: ecfc3211-9f9a-4b57-90c3-f0fbb307e9bd card_number: '************0884' cardholder_id: 9efdc467-ec15-4d7b-bdb9-61f375f809f6 transaction_id: b8defc70-bca1-43d9-8814-0388ca7b371e short_transaction_id: T260909-2PD70N0QMRR4 original_transaction_id: b53491cf-0c36-4ab3-9771-07ee7d89117e transaction_type: REFUND card_available_balance: '21.88' authorization_code: W9SJNP billing_amount: '0.1' billing_currency: USD transaction_amount: '0.1' transaction_currency: USD transaction_fee: '0' transaction_fee_currency: '' fee_pass_through: 'N' transaction_time: '2026-09-09T16:07:01.168+08:00' merchant_data: category_code: '5734' city: SINGAPORE country: US name: WMc08ed90f adjrefund description: '' transaction_status: APPROVED wallet_type: '' - card_id: ecfc3211-9f9a-4b57-90c3-f0fbb307e9bd card_number: '************0884' cardholder_id: 9efdc467-ec15-4d7b-bdb9-61f375f809f6 transaction_id: 0bbaea31-9180-490a-bad2-4e99f91e28f5 short_transaction_id: T260909-2PD70L7EAE4G original_transaction_id: 7a759eb5-e9b0-4cab-8d8a-7abdd51ba524 transaction_type: REVERSAL card_available_balance: '21.78' authorization_code: N5DPC5R billing_amount: '0' billing_currency: USD transaction_amount: '0.01' transaction_currency: USD transaction_fee: '0' transaction_fee_currency: '' fee_pass_through: 'N' transaction_time: '2026-09-09T16:07:00.604+08:00' merchant_data: category_code: '5734' city: SINGAPORE country: US name: WMc08ed90f adjreverse description: '' transaction_status: APPROVED wallet_type: '' - card_id: ecfc3211-9f9a-4b57-90c3-f0fbb307e9bd card_number: '************0884' cardholder_id: 9efdc467-ec15-4d7b-bdb9-61f375f809f6 transaction_id: bcac3668-03b5-48a9-9d49-ac90de9a3dcd short_transaction_id: T260909-2PD70KEQYBCW original_transaction_id: b53491cf-0c36-4ab3-9771-07ee7d89117e transaction_type: REFUND card_available_balance: '21.78' authorization_code: 3Q3CIC billing_amount: '0.01' billing_currency: USD transaction_amount: '0.01' transaction_currency: USD transaction_fee: '0' transaction_fee_currency: '' fee_pass_through: 'N' transaction_time: '2026-09-09T16:06:59.765+08:00' merchant_data: category_code: '5734' city: SINGAPORE country: US name: WMc08ed90f credit description: '' transaction_status: APPROVED wallet_type: '' - card_id: ecfc3211-9f9a-4b57-90c3-f0fbb307e9bd card_number: '************0884' cardholder_id: 9efdc467-ec15-4d7b-bdb9-61f375f809f6 transaction_id: 7a759eb5-e9b0-4cab-8d8a-7abdd51ba524 short_transaction_id: T260909-2PD70JPPGYKG original_transaction_id: b53491cf-0c36-4ab3-9771-07ee7d89117e transaction_type: AUTHORIZATION card_available_balance: '21.77' authorization_code: N5DPC5 billing_amount: '0.01' billing_currency: USD transaction_amount: '0.01' transaction_currency: USD transaction_fee: '0' transaction_fee_currency: '' fee_pass_through: 'N' transaction_time: '2026-09-09T16:06:59.399+08:00' merchant_data: category_code: '5734' city: SINGAPORE country: US name: WMc08ed90f debit description: '' transaction_status: APPROVED wallet_type: '' - card_id: ecfc3211-9f9a-4b57-90c3-f0fbb307e9bd card_number: '************0884' cardholder_id: 9efdc467-ec15-4d7b-bdb9-61f375f809f6 transaction_id: b53491cf-0c36-4ab3-9771-07ee7d89117e short_transaction_id: T260909-2PD70I0LGE0W original_transaction_id: '' transaction_type: AUTHORIZATION card_available_balance: '21.78' authorization_code: PR9LTU billing_amount: '0.1' billing_currency: USD transaction_amount: '0.1' transaction_currency: USD transaction_fee: '0' transaction_fee_currency: '' fee_pass_through: 'N' transaction_time: '2026-09-09T16:06:58.525+08:00' merchant_data: category_code: '5734' city: SINGAPORE country: US name: WMc08ed90f adjauth description: '' transaction_status: APPROVED wallet_type: '' - card_id: ecfc3211-9f9a-4b57-90c3-f0fbb307e9bd card_number: '************0884' cardholder_id: 9efdc467-ec15-4d7b-bdb9-61f375f809f6 transaction_id: 4aaef847-5f90-4e86-9691-ffd8a8ec96d4 short_transaction_id: T260909-2PD70FNREJ9C original_transaction_id: '' transaction_type: AUTHORIZATION card_available_balance: '21.88' authorization_code: RDCMCZ billing_amount: '0.1' billing_currency: USD transaction_amount: '0.1' transaction_currency: USD transaction_fee: '0' transaction_fee_currency: '' fee_pass_through: 'N' transaction_time: '2026-09-09T16:06:57.289+08:00' merchant_data: category_code: '5734' city: SINGAPORE country: US name: WMc08ed90f highauth description: '' transaction_status: APPROVED wallet_type: '' - card_id: ecfc3211-9f9a-4b57-90c3-f0fbb307e9bd card_number: '************0884' cardholder_id: 9efdc467-ec15-4d7b-bdb9-61f375f809f6 transaction_id: 7df303b1-35f3-4da8-bb2a-98a530d91b3f short_transaction_id: T260909-2PD70E06BQBK original_transaction_id: 8b2d5f82-6457-494b-b571-f2e9946e59b2 transaction_type: REFUND card_available_balance: '21.98' authorization_code: 8S515V billing_amount: '0.08' billing_currency: USD transaction_amount: '0.08' transaction_currency: USD transaction_fee: '0' transaction_fee_currency: '' fee_pass_through: 'N' transaction_time: '2026-09-09T16:06:56.572+08:00' merchant_data: category_code: '5734' city: SINGAPORE country: US name: WMc08ed90f lowrefund description: '' transaction_status: APPROVED wallet_type: '' schema: title: ListIssuingTransactionsResponse properties: total_pages: $ref: '#/components/schemas/TotalPages' total_items: $ref: '#/components/schemas/TotalItems' data: type: array items: $ref: '#/components/schemas/CardTranactionsResponse' security: - XAuthToken: [] components: parameters: XOnBehalfOf: in: header name: x-on-behalf-of schema: type: string required: false description: > 指定代表哪个子账户发起请求。应设置为 `account_id`，该值可通过 [List Connected Accounts](/zh/account-center/v1.6/api-reference/list-connected-accounts) 接口获取。若省略或为空，则请求以主账户身份执行。 更多信息参见 [关联账户](/zh/account-center/v1.6/guide/connected-accounts)。 example: 18523f72-f4de-4f9c-bb8e-ec7d1c4f32be PageSize: name: page_size description: 每页返回的最大条目数。取值范围为 10 - 100，默认为 10。 in: query required: true schema: type: integer minimum: 10 maximum: 100 default: 10 example: 10 PageNumber: name: page_number description: 用于获取下一组条目的页码。取值必须大于 1，默认为 1。 in: query required: true schema: type: integer minimum: 1 default: 1 example: 1 PathCardId: name: card_id description: 卡片的全局唯一标识符（UUID v4）。 in: query required: false schema: type: string format: uuid example: b3d9d2d5-4c12-4946-a09d-953e82sed2b0 headers: XResponseId: description: 响应的全局唯一标识符（UUID v4）。在联系 UQPAY 支持团队时有助于定位某次请求。 schema: type: string format: uuid example: 2adba88e-9d63-44bc-b975-9b6ae3440dde schemas: TotalPages: type: integer example: 1 description: 可用条目的总页数。 TotalItems: type: integer example: 10 description: 可用条目的总数。 CardTranactionsResponse: type: object required: - card_id - card_number - cardholder_id - transaction_id - short_transaction_id - original_transaction_id - transaction_type - transaction_fee - transaction_fee_currency - fee_pass_through - card_available_balance - authorization_code - billing_amount - billing_currency - transaction_amount - transaction_currency - transaction_time - description - transaction_status properties: card_id: $ref: '#/components/schemas/CardId' card_number: $ref: '#/components/schemas/CardNumber' cardholder_id: $ref: '#/components/schemas/CardholderId' transaction_id: $ref: '#/components/schemas/TransactionId' short_transaction_id: $ref: '#/components/schemas/ShortTransactionId' original_transaction_id: $ref: '#/components/schemas/OriginalTransactionId' transaction_type: $ref: '#/components/schemas/CardTranscationType' transaction_fee: type: string example: '0.25' description: 交易手续费。 transaction_fee_currency: type: string example: SGD description: 交易手续费币种。 fee_pass_through: type: string example: 'Y' enum: - 'Y' - 'N' description: > 表示本次交易是否带有转嫁的低额交易费（LOW_TRANSACTION_FEE）。 * `Y` – 交易触发了低额交易费规则；`transaction_fee` / `transaction_fee_currency` 携带该转嫁费用。 * `N` – 不适用此类转嫁费用（默认）。 仅当交易金额（以 USD 计）落在卡片配置的低额交易费阈值区间内时触发。 card_available_balance: type: string example: '2506.26' description: 卡片可用余额。 authorization_code: type: string example: 856268 description: 授权码 billing_amount: type: string example: '70.25' description: 账单金额 billing_currency: type: string example: SGD description: 账单币种 transaction_amount: type: string example: '100.25' description: 交易金额 transaction_currency: type: string example: USD description: 交易币种 transaction_time: type: string example: '2024-03-21T17:17:32+08:00' description: 交易发生时间 posted_time: type: string example: '2024-03-21T17:17:32+08:00' description: 交易入账时间 merchant_data: $ref: '#/components/schemas/MerchantData' description: type: string description: > 根据交易状态提供额外的上下文信息。 - 若 `transaction_status` 为 `DECLINED`，此字段包含失败原因。 - 若 `transaction_status` 为 `APPROVED`，此字段包含补充备注（如 "1000 - Authorization Approval"、"3DS Fee"）。 example: 1107 - Invalid CVV2 transaction_status: type: string description: 表示交易生命周期所处阶段的高层状态。 example: DECLINED enum: - APPROVED - DECLINED - PENDING wallet_type: $ref: '#/components/schemas/WalletType' CardId: type: string example: c0cef051-29c5-4796-b86a-cd5b684bfad7 description: 卡片的唯一标识符。 CardNumber: type: string example: '************5668' description: 脱敏卡号 CardholderId: type: string description: 持卡人的唯一标识符。 example: 7c4ff2cd-1bf6-4aaa-bf16-266771425011 format: uuid TransactionId: type: string format: uuid description: 交易的唯一标识符。 example: 5135e6cc-28b6-4889-81dc-3b86a09e1395 ShortTransactionId: type: string description: 交易的短唯一标识符。 example: CT2024-03-01 OriginalTransactionId: oneOf: - title: Related transaction type: string format: uuid - title: Related transaction ID unavailable type: string enum: - '' description: 关联交易的唯一标识符。空字符串表示没有可用的关联交易 ID。 example: 1234e6cc-28b6-4889-81dc-3b86a09e1395 CardTranscationType: type: string example: AUTHORIZATION description: > 卡片交易类型。 - `AUTHORIZATION`：因用卡而预留的资金。 - `REFUND`：将消费金额退回账户余额。 - `FUND COLLECTION`：由卡组织上报、入账到持卡人卡账户的入款。由网络触发（而非持卡人 API 调用）；与 CARD RECHARGE 不同。 - `ATM DEPOSIT`：通过 ATM 存入账户的资金。 - `REVERSAL`：对授权的冲正。 - `VALIDATION`：绑卡验证。 - `SETTLEMENT DEBIT`：对账差异的轧差与扣减。 - `SETTLEMENT CREDIT`：对账差异的轧差与入账。 - `SETTLEMENT REVERSAL`：对账差异的轧差与冲正。 - `CHARGEBACK DEBIT`：因拒付而扣减的资金。 - `CHARGEBACK CREDIT`：因拒付而入账的资金。 enum: - AUTHORIZATION - REFUND - FUND COLLECTION - ATM DEPOSIT - REVERSAL - VALIDATION - SETTLEMENT DEBIT - SETTLEMENT CREDIT - SETTLEMENT REVERSAL - CHARGEBACK DEBIT - CHARGEBACK CREDIT MerchantData: type: object description: 本次交易涉及的商户详情（如杂货店、电商网站等）。 properties: category_code: type: string description: 商户经营的商户类别代码（MCC）。 example: '6011' city: type: string description: 商户所在城市 example: CITY NAME country: type: string description: 商户所在国家 example: CN name: type: string description: 商户名称 example: ACQUIRER NAME WalletType: type: string description: >- 数字钱包及交易场景。CONTACTLESS 表示非接触式支付，ECOM 表示电子商务交易。OTHER 表示无法识别的非空钱包值；空字符串表示未使用数字钱包或无钱包信息。 enum: - APPLE_PAY_CONTACTLESS - APPLE_PAY_ECOM - GOOGLE_PAY_CONTACTLESS - GOOGLE_PAY_ECOM - SAMSUNG_PAY_CONTACTLESS - SAMSUNG_PAY_ECOM - OTHER - '' securitySchemes: XAuthToken: type: apiKey in: header name: x-auth-token description: 由 UQPAY 提供的登录 API Token。 ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.