# Developer API

### Authorization

Get JWT to use partner API on the developer page

<figure><img src="https://2106843801-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FskGFxeUNarVcGGepxsTW%2Fuploads%2FL44EEbT90DsSsinRppXn%2Fimage.png?alt=media&#x26;token=46bc504a-b6f1-4ef3-b687-15d88c600e1a" alt=""><figcaption></figcaption></figure>

## Get Processed Payments

> Returns a paginated list of processed payments. Authentication is required. API token must be generated in the Admin Panel and passed via the Authorization header.

```json
{"openapi":"3.0.3","info":{"title":"HOT Pay Partner API","version":"1.0.0"},"servers":[{"url":"https://api.hot-labs.org","description":"Production environment"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"Payment":{"type":"object","properties":{"memo":{"type":"string","description":"Merchant-defined memo or order identifier."},"item_id":{"type":"string","description":"Identifier of the payment link (item)."},"timestamp":{"type":"integer","description":"Unix timestamp (seconds) when the payment was finalized."},"amount":{"type":"string","description":"Paid amount in the smallest unit of the token."},"token_id":{"type":"string","description":"Identifier of the token received by the merchant."},"sender_id":{"type":"string","description":"Wallet address or account that initiated the payment."},"near_trx":{"type":"string","description":"NEAR transaction hash associated with the payment."},"status":{"type":"string","description":"Current payment status.","enum":["PENDING","PROCESSING","SUCCESS","REFUNDED","FAILED","INCOMPLETE_DEPOSIT","PENDING_DEPOSIT","KNOWN_DEPOSIT_TX"]}}},"Pagination":{"type":"object","properties":{"limit":{"type":"integer","description":"Maximum number of items requested."},"offset":{"type":"integer","description":"Number of items skipped before this page."},"count":{"type":"integer","description":"Number of items returned in the current response."}}}}},"paths":{"/partners/processed_payments":{"get":{"summary":"Get Processed Payments","description":"Returns a paginated list of processed payments. Authentication is required. API token must be generated in the Admin Panel and passed via the Authorization header.","tags":["Payments"],"parameters":[{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"},"description":"Partner API token generated in the Admin Panel. Format: Authorization: <API_TOKEN>"},{"name":"item_id","in":"query","required":false,"schema":{"type":"string"},"description":"Identifier of the payment link (item)."},{"name":"memo","in":"query","required":false,"schema":{"type":"string"},"description":"Merchant-defined memo or order identifier."},{"name":"sender_id","in":"query","required":false,"schema":{"type":"string"},"description":"Sender wallet address or account identifier."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"maximum":1000},"description":"Maximum number of payments to return."},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0},"description":"Number of payments to skip before starting to return results."}],"responses":{"200":{"description":"Successfully retrieved processed payments","content":{"application/json":{"schema":{"type":"object","properties":{"payments":{"type":"array","items":{"$ref":"#/components/schemas/Payment"}},"pagination":{"$ref":"#/components/schemas/Pagination"}}}}}},"401":{"description":"Unauthorized — invalid or missing Authorization token"}}}}}}
```