# Merchant Endpoints

## get a payment by id

 - [GET /v3/payments/{id}](https://docs.payconiq.be/apis/merchant-payment.openapi/merchant-endpoints/merchant-get-payment.md): This API is intended for merchants requiring information on a specific payment. 
Onboarded merchants should have api keys for each profile, the api key will carry the profileId information required to find the correct creditor in the merchant-service

The token/api-key necessary to call this endpoint must contain:

*  :  or 
* : ,
* : 

## cancel a payment

 - [DELETE /v3/payments/{id}](https://docs.payconiq.be/apis/merchant-payment.openapi/merchant-endpoints/cancel_payment.md): Endpoint responsible for canceling a payment on the request of a merchant.
The caller has to be one of the participants of the payment.
A payment can be cancelled only if has the status in PENDING or IDENTIFIED.
When a payment is cancelled the status will be set to CANCELLED.

The token neccessary to call this endpoint as a  has to have:
-  :  or 
- : 
-  : 

## search payments

 - [POST /v3/payments/search](https://docs.payconiq.be/apis/merchant-payment.openapi/merchant-endpoints/search.md): Endpoint responsible for searching payments by PaymentWebQuery model and returning the latest n(number set on the 'limit' parameter) payments, starting from the 'offset' payment(set in 'offset' parameter).
By default the latest 10 payments (sorted by creation date descending) are returned per request


## create a payment

 - [POST /v3/payments](https://docs.payconiq.be/apis/merchant-payment.openapi/merchant-endpoints/create.md): This API is intended for merchants initiating payments for specific profiles.
Onboarded merchants should have api keys for each profile, the api key will carry the profileId information required to find the correct creditor in the merchant-service

The token/api-key necessary to call this endpoint must contain:
*  : "" or ""
* : "",
* : 

## create static qr payment

 - [POST /v3/payments/pos](https://docs.payconiq.be/apis/merchant-payment.openapi/merchant-endpoints/create_static_qr_payment.md): This API is intended for merchants initiating staticQR payments for specific POS(point of sale). If active payment already exists for provided combination of profileId and posId, then existing payment will be invalidated and new one created.
Onboarded merchants should have api keys for each profile, the api key will carry the profileId information required to find the correct creditor in the merchant-service

The token/api-key necessary to call this endpoint must contain:
*  : "" or ""
* : "",
* :