WATA API

https://wata.pro/api_en
Admin
WATA API is a REST-based payment processing platform that enables merchants to accept online...
Tokens:9,595
Snippets:21
Trust Score:5.3
Update:7 months ago
Show doc for...
Tokens:
Raw
### Example Public Key Response

Source: https://wata.pro/api_en

This is an example of a successful response when requesting the public key. The 'value' field contains the PEM-encoded public key, which should be used to initialize your signature verification process.

```json
{
  "value": "-----BEGIN PUBLIC KEY-----\nMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAoL3WIP92OShyu4Y+ecbS\nZJQyU2AW7gbg8X3KqX7dkctQL54kcxvpMySR8UMjZOCSzLuly2BFHP1pNVMPF304\nuIVpRtHtwEw3k3qE259L/7xEJHSzfehHuMlfSng7Lh/HxLW93douDCwohJvAISwF\ncXlqmNo/eJfBu9kQNlclQXFMYLHOtotZbsMM/oAJJvks7bgnN5o9RXMx8SG5rfq/\naK+BZAlEC83HTpnVrv0wpjmeleSPDSiOkWIY6BBTcg1bpH162en9XasJ/xnHLBFY\nkQSjFQw8nN17CFpd5Hkb0QpABgSEVStvaeLHF5XrWi3B/x5v8sUKsEgUnOJ7LnlH\nHQIDAQAB\n-----END PUBLIC KEY-----"
```

--------------------------------

### Example Webhook Notification

Source: https://wata.pro/api_en

This example illustrates the structure of a webhook notification sent by the WATA API. It includes details about the transaction, such as type, ID, status, amount, currency, and payment time. This data should be processed and validated upon receipt.

```json
Content-Type: application/json
X-Signature: <signature>
{
   "transactionType": "CardCrypto",
   "transactionId": "3a16a4f0-27b0-09d1-16da-ba8d5c63eae3",
   "transactionStatus": "Paid",
   "errorCode": null,
   "errorDescription": null,
   "terminalName": "string",
   "amount": 1188.00,
   "currency": "RUB",
   "orderId": "string",
   "orderDescription": "string ",
   "paymentTime": "2024-12-04T17:41:44.434598Z ",
   "commission": 10,
   "email": null
}
```

--------------------------------

### Search Payment Links (API Request)

Source: https://wata.pro/api_en

Example of an API request to search for payment links. It demonstrates using query parameters to filter by amount, currency, status, sorting, and pagination.

```http
GET https://api.wata.pro/api/h2h/links/?amountFrom=10&currencies=RUB&statuses=Opened&sorting=OrderId&skipCount=5&maxResultCount=5
Content-Type: application/json
Authorization: Bearer <access-token>
```

--------------------------------

### Create Payment Link Response (JSON)

Source: https://wata.pro/api_en

Example JSON response received after successfully creating a payment link. It contains the unique identifier, status, payment URL, and other details of the created link.

```json
{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "amount": 1188.00,
  "currency": "RUB",
  "status": "Opened",
  "url": "string",
  "terminalName": "string",
  "terminalPublicId": "3fa85f22-2108-1749-a7gj-9c134g55hkl0",
  "creationTime": "2024-12-03T12:09:33.390Z",
  "orderId": "string",
  "description": "string",
  "successRedirectUrl": "string",
  "failRedirectUrl": "string",
  "expirationDateTime": "2024-15-03T12:09:33.390Z"
}
```

--------------------------------

### Search Payment Links (API Response)

Source: https://wata.pro/api_en

Example of a successful response when searching for payment links. The response includes a list of matching payment links and the total count of available records.

```json
{
  "items": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "amount": 1188.00,
      "currency": "RUB",
      "status": "Opened",
      "url": "string",
      "terminalName": "string",
      "terminalPublicId": "3fa85f22-2108-1749-a7gj-9c134g55hkl0",
      "creationTime": "2024-12-06T16:47:29.106Z",
      "orderId": "string"
    }
  ],
  "totalCount": 0
}
```

--------------------------------

### Get Transaction by UUID Request

Source: https://wata.pro/api_en

This snippet demonstrates how to make a GET request to retrieve a specific transaction using its unique identifier (UUID). It includes the necessary endpoint, headers for content type and authorization.

```http
GET https://api.wata.pro/api/h2h/transactions/3a16a4f0-27b0-09d1-16da-ba8d5c63eae3
Content-Type: application/json
Authorization: Bearer <access-token>
```

--------------------------------

### Create Payment Link Request (JSON)

Source: https://wata.pro/api_en

Example JSON payload for creating a payment link via the WATA Pro API. It includes essential details such as amount, currency, order ID, and redirect URLs.

```json
{
  "amount": 1188.00,
  "currency": "RUB",
  "description": "string",
  "orderId": "string",
  "successRedirectUrl": "string",
  "failRedirectUrl": "string",
  "expirationDateTime": "2024-15-03T12:09:33.390Z"
}
```

--------------------------------

### Get Payment Link by UUID (API Request)

Source: https://wata.pro/api_en

Demonstrates how to make an API request to retrieve a specific payment link using its unique identifier (UUID). Requires an access token for authorization.

```http
GET https://api.wata.pro/api/h2h/links/3fa85f64-5717-4562-b3fc-2c963f66afa6
Content-Type: application/json
Authorization: Bearer <access-token>
```

--------------------------------

### Get Payment Link by UUID

Source: https://wata.pro/api_en

Retrieves a specific payment link using its unique identifier (UUID).

```APIDOC
## GET /api/h2h/links/{id}

### Description
Retrieves a specific payment link using its unique identifier (UUID).

### Method
GET

### Endpoint
`/api/h2h/links/{id}`

### Parameters
#### Path Parameters
- **id** (UUID) - Required - The unique identifier of the payment link.

### Request Example
```
GET https://api.wata.pro/api/h2h/links/3fa85f64-5717-4562-b3fc-2c963f66afa6
Content-Type: application/json
Authorization: Bearer <access-token>
```

### Response
#### Success Response (200)
- **id** (UUID) - Order identifier in the WATA system (not the transaction UUID)
- **amount** (Number) - Payment amount. Must be a number with up to two decimal places (e.g., 1188.00)
- **currency** (String) - Payment currency (RUB, EUR, USD)
- **status** (String) - Status of the payment link (Opened, Closed)
- **url** (String) - Payment link URL
- **terminalName** (String) - Merchant's store name
- **terminalPublicId** (UUID) - Merchant's store identifier
- **creationTime** (Date) - Date and time when the payment link was created (UTC)
- **orderId** (String) - Order ID in the merchant's system
- **description** (String) - Order description
- **successRedirectUrl** (String) - URL where the customer will be redirected after successful payment
- **failRedirectUrl** (String) - URL where the customer will be redirected after failed payment
- **expirationDateTime** (Date) - Expiration time of the payment link. Defaults to 3 days. Maximum duration is 30 days

#### Response Example
```json
{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "amount": 1188.00,
  "currency": "RUB",
  "status": "Opened",
  "url": "string",
  "terminalName": "string",
  "terminalPublicId": "3fa85f22-2108-1749-a7gj-9c134g55hkl0",
  "creationTime": "2024-12-03T12:09:33.390Z",
  "orderId": "string",
  "description": "string",
  "successRedirectUrl": "string",
  "failRedirectUrl": "string",
  "expirationDateTime": "2024-15-03T12:09:33.390Z"
}
```
```

--------------------------------

### GET /api/h2h/links/{id}

Source: https://wata.pro/api_en

Retrieves the details of a specific payment link using its unique identifier (UUID).

```APIDOC
## GET /api/h2h/links/{id}

### Description
Retrieves the details of a specific payment link using its unique identifier (UUID).

### Method
GET

### Endpoint
/api/h2h/links/{id}

### Parameters
#### Path Parameters
- **id** (UUID) - Required - Identifier of the payment link

### Response
#### Success Response (200)
- **id** (UUID) - Order identifier in the WATA system (not the transaction UUID)
- **amount** (Number) - Payment amount. Must be a number with up to two decimal places (e.g., 1188.00)
- **currency** (String) - Payment currency (RUB, EUR, USD)
- **status** (String) - Status of the payment link (Opened, Closed)
- **url** (String) - Payment link URL
- **terminalName** (String) - Merchant's store name
- **terminalPublicId** (UUID) - Merchant's store identifier
- **creationTime** (Date) - Date and time when the payment link was created (UTC)
- **orderId** (String) - Order ID in the merchant's system
- **description** (String) - Order description
- **successRedirectUrl** (String) - URL where the customer will be redirected after successful payment
- **failRedirectUrl** (String) - URL where the customer will be redirected after failed payment
- **expirationDateTime** (Date) - Expiration time of the payment link. Defaults to 3 days. Maximum duration is 30 days

#### Response Example
```json
{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "amount": 1188.00,
  "currency": "RUB",
  "status": "Opened",
  "url": "string",
  "terminalName": "string",
  "terminalPublicId": "3fa85f22-2108-1749-a7gj-9c134g55hkl0",
  "creationTime": "2024-12-03T12:09:33.390Z",
  "orderId": "string",
  "description": "string",
  "successRedirectUrl": "string",
  "failRedirectUrl": "string",
  "expirationDateTime": "2024-15-03T12:09:33.390Z"
}
```
```

--------------------------------

### Get Transaction by UUID

Source: https://wata.pro/api_en

Retrieves details of a specific transaction using its unique identifier.

```APIDOC
## GET /api/h2h/transactions/{id}

### Description
Retrieves details of a specific transaction using its unique identifier.

### Method
GET

### Endpoint
/api/h2h/transactions/{id}

#### Path Parameters
- **id** (UUID) - Required - Transaction identifier

#### Request Example
```
GET https://api.wata.pro/api/h2h/transactions/3a16a4f0-27b0-09d1-16da-ba8d5c63eae3
Content-Type: application/json
Authorization: Bearer <access-token>
```

### Response
#### Success Response (200)
- **id** (UUID) - Transaction identifier in the WATA system
- **terminalName** (String) - Merchant store name
- **terminalPublicId** (UUID) - Public identifier of the merchant’s store
- **type** (String) - Transaction type (CardCrypto, SBP). CardCrypto – RUB and foreign currency card payments. SBP – Fast Payment System
- **amount** (Number) - Payment amount. Must have up to two decimal places (e.g., 1188.00)
- **currency** (String) - Payment currency (RUB, EUR, USD)
- **status** (String) - Transaction status (Pending, Paid, Declined)
- **errorCode** (String) - Error code in case of a failed request (see Error Code Reference)
- **errorDescription** (String) - Error description in case of a failed request
- **orderId** (String) - Order ID in the merchant’s system
- **orderDescription** (String) - Order description
- **creationTime** (Date) - Transaction creation time in UTC
- **paymentTime** (Date) - Transaction payment time in UTC (when status changed to Paid or Declined)
- **totalCommission** (Number) - Transaction commission
- **sbpLink** (String) - QR code link (only if the transaction type is SBP)

#### Response Example
```json
{
  "terminalName": "string",
  "terminalPublicId": "3a16a4dd-8c83-fa4d-897a-3b334ed0ebed",
  "type": "CardCrypto",
  "amount": 1188.00,
  "currency": "RUB",
  "status": "Paid",
  "errorCode": null,
  "errorDescription": null,
  "orderId": "string",
  "orderDescription": "string",
  "creationTime": "2024-12-04T17:41:33.744768Z",
  "paymentTime": "2024-12-04T17:41:44.434598Z",
  "totalCommission": 10,
  "sbpLink": null,
  "paymentLinkId": null,
  "id": "3a16a4f0-27b0-09d1-16da-ba8d5c63eae3"
}
```
```

--------------------------------

### Get Transaction by UUID Response (200 OK)

Source: https://wata.pro/api_en

This snippet shows a successful response (HTTP 200 OK) when retrieving a transaction by its UUID. It outlines the structure and types of the returned transaction data, including details like terminal name, amount, currency, and status.

```json
{
  "terminalName": "string",
  "terminalPublicId": "3a16a4dd-8c83-fa4d-897a-3b334ed0ebed",
  "type": "CardCrypto",
  "amount": 1188.00,
  "currency": "RUB",
  "status": "Paid",
  "errorCode": null,
  "errorDescription": null,
  "orderId": "string",
  "orderDescription": "string",
  "creationTime": "2024-12-04T17:41:33.744768Z",
  "paymentTime": "2024-12-04T17:41:44.434598Z",
  "totalCommission": 10,
  "sbpLink": null,
  "paymentLinkId": null,
  "id": "3a16a4f0-27b0-09d1-16da-ba8d5c63eae3"
}
```

--------------------------------

### GET /api/h2h/public-key

Source: https://wata.pro/api_en

Retrieves the public key required for verifying the signature of incoming webhook notifications. This key is essential for ensuring the authenticity and integrity of the data received from WATA Pro.

```APIDOC
## GET /api/h2h/public-key

### Description
Retrieves the public key used for signature verification of webhook notifications.

### Method
GET

### Endpoint
/api/h2h/public-key

### Parameters
#### Query Parameters
None

#### Request Body
None

### Request Example
```
GET https://api.wata.pro/api/h2h/public-key 
Content-Type: application/json
```

### Response
#### Success Response (200)
- **value** (String) - The value of the public key in PEM format.

#### Response Example
```json
{
  "value": "-----BEGIN PUBLIC KEY-----\nMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAoL3WIP92OShyu4Y+ecbS\nZJQyU2AW7gbg8X3KqX7dkctQL54kcxvpMySR8UMjZOCSzLuly2BFHP1pNVMPF304\nuIVpRtHtwEw3k3qE259L/7xEJHSzfehHuMlfSng7h/HxLW93douDCwohJvAISwF\ncXlqmNo/eJfBu9kQNlclQXFMYLHOtotZbsMM/oAJJvks7bgnN5o9RXMx8SG5rfq/\naK+BZAlEC83HTpnVrv0wpjmeleSPDSiOkWIY6BBTcg1bpH162en9XasJ/xnHLBFY\nkQSjFQw8nN17CFpd5Hkb0QpABgSEVStvaeLHF5XrWi3B/x5v8sUKsEgUnOJ7LnlH\nHQIDAQAB\n-----END PUBLIC KEY-----"
}
```
```

--------------------------------

### POST /api/h2h/links

Source: https://wata.pro/api_en

Creates a new payment link with specified details. The customer will be redirected to the success or fail URL upon payment completion.

```APIDOC
## POST /api/h2h/links

### Description
Creates a new payment link with specified details. The customer will be redirected to the success or fail URL upon payment completion.

### Method
POST

### Endpoint
/api/h2h/links

### Parameters
#### Query Parameters
- **amount** (Number) - Required - Payment amount. Must be a number with up to two decimal places (e.g., 1188.00)
- **currency** (String) - Required - Payment currency (RUB, EUR, USD)
- **description** (String) - Optional - Order description
- **orderId** (String) - Optional - Order ID in the merchant's system
- **successRedirectUrl** (String) - Optional - URL where the customer will be redirected after successful payment
- **failRedirectUrl** (String) - Optional - URL where the customer will be redirected after failed payment
- **expirationDateTime** (Date) - Optional - Expiration time of the payment link. Defaults to 3 days. Maximum duration is 30 days

### Request Example
```json
{
  "amount": 1188.00,
  "currency": "RUB",
  "description": "string",
  "orderId": "string",
  "successRedirectUrl": "string",
  "failRedirectUrl": "string",
  "expirationDateTime": "2024-15-03T12:09:33.390Z"
}
```

### Response
#### Success Response (200)
- **id** (UUID) - Order identifier in the WATA system (not the transaction UUID)
- **amount** (Number) - Payment amount. Must be a number with up to two decimal places (e.g., 1188.00)
- **currency** (String) - Payment currency (RUB, EUR, USD)
- **status** (String) - Status of the payment link (Opened, Closed)
- **url** (String) - Payment link URL
- **terminalName** (String) - Merchant's store name
- **terminalPublicId** (UUID) - Merchant's store identifier
- **creationTime** (Date) - Date and time when the payment link was created (UTC)
- **orderId** (String) - Order ID in the merchant's system
- **description** (String) - Order description
- **successRedirectUrl** (String) - URL where the customer will be redirected after successful payment
- **failRedirectUrl** (String) - URL where the customer will be redirected after failed payment
- **expirationDateTime** (Date) - Expiration time of the payment link. Defaults to 3 days. Maximum duration is 30 days

#### Response Example
```json
{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "amount": 1188.00,
  "currency": "RUB",
  "status": "Opened",
  "url": "string",
  "terminalName": "string",
  "terminalPublicId": "3fa85f22-2108-1749-a7gj-9c134g55hkl0",
  "creationTime": "2024-12-03T12:09:33.390Z",
  "orderId": "string",
  "description": "string",
  "successRedirectUrl": "string",
  "failRedirectUrl": "string",
  "expirationDateTime": "2024-15-03T12:09:33.390Z"
}
```
```

--------------------------------

### Verify Webhook Signature with Java

Source: https://wata.pro/api_en

This Java code snippet demonstrates how to verify a webhook signature. It takes raw webhook JSON and a base64 encoded signature, then uses a public key to verify the signature's authenticity. Ensure the UTF-8 encoding and Base64 decoding are handled correctly.

```java
public boolean verifySignature(String rawWebhookJson, String signature) {
        try {
            Signature publicSignature = Signature.getInstance("SHA256withRSA");
            // Assuming publicKey is already initialized and loaded with the public key
            // publicSignature.initVerify(publicKey);
            publicSignature.update(rawWebhookJson.getBytes(StandardCharsets.UTF_8));

            byte[] signatureBytes = Base64.getDecoder().decode(signature);

            return publicSignature.verify(signatureBytes);
        } catch (NoSuchAlgorithmException | InvalidKeyException | SignatureException e) {
            // Handle exceptions appropriately
            e.printStackTrace();
            return false;
        }
    }
}
```

--------------------------------

### Search Transactions Request Parameters

Source: https://wata.pro/api_en

This section details the parameters available for searching transactions. It specifies which parameters are optional, their data types, and a brief description of their purpose, enabling filtering by order ID, creation time, amount, currency, status, and sorting options.

```text
Parameter|Required|Type|Description
---|---|---|---
orderId|No|String|Order ID in the merchant’s system
creationTimeFrom|No|Date|Filter by creation date (from)
creationTimeTo|No|Date|Filter by creation date (to)
amountFrom|No|Number|Minimum payment amount
amountTo|No|Number|Maximum payment amount
currencies|No|String|Currency filter
statuses|No|String|Transaction status (Pending, Paid, Declined)
sorting|No|String|Field to sort the transaction list by. Available options: amount, creationTime. To sort in descending order, add the desc suffix (e.g., amount desc)
skipCount|No|Number|Number of records to skip. Default is 0
maxResultCount|No|Number|Number of records to return. Default is 10, maximum is 1000
```

--------------------------------

### Payment Links API

Source: https://wata.pro/api_en

This section details how to create payment links using the WATA API. Payment links are single-use and direct users to WATA's hosted payment form.

```APIDOC
## POST /api/payment-links

### Description
Creates a single-use payment link that directs users to WATA's payment form. The payment form can display multiple payment methods based on the merchant's terminal configuration.

### Method
POST

### Endpoint
/api/payment-links

### Parameters
#### Query Parameters
- **amount** (Number) - Required - Payment amount. Must be a number with up to two decimal places (e.g., 1188.00).
- **currency** (String) - Required - Payment currency (RUB, EUR, USD).
- **description** (String) - Optional - Order description.
- **orderId** (String) - Optional - Order ID in the merchant's system.

### Request Example
```json
{
  "amount": 100.50,
  "currency": "USD",
  "description": "Monthly subscription fee",
  "orderId": "sub_12345"
}
```

### Response
#### Success Response (200)
- **payment_link** (String) - The generated URL for the payment link.

#### Response Example
```json
{
  "payment_link": "https://pay.wata.com/pay/abcdef1234567890"
}
```
```

--------------------------------

### Webhook Notification Handling

Source: https://wata.pro/api_en

Handles incoming webhook notifications from WATA Pro, providing details about transaction status changes. It includes parameters for transaction type, amount, currency, status, and more.

```APIDOC
## Webhook Notification

### Description
Receives webhook notifications regarding transaction status updates. This endpoint requires signature verification using the public key obtained from the `/api/h2h/public-key` endpoint.

### Method
POST (typically, but not explicitly stated in the provided text)

### Endpoint
(Not specified in the provided text, assumed to be a merchant-defined endpoint)

### Parameters
#### Headers
- **Content-Type** (String) - Required - `application/json`
- **X-Signature** (String) - Required - The Base64 encoded signature of the webhook payload.

#### Request Body
- **transactionType** (String) - Required - Transaction type (e.g., `CardCrypto`).
- **terminalName** (String) - Required - Merchant store name.
- **transactionId** (UUID) - Required - Transaction identifier in the WATA system.
- **transactionStatus** (String) - Required - Transaction status (`Paid` or `Declined`).
- **amount** (Number) - Required - Payment amount with up to two decimal places (e.g., 1188.00).
- **currency** (String) - Required - Payment currency (e.g., `RUB`, `EUR`, `USD`).
- **errorCode** (String) - Optional - Error code if the transaction failed.
- **errorDescription** (String) - Optional - Error description if the transaction failed.
- **orderId** (String) - Required - Order ID in the merchant’s system.
- **orderDescription** (String) - Optional - Order description.
- **commission** (Number) - Optional - Transaction commission.
- **paymentTime** (Date) - Required - Payment timestamp (UTC) in ISO 8601 format.
- **email** (String) - Optional - Payer’s email address.

### Request Example
```json
{
   "transactionType": "CardCrypto",
   "transactionId": "3a16a4f0-27b0-09d1-16da-ba8d5c63eae3",
   "transactionStatus": "Paid",
   "errorCode": null,
   "errorDescription": null,
   "terminalName": "string",
   "amount": 1188.00,
   "currency": "RUB",
   "orderId": "string",
   "orderDescription": "string ",
   "paymentTime": "2024-12-04T17:41:44.434598Z",
   "commission": 10,
   "email": null
}
```

### Response
(Typically, webhooks do not expect a detailed JSON response, but an HTTP status code indicating success or failure of receiving the notification. A 2xx status code is generally expected.)

#### Success Response (200 OK)
Indicates that the webhook notification was successfully received and processed by the merchant's server.

#### Response Example
(No specific JSON response body is expected for a successful webhook receipt. An HTTP 200 OK status is sufficient.)
```

--------------------------------

### Search Payment Links

Source: https://wata.pro/api_en

Searches for payment links based on various filter criteria.

```APIDOC
## GET /api/h2h/links/

### Description
Searches for payment links based on various filter criteria.

### Method
GET

### Endpoint
`/api/h2h/links/`

### Parameters
#### Query Parameters
- **amountFrom** (Number) - Optional - Minimum payment amount.
- **amountTo** (Number) - Optional - Maximum payment amount.
- **сreationTimeFrom** (Date) - Optional - Filter by creation date (from).
- **сreationTimeTo** (Date) - Optional - Filter by creation date (to).
- **orderId** (String) - Optional - Order ID in the merchant's system.
- **сurrencies** (String) - Optional - Currency filter.
- **statuses** (String) - Optional - Payment link status (Opened, Closed).
- **sorting** (String) - Optional - Field to sort the response list by. Available options: orderId, creationTime, amount. Add the `desc` suffix for descending order (e.g., `amount desc`).
- **skipCount** (Number) - Optional - Number of records to skip. Default is 0.
- **maxResultCount** (Number) - Optional - Number of records to return. Default is 10, maximum is 1000.

### Request Example
```
GET https://api.wata.pro/api/h2h/links/?amountFrom=10&currencies=RUB&statuses=Opened&sorting=OrderId&skipCount=5&maxResultCount=5
Content-Type: application/json
Authorization: Bearer <access-token>
```

### Response
#### Success Response (200)
- **items** (Array) - An array of payment link objects.
  - **id** (UUID) - Order identifier in the WATA system (not the transaction UUID).
  - **amount** (Number) - Payment amount. Must be a number with up to two decimal places (e.g., 1188.00).
  - **currency** (String) - Payment currency (RUB, EUR, USD).
  - **status** (String) - Status of the payment link (Opened, Closed).
  - **url** (String) - Payment link URL.
  - **terminalName** (String) - Merchant's store name.
  - **terminalPublicId** (UUID) - Merchant's store identifier.
  - **creationTime** (Date) - Date and time when the payment link was created (UTC).
  - **orderId** (String) - Order ID in the merchant's system.
- **totalCount** (Number) - The total number of payment links matching the criteria.

#### Response Example
```json
{
  "items": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "amount": 1188.00,
      "currency": "RUB",
      "status": "Opened",
      "url": "string",
      "terminalName": "string",
      "terminalPublicId": "3fa85f22-2108-1749-a7gj-9c134g55hkl0",
      "creationTime": "2024-12-06T16:47:29.106Z",
      "orderId": "string"
    }
  ],
  "totalCount": 0
}
```
```

--------------------------------

### Retrieve Public Key for Signature Verification

Source: https://wata.pro/api_en

This section describes how to retrieve the public key required for verifying webhook signatures. The API endpoint returns the public key as a Base64 encoded string within a JSON object. This key is essential for validating the integrity of incoming webhook data.

```http
GET https://api.wata.pro/api/h2h/public-key 
Content-Type: application/json
```

--------------------------------

### Search Transactions

Source: https://wata.pro/api_en

Allows searching and filtering transactions based on various criteria.

```APIDOC
## GET /api/h2h/transactions

### Description
Allows searching and filtering transactions based on various criteria.

### Method
GET

### Endpoint
/api/h2h/transactions

#### Query Parameters
- **orderId** (String) - Optional - Order ID in the merchant’s system
- **creationTimeFrom** (Date) - Optional - Filter by creation date (from)
- **creationTimeTo** (Date) - Optional - Filter by creation date (to)
- **amountFrom** (Number) - Optional - Minimum payment amount
- **amountTo** (Number) - Optional - Maximum payment amount
- **currencies** (String) - Optional - Currency filter
- **statuses** (String) - Optional - Transaction status (Pending, Paid, Declined)
- **sorting** (String) - Optional - Field to sort the transaction list by. Available options: amount, creationTime. To sort in descending order, add the desc suffix (e.g., amount desc)
- **skipCount** (Number) - Optional - Number of records to skip. Default is 0
- **maxResultCount** (Number) - Optional - Number of records to return. Default is 10, maximum is 1000

### Response
#### Success Response (200)
- **id** (UUID) - Transaction identifier in the WATA system
- **terminalName** (String) - Merchant store name
- **terminalPublicId** (UUID) - Public identifier of the merchant's store
- **type** (String) - Transaction type (CardCrypto). CardCrypto – card payments in RUB or foreign currency
- **amount** (Number) - Payment amount. Must have up to two decimal places (e.g., 1188.00)

*Note: The response for this endpoint may contain additional fields not fully detailed here, such as `currency`, `status`, `creationTime`, etc., similar to the Get Transaction by UUID response.*
```
Tokens:
Raw