Manage sanctions requests

Last updated: April 23, 2026

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.

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.

When we create a sanctions request, you can configure to be notified through the Request for information received webhook.
You call the API to get the details of the sanctions request.
You reach out to your customer and obtain the required information.
You respond to the request using the API.
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.

Configure the Request for information received webhook to receive instant notifications for new sanctions requests. This enables you to respond to them faster and reduce payment delays.

Call the Get a compliance request 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.

get

https://{prefix}.api.checkout.com/compliance-requests/{payment_id}


1{
2  "payment_id": "pay_fun26akvvjjerahhctaq2uzhu4",
3  "client_id": "cli_vkuhvk4vjn2edkps7dfsq6emqm",
4  "entity_id": "ent_azsiyswl7bwe2ynjzujy7lcjca",
5  "segment_id": "seg_siopnqocrc4ehgyer4tpepq5pp",
6  "amount": "38.23",
7  "currency": "HKD",
8  "recipient_name": "Jia Tsang",
9  "requested_on": "2026-04-21T09:46:44.9663151Z",
10  "status": "created",
11  "fields": {
12    "sender": [
13      {
14        "name": "date_of_birth",
15        "type": "date_of_birth"
16      }
17    ],
18    "recipient": [
19      {
20        "name": "country_of_incorporation",
21        "type": "country"
22      }
23    ]
24  },
25  "transaction_reference": "ORDER_01234",
26  "sender_reference": "SENDER_01234",
27  "last_updated": "2026-04-21T09:46:44.9663151Z",
28  "sender_name": "Ali Farid",
29  "payment_type": "PayToCard"
30}

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

post

https://{prefix}.api.checkout.com/compliance-requests/{payment_id}


1{
2   "fields":{
3      "sender":[
4         {
5            "name":"date_of_birth",
6            "value":"2000-01-01",
7            "not_available":false
8         }
9      ],
10      "recipient":[
11         {
12            "name":"country_of_incorporation",
13            "not_available": true
14         }
15      ]
16   },
17   "comments":"Optional comments"
18}

Using email notifications and the Dashboard, you can respond to sanctions requests.

You must have the Compliance Operator user role or a custom role with the following permissions:

Manage compliance requests
View compliance requests

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

Sign in to the Dashboard.
Select the Settings menu in the top navigation bar, and then select Settings.
Under Personal settings, select Notifications.
Open the Compliance requests tab.
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.

Sign in to the Dashboard.
Select the Settings menu in the top navigation bar, and then select Settings.
Under Business settings, select Business contacts.
The compliance request recipients are displayed.
Select Edit to provide the group/team email addresses.
In the pop-up window that opens, enter the email addresses.
Select Confirm.

Sign in to the Dashboard.
Go to Payments > Processing > Compliance requests.
The requests that require a response are displayed.
Select a request to view the details.
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.
Select Submit.

The following fields may be requested during a sanctions review.

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`

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`

Manage sanctions requests

Respond using the API

How it works

Set up webhook notifications

Get the sanctions request

Information

Response example

Respond to sanctions requests

Information

Request example

Respond using the Dashboard

Set up email notifications

Respond to sanctions requests

Sanctions request fields

Person fields

Entity fields