# AML links

**POST** `https://api.heleket.com/v1/payment/aml-links`

A payment can fall under AML verification and move to the locked status. To unlock the funds, the payer must complete a AML questionnaire — KYC or SoF (Source of Funds).

## Request

### Body parameters

| Name | Parameter type | Definition |
| --- | --- | --- |
| uuid | string<br>uuid<br>required\_without: order\_id| Invoice uuid |
| order\_id | string<br>required\_without: uuid| Invoice order ID |

> You need to pass one of the required parameters, if you pass both, the account will be identified by **order\_id**

### Request example

```
curl https://api.heleket.com/v1/payment/aml-links \
-X POST \
-H 'merchant: 8b03432e-385b-4670-8d06-064591096795' \
-H 'sign: fe99035f86fa436181717b302b95bacff1' \
-H 'Content-Type: application/json' \
-d '{
    "order_id": "order-42"
}'
```

## Response

### Response parameters

| Name | Definition |
| --- | --- |
| link | Link to the AML questionnaire that is passed to the user |
| expired\_at | Link expiration date and time in ISO 8601 (UTC) |
| status | Questionnaire completion status |

### Link statuses

| Name | Definition |
| --- | --- |
| init | Link created, the questionnaire has not been started yet |
| pending | The questionnaire is in progress |
| completed | The questionnaire is completed |
| expired | The completion period has expired |

### Response example

```
{
    "state": 0,
    "result": [
        {
            "link": "https://some.link",
            "expired_at": "2025-10-23T18:23:40.000000Z",
            "status": "completed"
        },
        {
            "link": "https://some.link",
            "expired_at": "2026-05-13T11:32:38.000000Z",
            "status": "init"
        }
    ]
}
```