# Endpoints

These are the main endpoints used by partners.
They allow you to create payment requests and check payment status.
Partners can only access data for merchants linked to them.
All requests must include a valid access token


## Generate a Token

 - [POST /finance/v1/generate-token](https://docs.theropay.co/theropay/docs/reference/partners/endpoints/paths/~1finance~1v1~1generate-token/post.md): This API generates an access token using the clientId and clientSecret
provided to the partner during onboarding.

## Retrieves a list of merchants linked to the partner.

 - [GET /finance/v1/partner/list](https://docs.theropay.co/theropay/docs/reference/partners/endpoints/paths/~1finance~1v1~1partner~1list/get.md): This API returns all merchants assigned to the given partner.
Pass the partnerId as a query parameter.

## Creates a new recipient using ACH.

 - [POST /finance/v1/recipient-ach](https://docs.theropay.co/theropay/docs/reference/partners/endpoints/paths/~1finance~1v1~1recipient-ach/post.md): Create a counterparty (payee) for a merchant. Include partner and merchant IDs.

## Creates a new recipient using Wire transfer.

 - [POST /finance/v1/recipient-wire](https://docs.theropay.co/theropay/docs/reference/partners/endpoints/paths/~1finance~1v1~1recipient-wire/post.md): Create a counterparty (payee) for wire payments. Supports both domestic
and international wire transfers. Provide partnerId, merchantId, and wire details.

## Get Recipients

 - [GET /finance/v1/payees](https://docs.theropay.co/theropay/docs/reference/partners/endpoints/paths/~1finance~1v1~1payees/get.md)

## Create a new payment Request.

 - [POST /finance/v1/payment_request](https://docs.theropay.co/theropay/docs/reference/partners/endpoints/paths/~1finance~1v1~1payment_request/post.md): Create a payment on behalf of a merchant. Provide partner and merchant IDs and a unique partner payment ID for idempotency.

## Search Transactions

 - [POST /finance/v1/partner/search_transactions](https://docs.theropay.co/theropay/docs/reference/partners/endpoints/paths/~1finance~1v1~1partner~1search_transactions/post.md): This API helps partners find payments that were created earlier.
You can use it to check the latest payment status or view payment history.
Only payments from merchants linked to the partner will be returned