> ## Documentation Index
> Fetch the complete documentation index at: https://docs-payment-merchant.keysecure.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 获取卡消费详情

获取单笔消费详情。

## 请求头

<ParamField header="Api-Key" type="string" required placeholder="your_api_key">
  apiKey（商户凭证，与 IP 白名单绑定）
</ParamField>

<ParamField header="Timestamp" type="string" required>
  Unix 时间戳（毫秒），与服务端偏差须在 60 秒内，且不接受未来时间戳
</ParamField>

<ParamField header="Access-Token" type="string" required placeholder="your_access_token">
  登录标识（除获取 Token 外必填）
</ParamField>

<ParamField header="Content-Type" type="string" default="application/json">
  固定为 `application/json`
</ParamField>

## 路径参数

<ParamField path="consume_no" type="string" required>
  消费单号
</ParamField>

## 返回参数

<ResponseField name="code" type="number">
  响应状态码，`0` 表示成功
</ResponseField>

<ResponseField name="msg" type="string">
  响应消息
</ResponseField>

<ResponseField name="data" type="object">
  返回数据

  <Expandable title="data">
    <ResponseField name="consume_no" type="string">消费单号</ResponseField>
    <ResponseField name="consume_relate_no" type="string">消费关联单号</ResponseField>
    <ResponseField name="card_no" type="string">卡单号</ResponseField>
    <ResponseField name="cardholder_no" type="string">持卡人单号</ResponseField>
    <ResponseField name="type" type="string">消费类型，见【附录-常量表】</ResponseField>
    <ResponseField name="amount" type="string">金额</ResponseField>
    <ResponseField name="local_amount" type="string">原始金额</ResponseField>
    <ResponseField name="local_currency" type="string">原始币种</ResponseField>
    <ResponseField name="fee" type="string">费用（fee\_list 之和）</ResponseField>

    <ResponseField name="fee_list" type="object[]">
      费用详情列表

      <Expandable title="fee_list">
        <ResponseField name="fee_type" type="string">费用类型，见【附录-常量表】</ResponseField>
        <ResponseField name="amount" type="string">费用金额</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="merchant_info" type="object">
      商户信息

      <Expandable title="merchant_info">
        <ResponseField name="merchant_name" type="string">商户名称</ResponseField>
        <ResponseField name="merchant_mcc" type="string">商户 MCC</ResponseField>
        <ResponseField name="city" type="string">商户城市</ResponseField>
        <ResponseField name="country" type="string">商户国家</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="status" type="string">状态，见 【附录-常量表】通用状态</ResponseField>
    <ResponseField name="time" type="number">消费时间（Unix 毫秒）</ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash Request theme={null}
  curl --request GET \
    --url https://sandbox-openplatform.keysecure.io/open-api/v1/card/consume/CONSUME202605220001/info \
    --header 'Content-Type: application/json' \
    --header 'Api-Key: your_api_key' \
    --header 'Timestamp: 1716307200000' \
    --header 'Access-Token: your_access_token'
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "code": 0,
    "msg": "Success",
    "data": {
      "consume_no": "",
      "card_no": "",
      "type": "Consumption",
      "amount": "100.00",
      "local_currency": "USD",
      "fee": "1.00",
      "status": "Success",
      "time": 1716307200000
    }
  }
  ```
</ResponseExample>
