# Manage sanctions requests
Managing sanctions requests efficiently helps reduce processing delays, improve customer experience, and maintain compliance with regulations.
You can respond to sanctions requests securely using the Dashboard or the API, within 11 calendar days from when we sent the request. It may take up to 24 hours for our Operations Team to make a decision on the payment based on your response.
If you'd like to automate the process of receiving and responding to sanctions requests, you can use the compliance request API together with webhook.
---
## Respond using the API
Using the API and webhook, you can receive automated sanctions requests and respond to them programmatically. Automating parts of the process reduces transaction delays for your customers and minimizes the risk of payment cancellations.
This is useful if you receive a large number of sanctions requests or process cross-border payments that often require supplementary data for successful clearing.
### How it works
1. When we create a sanctions request, you can configure to be notified through the Request for information webhook.
2. You call the API to get the details of the sanctions request.
3. You reach out to your customer and obtain the required information.
4. You respond to the request using the API.
5. We review the information you provided and make a decision on the payment. We may contact you if we need more information to make a decision.
### Set up webhook notifications
Configure the [Request for information](https://www.checkout.com/docs/developer-resources/event-notifications/event-types/request_for_information.md) webhook to receive instant notifications for new sanctions requests. This enables you to respond to them faster and reduce payment delays.
### Get the sanctions request
Call the [Get a compliance request](https://api-reference.checkout.com/tag/Compliance-requests/#operation/ComplianceRequests_GetComplianceRequest) endpoint and provide the relevant payment ID from the webhook as the `payment_id` path parameter.
In the request body, provide the required information to respond to the request.
> **Information**
>
> Your base URL's `{prefix}` value is unique to your account and environment. To learn how to retrieve your base URLs for the sandbox and production environments, see [API endpoints](https://www.checkout.com/docs/developer-resources/api/api-endpoints.md).
**Production**
`GET` `https://{prefix}.api.checkout.com/compliance-requests/{payment_id}`
**Sandbox**
`GET` `https://{prefix}.api.sandbox.checkout.com/compliance-requests/{payment_id}`
#### Response example
```json
{
"payment_id": "pay_fun26akvvjjerahhctaq2uzhu4",
"client_id": "cli_vkuhvk4vjn2edkps7dfsq6emqm",
"entity_id": "ent_azsiyswl7bwe2ynjzujy7lcjca",
"segment_id": "seg_siopnqocrc4ehgyer4tpepq5pp",
"amount": "38.23",
"currency": "HKD",
"recipient_name": "Jia Tsang",
"requested_on": "2026-04-21T09:46:44.9663151Z",
"status": "created",
"fields": {
"sender": [
{
"name": "date_of_birth",
"type": "date_of_birth"
}
],
"recipient": [
{
"name": "country_of_incorporation",
"type": "country"
}
]
},
"transaction_reference": "ORDER_01234",
"sender_reference": "SENDER_01234",
"last_updated": "2026-04-21T09:46:44.9663151Z",
"sender_name": "Ali Farid",
"payment_type": "PayToCard"
}
```
### Respond to sanctions requests
To respond to sanctions requests using the API, your API key must have the following scopes enabled:
- `compliance-requests`
- `compliance-requests:read`
- `compliance-requests:respond`
Call the [Submit compliance request response](https://api-reference.checkout.com/tag/Compliance-requests/#operation/ComplianceRequests_SubmitComplianceRequestResponse) endpoint and provide the relevant payment ID as the `payment_id` path parameter.
In the request body, provide the required information to respond to the request.
> **Information**
>
> Your base URL's `{prefix}` value is unique to your account and environment. To learn how to retrieve your base URLs for the sandbox and production environments, see [API endpoints](https://www.checkout.com/docs/developer-resources/api/api-endpoints.md).
**Production**
`POST` `https://{prefix}.api.checkout.com/compliance-requests/{payment_id}`
**Sandbox**
`POST` `https://{prefix}.api.sandbox.checkout.com/compliance-requests/{payment_id}`
#### Request example
```json
{
"fields":{
"sender":[
{
"name":"date_of_birth",
"value":"2000-01-01",
"not_available":false
}
],
"recipient":[
{
"name":"country_of_incorporation",
"not_available": true
}
]
},
"comments":"Optional comments"
}
```
---
## Respond using the Dashboard
Using email notifications and the Dashboard, you can respond to sanctions requests.
You must have the _Compliance Operator_ [user role](https://www.checkout.com/docs/business-operations/use-the-dashboard/user-permissions.md) or a custom role with the following permissions:
- `Manage compliance requests`
- `View compliance requests`
### View sanctions screening status
You can track the status of a sanctions review in the payment's timeline:
1. Sign in to the [Dashboard](https://dashboard.checkout.com).
2. Go to _Payments_ > _Processing_ > _All payments_.
3. Select the relevant payment.
4. In the _Payment details_ page that opens, go to the _Payment timeline_ section.
The _Sanction screening_ field displays the sanctions review result.
### Set up email notifications
There are two types of notifications you can opt in for:
- _New compliance request created_ – You receive an email notification when a new compliance request is created.
- _Daily compliance request summary_ – You receive a daily email summary with the number of compliance requests that require a response and those that expire in less than 24 hours. This notification is useful if you receive multiple compliance requests a day.
To receive notifications for new sanctions requests to your email address, you must have a user role with the following permissions:
- `Create, edit and delete workflow notifications`
- `View the list of workflow notifications permissions`
1. Sign in to the [Dashboard](https://dashboard.checkout.com).
2. Select the _Settings menu_ in the top navigation bar, and then select _Settings_.
3. Under _Personal settings_, select _Notifications_.
4. Open the _Compliance requests_ tab.
5. Select the notifications you want to receive.
To set up notifications for new sanctions requests to one or more group/team email addresses, you must have the Admin user role.
1. Sign in to the [Dashboard](https://dashboard.checkout.com).
2. Select the _Settings menu_ in the top navigation bar, and then select _Settings_.
3. Under _Business settings_, select _Business contacts_.
The compliance request recipients are displayed.
4. Select _Edit_ to provide the group/team email addresses.
5. In the pop-up window that opens, enter the email addresses.
6. Select _Confirm_.
### Respond to sanctions requests
1. Sign in to the [Dashboard](https://dashboard.checkout.com).
2. Go to _Payments_ > _Processing_ > _Compliance requests_.
The requests that require a response are displayed.
3. Select a request to view the details.
4. In the _Respond to compliance request_ page that opens, enter the required information.
You can also see the details of the payment the request was created for.
5. Select _Submit_.
---
## Sanctions request fields
The following fields may be requested during a sanctions review.
### Person fields
| Field name | API field |
| --- | --- |
| Date of birth | `date_of_birth` |
| Full legal name | `full_legal_name` |
| Gender | `gender` |
| Government issued ID number | `government_issued_id` |
| Nationality | `nationality` |
| Occupation | `occupation` |
| Source of funds | `source_of_funds` |
### Entity fields
| Field name | API field |
| --- | --- |
| Business address | `business_address` |
| Business type | `business_type` |
| Company number | `company_number` |
| Country of incorporation | `country_of_incorporation` |
| Legal business name | `legal_business_name` |