> For the complete documentation index, see [llms.txt](https://docs.pagsmile.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pagsmile.com/reference/issuing-card-api/business/partner/query-partner-transactions.md).

# Query Partner Transactions

### **Request URI** <a href="#payin-by-creditcard" id="payin-by-creditcard"></a>

`POST` `/issuing/partner/query-transactions`

### **Request Body**

**Refer to :** [**common**](/reference/issuing-card-api/common.md)

**Biz\_data ：**

| Name                                          | Type    | Description                                                                                           |
| --------------------------------------------- | ------- | ----------------------------------------------------------------------------------------------------- |
| order\_no                                     | string  | Order Number                                                                                          |
| card\_token                                   | string  | Card Token                                                                                            |
| account\_num                                  | string  | Account Number                                                                                        |
| transaction\_status                           | integer | <p>Transaction status，</p><p>refer to：<a href="/pages/s6Y5f3czsFzXG26r0vBp">transactionStatus</a></p> |
| transaction\_type                             | integer | <p>transaction type,</p><p>refer to：<a href="/pages/gbKVBqe4REk5SatWSXG9">transactionType</a></p>     |
| currency                                      | string  | <p>Currency,</p><p>refer to : <a href="/pages/qe7btns9YHn5kg2P9XYl">currency</a></p>                  |
| start\_date<mark style="color:red;">\*</mark> | string  | <p>Begin time,</p><p>format:yyyy-MM-dd</p>                                                            |
| end\_date<mark style="color:red;">\*</mark>   | string  | <p>End time,</p><p>format: yyyy-MM-dd</p>                                                             |
| page\_num                                     | integer | Default value: 1                                                                                      |
| page\_size                                    | integer | <p>Default value: 10,</p><p>Max value is 30</p>                                                       |

{% hint style="info" %}
Max query time range : 31 days
{% endhint %}

### **Request** Example <a href="#example" id="example"></a>

```
{
    "app_id": "00000000000000000",
    "partner_id": "00000000000000000",
    "request_id": "2A8D14F1-765c-729B-8501-5990DbC7",
    "timestamp": "2025-04-07 13:57:00",
    "format": "JSON",
    "version": "2.0",
    "sign_type": "RSA",
    "biz_data": {
        "order_no": "fE2E44c2-A4cF-C4Fc-40d6-Ee493262",
        "start_date": "2025-04-05",
        "end_date": "2025-04-08"
    },
    "random_key": "<generated_key>"
}
// The biz_data in this example needs to be encrypted!
```

### Response <a href="#example" id="example"></a>

<table><thead><tr><th width="227.5859375">Name</th><th width="176.44140625">Type</th><th>Description</th></tr></thead><tbody><tr><td>transaction_id</td><td>string</td><td>Transaction id</td></tr><tr><td>order_no</td><td>string</td><td>Order number</td></tr><tr><td>card_token</td><td>string</td><td>Card token</td></tr><tr><td>account_token</td><td>string</td><td>Account Token</td></tr><tr><td>transaction_type</td><td>integer</td><td>Transaction Type</td></tr><tr><td>transaction_status</td><td>integer</td><td>Transaction Status</td></tr><tr><td>account_num</td><td>string</td><td>Account Num</td></tr><tr><td>account_name</td><td>string</td><td>Account Name</td></tr><tr><td>bill_currency</td><td>string</td><td>Bill Currency</td></tr><tr><td>bill_amount</td><td>string</td><td>Bill Amount</td></tr><tr><td>bill_fee</td><td>string</td><td>Bill Fee</td></tr><tr><td>balance</td><td>string</td><td>Balance</td></tr><tr><td>balance_change</td><td>string</td><td>Balance Change</td></tr><tr><td>transaction_amount</td><td>string</td><td>Transaction Amount</td></tr><tr><td>transaction_currency</td><td>string</td><td>Transaction Currency</td></tr><tr><td>exchange_rate</td><td>string</td><td>Exchange Rate</td></tr><tr><td>reference</td><td>string</td><td>Remarks</td></tr><tr><td>transaction_desc</td><td>string</td><td>Transaction desc</td></tr><tr><td>related_transaction_id</td><td>string</td><td>Related Transaction ID</td></tr><tr><td>merchant_info</td><td>string</td><td>Merchant Information</td></tr><tr><td>business_date</td><td>string</td><td>Format: yyyy-MM-dd</td></tr><tr><td>create_time</td><td>string</td><td>Format: yyyy-MM-dd HH:mm:ss</td></tr></tbody></table>

{% tabs %}
{% tab title="200:OK" %}

```
{
    "code": "10000",
    "msg": "Success",
    "total": 1,
    "random_key": "<random key used for decryption>",
    "sign_type": "RSA",
    "app_id": "00000000000000000",
    "data": [{
        "transaction_id": "100000076795",
        "order_no": "fE2E44c2-A4cF-C4Fc-40d6-Ee493262",
        "account_token": "10419000000401",
        "card_token": null,
        "transaction_type": 121,
        "transaction_status": 1,
        "account_num": "104190******0004",
        "account_name": "Test A",
        "bill_currency": "USD",
        "bill_amount": "-1.23",
        "bill_fee": "0.00",
        "balance_change": "-1.23",
        "balance": "100898337.06",
        "transaction_amount": "-1.23",
        "transaction_currency": "USD",
        "exchange_rate": "1.0000",
        "reference": null,
        "transaction_desc": "remark",
        "merchant_info": null,
        "related_transaction_id": "100000076796",
        "business_date": "2025-04-07",
        "create_time": "2025-04-07 05:56:53"
    }]
}
// The data in this example has already been decrypted.
```

{% endtab %}

{% tab title="400: invalid-signature" %}

```
{
    "code": "40002",
    "msg": "Business Failed",
    "sub_code": "invalid-signature",
    "sub_msg": "invalid signature"
}
```

{% endtab %}
{% endtabs %}