# HitPoints Reseller Document

This document is for developers of HitPoints Reseller to integrate HitPoints and achieve fetching HitPoints card through APIs.

GitBook: <https://docs-reseller.hitpoints.com/>

## HitPoints API

HitPoints provide following APIs to reseller：

* Query Product List
* Create fetching card order to fetch card
* Query fetching card record
* Query HitPoints Pin status

### Process of Reseller Fetching Card

Reseller can get the signed product list by **Query Product List API**，and create a fetching card order in the reseller's system to record the card type and the quantity, the orderId and productId and the quantity of Card will be submitted to HitPoints API **(Fetch Card API)**; After HitPoints verifies that the reseller’s product authority and deducted the reseller's balance, a corresponding number of card secrets will be generated and returned to the agent；The reseller needs to update the card fetching order status in his system as completed and save the returned card secret information. In addition, the reseller can also check the card secret generation record of the card fetching order in HitPoints by separately **query fetch card record**；After obtaining the card password, the reseller can query the card secret status **through the card serial number PIN\_SN**.

![Process of Fetching Card](https://hitpoint-media.oss-ap-southeast-1.aliyuncs.com/public-doc/image-20201214124710504.png)

## HitPoints SDK

HitPoints provided PHP sdk for quickly integration and API test. [For more details: hitpoints-php-sdk](https://github.com/seagm/hitpoints-php-sdk/blob/master/README_en.md)

## HitPoints API Signature And Security

API [API Signature](/api-signature.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs-reseller.hitpoints.com/undefined.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.