# Overview

The Partners API enables authorized integration partners to collaborate with associated merchants.

Payment requests, payees, and payment status can all be created by partners.

OAuth2 Client Credentials are used to grant secure access.

For More Information Please read the full Partner Integration Guide here:

[Partner Integration Guide](../Partner/Partner_Integration_Guide.md)



## Servers

Sandbox Server
```
https://devapi.theropay.co
```

## Security

### Bearer

JWT Authorization header using the Bearer scheme.

Type: http
Scheme: bearer
Bearer Format: JWT

## Download OpenAPI description

[Overview](https://docs.theropay.co/_bundle/Theropay/docs/reference/Partners.yaml)

## 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