curl --request POST \
--url https://api.dintero.com/v1/accounts/{aid}/compliance-search/match \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"merchant": {
"business_name": "<string>",
"address": {
"address_line": "<string>",
"city": "<string>",
"postal_code": "<string>",
"country": "<string>",
"address_line_2": "<string>"
},
"principals": [
{
"first_name": "<string>",
"last_name": "<string>",
"email": "abc@xxx.com",
"phone_number": "3165557625",
"address": {
"address_line": "<string>",
"city": "<string>",
"country": "<string>",
"address_line_2": "<string>",
"postal_code": "<string>"
},
"date_of_birth": "‘1980-01-01’"
}
],
"phone_number": "<string>",
"merchant_category": "1234",
"trade_name": "<string>",
"website_url": "<string>"
},
"search_criteria": {
"search_all": "<string>",
"region": [
"1",
"A",
"D"
],
"country": [
"NOR",
"USA",
"CAN"
]
}
}
'import requests
url = "https://api.dintero.com/v1/accounts/{aid}/compliance-search/match"
payload = {
"merchant": {
"business_name": "<string>",
"address": {
"address_line": "<string>",
"city": "<string>",
"postal_code": "<string>",
"country": "<string>",
"address_line_2": "<string>"
},
"principals": [
{
"first_name": "<string>",
"last_name": "<string>",
"email": "abc@xxx.com",
"phone_number": "3165557625",
"address": {
"address_line": "<string>",
"city": "<string>",
"country": "<string>",
"address_line_2": "<string>",
"postal_code": "<string>"
},
"date_of_birth": "‘1980-01-01’"
}
],
"phone_number": "<string>",
"merchant_category": "1234",
"trade_name": "<string>",
"website_url": "<string>"
},
"search_criteria": {
"search_all": "<string>",
"region": ["1", "A", "D"],
"country": ["NOR", "USA", "CAN"]
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
merchant: {
business_name: '<string>',
address: {
address_line: '<string>',
city: '<string>',
postal_code: '<string>',
country: '<string>',
address_line_2: '<string>'
},
principals: [
{
first_name: '<string>',
last_name: '<string>',
email: 'abc@xxx.com',
phone_number: '3165557625',
address: {
address_line: '<string>',
city: '<string>',
country: '<string>',
address_line_2: '<string>',
postal_code: '<string>'
},
date_of_birth: '‘1980-01-01’'
}
],
phone_number: '<string>',
merchant_category: '1234',
trade_name: '<string>',
website_url: '<string>'
},
search_criteria: {
search_all: '<string>',
region: ['1', 'A', 'D'],
country: ['NOR', 'USA', 'CAN']
}
})
};
fetch('https://api.dintero.com/v1/accounts/{aid}/compliance-search/match', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.dintero.com/v1/accounts/{aid}/compliance-search/match"
payload := strings.NewReader("{\n \"merchant\": {\n \"business_name\": \"<string>\",\n \"address\": {\n \"address_line\": \"<string>\",\n \"city\": \"<string>\",\n \"postal_code\": \"<string>\",\n \"country\": \"<string>\",\n \"address_line_2\": \"<string>\"\n },\n \"principals\": [\n {\n \"first_name\": \"<string>\",\n \"last_name\": \"<string>\",\n \"email\": \"abc@xxx.com\",\n \"phone_number\": \"3165557625\",\n \"address\": {\n \"address_line\": \"<string>\",\n \"city\": \"<string>\",\n \"country\": \"<string>\",\n \"address_line_2\": \"<string>\",\n \"postal_code\": \"<string>\"\n },\n \"date_of_birth\": \"‘1980-01-01’\"\n }\n ],\n \"phone_number\": \"<string>\",\n \"merchant_category\": \"1234\",\n \"trade_name\": \"<string>\",\n \"website_url\": \"<string>\"\n },\n \"search_criteria\": {\n \"search_all\": \"<string>\",\n \"region\": [\n \"1\",\n \"A\",\n \"D\"\n ],\n \"country\": [\n \"NOR\",\n \"USA\",\n \"CAN\"\n ]\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.dintero.com/v1/accounts/{aid}/compliance-search/match")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"merchant\": {\n \"business_name\": \"<string>\",\n \"address\": {\n \"address_line\": \"<string>\",\n \"city\": \"<string>\",\n \"postal_code\": \"<string>\",\n \"country\": \"<string>\",\n \"address_line_2\": \"<string>\"\n },\n \"principals\": [\n {\n \"first_name\": \"<string>\",\n \"last_name\": \"<string>\",\n \"email\": \"abc@xxx.com\",\n \"phone_number\": \"3165557625\",\n \"address\": {\n \"address_line\": \"<string>\",\n \"city\": \"<string>\",\n \"country\": \"<string>\",\n \"address_line_2\": \"<string>\",\n \"postal_code\": \"<string>\"\n },\n \"date_of_birth\": \"‘1980-01-01’\"\n }\n ],\n \"phone_number\": \"<string>\",\n \"merchant_category\": \"1234\",\n \"trade_name\": \"<string>\",\n \"website_url\": \"<string>\"\n },\n \"search_criteria\": {\n \"search_all\": \"<string>\",\n \"region\": [\n \"1\",\n \"A\",\n \"D\"\n ],\n \"country\": [\n \"NOR\",\n \"USA\",\n \"CAN\"\n ]\n }\n}")
.asString();{
"starting_after": 123,
"inquiry_reference_number": "<string>",
"possible_matches": [
{
"total_merchant_matches": 123,
"terminated_merchants": [
{
"merchant": {
"name": "<string>",
"doing_business_as_name": "<string>",
"address": {
"address_line_one": "<string>",
"address_line_two": "<string>",
"city": "<string>",
"country_subdivision": "<string>",
"province": "<string>",
"postal_code": "<string>",
"country": "<string>"
},
"phone_number": "<string>",
"alt_phone_number": "<string>",
"national_tax_id": "<string>",
"country_subdivision_tax_id": "<string>",
"urls": [
"<string>"
],
"principals": [
{
"first_name": "<string>",
"middle_initial": "<string>",
"last_name": "<string>",
"address": {
"address_line_one": "<string>",
"address_line_two": "<string>",
"city": "<string>",
"country_subdivision": "<string>",
"province": "<string>",
"postal_code": "<string>",
"country": "<string>"
},
"phone_number": "<string>",
"email": "<string>",
"alt_phone_number": "<string>",
"national_id": "<string>",
"drivers_license": {
"number": "<string>",
"country_subdivision": "<string>",
"country": "<string>"
}
}
],
"added_on_date": "2024-01-17",
"termination_reason_code": "13",
"added_by_acquirer_id": "<string>",
"url_groups": [
{
"exact_match_urls": {
"urls": [
"<string>"
]
},
"close_match_urls": {
"urls": [
"<string>"
]
},
"no_match_urls": {
"urls": [
"<string>"
]
}
}
],
"comments": "Added for reasons of fraud"
},
"merchant_match": {
"name": "<string>",
"doing_business_as_name": "<string>",
"phone_number": "<string>",
"address": "<string>",
"alt_phone_number": "<string>",
"country_subdivision_tax_id": "<string>",
"national_tax_id": "<string>",
"principal_matches": [
{
"name": "<string>",
"address": "<string>",
"phone_number": "<string>",
"alt_phone_number": "<string>",
"national_id": "<string>",
"drivers_license": "<string>",
"email": "<string>",
"date_of_birth": "<string>"
}
]
}
}
]
}
]
}{
"error": {
"message": "<string>",
"code": "<string>",
"errors": [
{}
]
}
}{
"error": {
"message": "<string>",
"code": "<string>",
"errors": [
{}
]
}
}{
"error": {
"message": "<string>",
"code": "<string>",
"errors": [
{}
]
}
}{
"error": {
"message": "<string>",
"code": "<string>",
"errors": [
{}
]
}
}MATCH register search
Search the MATCH register for any potential matches related to fraud for the account
scopes:
- read:accounts:/match
curl --request POST \
--url https://api.dintero.com/v1/accounts/{aid}/compliance-search/match \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"merchant": {
"business_name": "<string>",
"address": {
"address_line": "<string>",
"city": "<string>",
"postal_code": "<string>",
"country": "<string>",
"address_line_2": "<string>"
},
"principals": [
{
"first_name": "<string>",
"last_name": "<string>",
"email": "abc@xxx.com",
"phone_number": "3165557625",
"address": {
"address_line": "<string>",
"city": "<string>",
"country": "<string>",
"address_line_2": "<string>",
"postal_code": "<string>"
},
"date_of_birth": "‘1980-01-01’"
}
],
"phone_number": "<string>",
"merchant_category": "1234",
"trade_name": "<string>",
"website_url": "<string>"
},
"search_criteria": {
"search_all": "<string>",
"region": [
"1",
"A",
"D"
],
"country": [
"NOR",
"USA",
"CAN"
]
}
}
'import requests
url = "https://api.dintero.com/v1/accounts/{aid}/compliance-search/match"
payload = {
"merchant": {
"business_name": "<string>",
"address": {
"address_line": "<string>",
"city": "<string>",
"postal_code": "<string>",
"country": "<string>",
"address_line_2": "<string>"
},
"principals": [
{
"first_name": "<string>",
"last_name": "<string>",
"email": "abc@xxx.com",
"phone_number": "3165557625",
"address": {
"address_line": "<string>",
"city": "<string>",
"country": "<string>",
"address_line_2": "<string>",
"postal_code": "<string>"
},
"date_of_birth": "‘1980-01-01’"
}
],
"phone_number": "<string>",
"merchant_category": "1234",
"trade_name": "<string>",
"website_url": "<string>"
},
"search_criteria": {
"search_all": "<string>",
"region": ["1", "A", "D"],
"country": ["NOR", "USA", "CAN"]
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
merchant: {
business_name: '<string>',
address: {
address_line: '<string>',
city: '<string>',
postal_code: '<string>',
country: '<string>',
address_line_2: '<string>'
},
principals: [
{
first_name: '<string>',
last_name: '<string>',
email: 'abc@xxx.com',
phone_number: '3165557625',
address: {
address_line: '<string>',
city: '<string>',
country: '<string>',
address_line_2: '<string>',
postal_code: '<string>'
},
date_of_birth: '‘1980-01-01’'
}
],
phone_number: '<string>',
merchant_category: '1234',
trade_name: '<string>',
website_url: '<string>'
},
search_criteria: {
search_all: '<string>',
region: ['1', 'A', 'D'],
country: ['NOR', 'USA', 'CAN']
}
})
};
fetch('https://api.dintero.com/v1/accounts/{aid}/compliance-search/match', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.dintero.com/v1/accounts/{aid}/compliance-search/match"
payload := strings.NewReader("{\n \"merchant\": {\n \"business_name\": \"<string>\",\n \"address\": {\n \"address_line\": \"<string>\",\n \"city\": \"<string>\",\n \"postal_code\": \"<string>\",\n \"country\": \"<string>\",\n \"address_line_2\": \"<string>\"\n },\n \"principals\": [\n {\n \"first_name\": \"<string>\",\n \"last_name\": \"<string>\",\n \"email\": \"abc@xxx.com\",\n \"phone_number\": \"3165557625\",\n \"address\": {\n \"address_line\": \"<string>\",\n \"city\": \"<string>\",\n \"country\": \"<string>\",\n \"address_line_2\": \"<string>\",\n \"postal_code\": \"<string>\"\n },\n \"date_of_birth\": \"‘1980-01-01’\"\n }\n ],\n \"phone_number\": \"<string>\",\n \"merchant_category\": \"1234\",\n \"trade_name\": \"<string>\",\n \"website_url\": \"<string>\"\n },\n \"search_criteria\": {\n \"search_all\": \"<string>\",\n \"region\": [\n \"1\",\n \"A\",\n \"D\"\n ],\n \"country\": [\n \"NOR\",\n \"USA\",\n \"CAN\"\n ]\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.dintero.com/v1/accounts/{aid}/compliance-search/match")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"merchant\": {\n \"business_name\": \"<string>\",\n \"address\": {\n \"address_line\": \"<string>\",\n \"city\": \"<string>\",\n \"postal_code\": \"<string>\",\n \"country\": \"<string>\",\n \"address_line_2\": \"<string>\"\n },\n \"principals\": [\n {\n \"first_name\": \"<string>\",\n \"last_name\": \"<string>\",\n \"email\": \"abc@xxx.com\",\n \"phone_number\": \"3165557625\",\n \"address\": {\n \"address_line\": \"<string>\",\n \"city\": \"<string>\",\n \"country\": \"<string>\",\n \"address_line_2\": \"<string>\",\n \"postal_code\": \"<string>\"\n },\n \"date_of_birth\": \"‘1980-01-01’\"\n }\n ],\n \"phone_number\": \"<string>\",\n \"merchant_category\": \"1234\",\n \"trade_name\": \"<string>\",\n \"website_url\": \"<string>\"\n },\n \"search_criteria\": {\n \"search_all\": \"<string>\",\n \"region\": [\n \"1\",\n \"A\",\n \"D\"\n ],\n \"country\": [\n \"NOR\",\n \"USA\",\n \"CAN\"\n ]\n }\n}")
.asString();{
"starting_after": 123,
"inquiry_reference_number": "<string>",
"possible_matches": [
{
"total_merchant_matches": 123,
"terminated_merchants": [
{
"merchant": {
"name": "<string>",
"doing_business_as_name": "<string>",
"address": {
"address_line_one": "<string>",
"address_line_two": "<string>",
"city": "<string>",
"country_subdivision": "<string>",
"province": "<string>",
"postal_code": "<string>",
"country": "<string>"
},
"phone_number": "<string>",
"alt_phone_number": "<string>",
"national_tax_id": "<string>",
"country_subdivision_tax_id": "<string>",
"urls": [
"<string>"
],
"principals": [
{
"first_name": "<string>",
"middle_initial": "<string>",
"last_name": "<string>",
"address": {
"address_line_one": "<string>",
"address_line_two": "<string>",
"city": "<string>",
"country_subdivision": "<string>",
"province": "<string>",
"postal_code": "<string>",
"country": "<string>"
},
"phone_number": "<string>",
"email": "<string>",
"alt_phone_number": "<string>",
"national_id": "<string>",
"drivers_license": {
"number": "<string>",
"country_subdivision": "<string>",
"country": "<string>"
}
}
],
"added_on_date": "2024-01-17",
"termination_reason_code": "13",
"added_by_acquirer_id": "<string>",
"url_groups": [
{
"exact_match_urls": {
"urls": [
"<string>"
]
},
"close_match_urls": {
"urls": [
"<string>"
]
},
"no_match_urls": {
"urls": [
"<string>"
]
}
}
],
"comments": "Added for reasons of fraud"
},
"merchant_match": {
"name": "<string>",
"doing_business_as_name": "<string>",
"phone_number": "<string>",
"address": "<string>",
"alt_phone_number": "<string>",
"country_subdivision_tax_id": "<string>",
"national_tax_id": "<string>",
"principal_matches": [
{
"name": "<string>",
"address": "<string>",
"phone_number": "<string>",
"alt_phone_number": "<string>",
"national_id": "<string>",
"drivers_license": "<string>",
"email": "<string>",
"date_of_birth": "<string>"
}
]
}
}
]
}
]
}{
"error": {
"message": "<string>",
"code": "<string>",
"errors": [
{}
]
}
}{
"error": {
"message": "<string>",
"code": "<string>",
"errors": [
{}
]
}
}{
"error": {
"message": "<string>",
"code": "<string>",
"errors": [
{}
]
}
}{
"error": {
"message": "<string>",
"code": "<string>",
"errors": [
{}
]
}
}Authorizations
Bearer authentication (token authentication) should be used for accessing the API.
Use Get Token to get an access token for client credentials. Pass the token in the request header:
Authorization: Bearer {access_token}
where the access_token is JSON Web Tokens (JWT).
Path Parameters
An id that uniquely identifies the account.
9Query Parameters
A limit on the number of objects to be returned. Limit can range between 1 and 100 items, and the default is 20 items.
1 <= x <= 100Zero-based offset to start from. A value of 10 will start with the 11th item
x >= 0Body
Response
Possible merchant matches from MATCH
cursor for use in pagination. starting_after is the zero-based index to start the next request after. For instance, if you send a request that starts at index 0 and returns 10 items, a subsequent call can include starting_after=10 in order to fetch items starting with item 11.
If there are no more items this field is not returned.
Reference number to look up inquiry result
Show child attributes
Show child attributes