> ## Documentation Index
> Fetch the complete documentation index at: https://devzone.nayax.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 检索卡数据

export const EndpointCard = ({method = "API", title, children, href, arrow = true}) => {
  const METHOD_STYLES = {
    GET: {
      bg: "mint-bg-green-400/20 dark:mint-bg-green-400/20",
      text: "mint-text-green-700 dark:mint-text-green-400",
      border: "mint-border-green-300 dark:mint-border-green-700"
    },
    POST: {
      bg: "mint-bg-blue-400/20 dark:mint-bg-blue-400/20",
      text: "mint-text-blue-700 dark:mint-text-blue-400"
    },
    PUT: {
      bg: "mint-bg-yellow-400/20 dark:mint-bg-yellow-400/20",
      text: "mint-text-yellow-700 dark:mint-text-yellow-400"
    },
    PATCH: {
      bg: "mint-bg-orange-400/20 dark:mint-bg-orange-400/20",
      text: "mint-text-orange-700 dark:mint-text-orange-400"
    },
    DELETE: {
      bg: "mint-bg-red-400/20 dark:mint-bg-red-400/20",
      text: "mint-text-red-700 dark:mint-text-red-400"
    },
    API: {
      bg: "mint-bg-black",
      text: "mint-text-white"
    }
  };
  const MethodBadge = ({method}) => {
    const style = METHOD_STYLES[method?.toUpperCase()] ?? METHOD_STYLES.GET;
    return <span className={`
          method-pill rounded-lg font-bold px-1.5 py-0.5 text-xs leading-5 ${style.bg} ${style.text}`}>
        {method?.toUpperCase()}
      </span>;
  };
  const content = <div className="group flex items-center gap-4 border border-gray-200 dark:border-gray-700 rounded-xl p-5 bg-white dark:bg-[#1e1e1e] hover:border-gray-400 dark:hover:border-gray-500 hover:shadow-md transition-all cursor-pointer">
      {}
      <div className="flex-1 min-w-0">
        <p className="font-semibold text-gray-900 dark:text-white text-sm leading-snug">{title}</p>
        {children && <p className="mt-1 text-sm text-gray-500 dark:text-gray-400 line-clamp-2">{children}</p>}
      </div>

      {}
      <div className="shrink-0">
        <MethodBadge method={method} />
      </div>
    </div>;
  if (!href) return content;
  return <a href={href} className="block no-underline border-b-0 mb-2">
      {content}
    </a>;
};

Lynx API 提供了多个 GET 方法，用于检索有关卡片的详细信息。这些方法可用于查询卡片详情、检查信用额度余额、访问增值历史记录等。

<Warning>
  验证

  请参阅本文档的 [Security & Token](/docs/manage-data-operations/lynx-api/security) 页面，了解如何获取您的令牌（token），以及如何使用它正确地对您的 API 请求进行身份验证。
</Warning>

## 在 Nayax Core 中验证卡片详情

要在 Nayax Core 中查看卡片的详细信息，请进入 Card Management 选项卡，使用搜索栏查找您要检查的卡片，并选择它。

<Frame>
  <img src="https://mintcdn.com/nayax-44d6e37b/SZdrogZN6xHGu-sq/images/docs/retrieve-card-data/image1.png?fit=max&auto=format&n=SZdrogZN6xHGu-sq&q=85&s=c9c645bd1fbcbafe74a7f7f9775ce099" width="1440" height="824" data-path="images/docs/retrieve-card-data/image1.png" />
</Frame>

您将看到该卡片的所有详细信息，这与前面提到的 Lynx API 端点检索到的数据相同。

## 获取卡牌

<EndpointCard title="获取卡牌" href="/reference/lynx/cards/get-cards" method="get" />

此通用端点将检索所有卡片的概览信息，包括 Card ID、Card Holder Name 和 Card Status 等基本详细信息。请参见示例查询：

```sh Request theme={null}
curl --request GET \
     --url https://qa-lynx.nayax.com/operational/v1/cards \
     --header 'accept: application/json' \
     --header 'Authorization: Bearer <YOUR_ACCESS_TOKEN>'
```

通过在请求中添加查询参数，此端点也可以检索特定卡片的详细信息，而不是所有卡片。例如，要获取 Card Unique Identifier 为 `1409315030` 的卡片的详细信息，您可以使用下方代码块中的查询。

```sh Request theme={null}
curl --request GET \
     --url 'https://qa-lynx.nayax.com/operational/v1/cards?CardUniqueIdentifier=1409315030%20' \
     --header 'accept: application/json' \
     --header 'Authorization: Bearer <YOUR_ACCESS_TOKEN>'
```

卡片的以下任何详细信息都可以用作查询参数：

* `CardID`
* `CardUniqueIdentifier`
* `CardDisplayNumber`
* `CardMobileNumber`
* `ExternalApplicationUserID`
* `CardEmail`
* `CardHolderName`

## 通过卡片显示编号获取卡片

<EndpointCard title="通过卡片显示编号获取卡片" href="/reference/lynx/cards/get-card-by-the-cards-display-number" method="get" />

它根据卡片的显示号码（即卡片的物理卡号）获取卡片详细信息。这非常适用于只能获取显示号码作为参考的情况。

请参见下方代码块中的查询示例：

```sh theme={null}
curl --request GET \
     --url https://qa-lynx.nayax.com/operational/v1/cards/displayNumber/{CardDisplayNumber} \
     --header 'Authorization: Bearer <YOUR_ACCESS_TOKEN>' \
     --header 'accept: application/json'
```

<Note>
  将 `{CardDisplayNumber}` 替换为该卡片的实际号码。
</Note>

## 获取预付卡

<EndpointCard title="获取预付卡" href="/reference/lynx/cards/get-prepaid-card" method="get" />

它检索与特定 CardID 关联的预付卡的详细信息。可用于管理预付卡或验证其状态和属性。

请参见下方代码块中的查询示例：

```sh Request theme={null}
curl --request GET \
     --url https://qa-lynx.nayax.com/operational/v1/cards/CardID/prepaid \
     --header 'accept: application/json' \
     --header 'Authorization: Bearer <YOUR_ACCESS_TOKEN>'

```

<Note>
  将 `{CardID}` 替换为该卡片的实际 `CardID`。
</Note>

响应中将包含所请求卡片的详细信息。

## 从卡中获得信用

<EndpointCard title="从卡中获得信用" href="/reference/lynx/cards/get-the-credit-from-a-card" method="get" />

此选项通过唯一标识符获取特定卡片的当前信用额度余额。可用于监控卡片余额，例如预付卡或技术员卡的余额。

请参见下方代码块中的查询示例：

<CodeGroup>
  ```sh Request theme={null}
  curl --request GET \
       --url https://qa-lynx.nayax.com/operational/v1/cards/{CardUniqueIdentifier}/credit \
       --header 'Authorization: Bearer <YOUR_ACCESS_TOKEN>' \
       --header 'accept: application/json'
  ```

  ```json Response theme={null}
  {
    "value": 5320
  }
  ```
</CodeGroup>

<Note>
  将 `{CardUniqueIdentifier}` 替换为该卡的实际标识符。
</Note>

响应中将包含该卡片的信用额度余额。

## 获取卡的重新估值

<EndpointCard title="获取卡的重新估值" href="/reference/lynx/cards/get-cards-revalue" method="get" />

通过卡片的唯一标识符检索与特定卡片关联的增值金额。请参见下方的查询示例：

```sh Request theme={null}
curl --request GET \
     --url https://qa-lynx.nayax.com/operational/v1/cards/{CardUniqueIdentifier}/revalue \
     --header 'Authorization: Bearer <YOUR_ACCESS_TOKEN>' \
     --header 'accept: application/json'
```

<Note>
  将 `{CardUniqueIdentifier}` 替换为该卡的实际标识符。
</Note>

响应中将包含该卡片的增值金额。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.