Create a buyer
curl --request POST \
--url https://api.tilta.io/v1/buyers \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"external_id": "<string>",
"legal_name": "ACME GmbH",
"business_address": {
"postcode": "12345",
"city": "Berlin",
"street": "Example Street",
"house": "42b",
"additional": "c/o Testimonial"
},
"trading_name": "ACME",
"registered_at": 1582896122,
"incorporated_at": 1582896122,
"business_identifiers": [
{
"value": "<string>"
}
],
"delivery_address": {
"postcode": "12345",
"city": "Berlin",
"street": "Example Street",
"house": "42b",
"additional": "c/o Testimonial"
},
"custom_data": {}
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
external_id: '<string>',
legal_name: 'ACME GmbH',
business_address: {
postcode: '12345',
city: 'Berlin',
street: 'Example Street',
house: '42b',
additional: 'c/o Testimonial'
},
trading_name: 'ACME',
registered_at: 1582896122,
incorporated_at: 1582896122,
business_identifiers: [{value: '<string>'}],
delivery_address: {
postcode: '12345',
city: 'Berlin',
street: 'Example Street',
house: '42b',
additional: 'c/o Testimonial'
},
custom_data: {}
})
};
fetch('https://api.tilta.io/v1/buyers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.tilta.io/v1/buyers"
payload = {
"external_id": "<string>",
"legal_name": "ACME GmbH",
"business_address": {
"postcode": "12345",
"city": "Berlin",
"street": "Example Street",
"house": "42b",
"additional": "c/o Testimonial"
},
"trading_name": "ACME",
"registered_at": 1582896122,
"incorporated_at": 1582896122,
"business_identifiers": [{ "value": "<string>" }],
"delivery_address": {
"postcode": "12345",
"city": "Berlin",
"street": "Example Street",
"house": "42b",
"additional": "c/o Testimonial"
},
"custom_data": {}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.tilta.io/v1/buyers",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'external_id' => '<string>',
'legal_name' => 'ACME GmbH',
'business_address' => [
'postcode' => '12345',
'city' => 'Berlin',
'street' => 'Example Street',
'house' => '42b',
'additional' => 'c/o Testimonial'
],
'trading_name' => 'ACME',
'registered_at' => 1582896122,
'incorporated_at' => 1582896122,
'business_identifiers' => [
[
'value' => '<string>'
]
],
'delivery_address' => [
'postcode' => '12345',
'city' => 'Berlin',
'street' => 'Example Street',
'house' => '42b',
'additional' => 'c/o Testimonial'
],
'custom_data' => [
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"external_id": "<string>",
"created_at": 1582896122,
"updated_at": 1582896122,
"max_days_past_due": 123,
"legal_name": "ACME GmbH",
"legal_form": "LIMITED_COMPANY",
"business_address": {
"postcode": "12345",
"city": "Berlin",
"country": "AF",
"street": "Example Street",
"house": "42b",
"additional": "c/o Testimonial"
},
"trading_name": "ACME",
"registered_at": 1582896122,
"incorporated_at": 1582896122,
"business_identifiers": [
{
"type": "VAT_ID",
"value": "<string>",
"country": "AF"
}
],
"delivery_address": {
"postcode": "12345",
"city": "Berlin",
"country": "AF",
"street": "Example Street",
"house": "42b",
"additional": "c/o Testimonial"
},
"custom_data": {}
}{
"code": "BAD_REQUEST",
"error": "Request validation failed. 1 issue found.",
"issues": [
{
"code": "INVALID_TYPE",
"path": "body.registered_at",
"message": "Invalid type"
}
]
}{
"error": "Unauthorized",
"code": "UNAUTHORIZED"
}Buyers
Create a buyer
Register a new business buyer on your platform. Pre-fill company data to streamline onboarding and reduce manual input during the credit application.
POST
/
v1
/
buyers
Create a buyer
curl --request POST \
--url https://api.tilta.io/v1/buyers \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"external_id": "<string>",
"legal_name": "ACME GmbH",
"business_address": {
"postcode": "12345",
"city": "Berlin",
"street": "Example Street",
"house": "42b",
"additional": "c/o Testimonial"
},
"trading_name": "ACME",
"registered_at": 1582896122,
"incorporated_at": 1582896122,
"business_identifiers": [
{
"value": "<string>"
}
],
"delivery_address": {
"postcode": "12345",
"city": "Berlin",
"street": "Example Street",
"house": "42b",
"additional": "c/o Testimonial"
},
"custom_data": {}
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
external_id: '<string>',
legal_name: 'ACME GmbH',
business_address: {
postcode: '12345',
city: 'Berlin',
street: 'Example Street',
house: '42b',
additional: 'c/o Testimonial'
},
trading_name: 'ACME',
registered_at: 1582896122,
incorporated_at: 1582896122,
business_identifiers: [{value: '<string>'}],
delivery_address: {
postcode: '12345',
city: 'Berlin',
street: 'Example Street',
house: '42b',
additional: 'c/o Testimonial'
},
custom_data: {}
})
};
fetch('https://api.tilta.io/v1/buyers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.tilta.io/v1/buyers"
payload = {
"external_id": "<string>",
"legal_name": "ACME GmbH",
"business_address": {
"postcode": "12345",
"city": "Berlin",
"street": "Example Street",
"house": "42b",
"additional": "c/o Testimonial"
},
"trading_name": "ACME",
"registered_at": 1582896122,
"incorporated_at": 1582896122,
"business_identifiers": [{ "value": "<string>" }],
"delivery_address": {
"postcode": "12345",
"city": "Berlin",
"street": "Example Street",
"house": "42b",
"additional": "c/o Testimonial"
},
"custom_data": {}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.tilta.io/v1/buyers",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'external_id' => '<string>',
'legal_name' => 'ACME GmbH',
'business_address' => [
'postcode' => '12345',
'city' => 'Berlin',
'street' => 'Example Street',
'house' => '42b',
'additional' => 'c/o Testimonial'
],
'trading_name' => 'ACME',
'registered_at' => 1582896122,
'incorporated_at' => 1582896122,
'business_identifiers' => [
[
'value' => '<string>'
]
],
'delivery_address' => [
'postcode' => '12345',
'city' => 'Berlin',
'street' => 'Example Street',
'house' => '42b',
'additional' => 'c/o Testimonial'
],
'custom_data' => [
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"external_id": "<string>",
"created_at": 1582896122,
"updated_at": 1582896122,
"max_days_past_due": 123,
"legal_name": "ACME GmbH",
"legal_form": "LIMITED_COMPANY",
"business_address": {
"postcode": "12345",
"city": "Berlin",
"country": "AF",
"street": "Example Street",
"house": "42b",
"additional": "c/o Testimonial"
},
"trading_name": "ACME",
"registered_at": 1582896122,
"incorporated_at": 1582896122,
"business_identifiers": [
{
"type": "VAT_ID",
"value": "<string>",
"country": "AF"
}
],
"delivery_address": {
"postcode": "12345",
"city": "Berlin",
"country": "AF",
"street": "Example Street",
"house": "42b",
"additional": "c/o Testimonial"
},
"custom_data": {}
}{
"code": "BAD_REQUEST",
"error": "Request validation failed. 1 issue found.",
"issues": [
{
"code": "INVALID_TYPE",
"path": "body.registered_at",
"message": "Invalid type"
}
]
}{
"error": "Unauthorized",
"code": "UNAUTHORIZED"
}Creating a buyer is the first step in the Tilta integration flow. A buyer represents a business that purchases goods or services from your merchants using Tilta-powered payment terms. Once created, you can request a credit facility for the buyer, enabling them to pay on deferred terms. Submit as much company information as possible at creation – pre-filled data reduces what buyers need to enter during the hosted onboarding flow.
Choose an
external_id that maps reliably to your internal customer or account record. It cannot be changed later, and every
subsequent request references the buyer by it.Authorizations
Your Tilta API key, sent as Bearer <key>.
Body
application/json
Unique identifier of a buyer.
Maximum string length:
100Pattern:
^[a-zA-Z0-9-_]+$Buyer's full legal name incl. the legal form if applicable.
Example:
"ACME GmbH"
Buyer's legal form which depends on the buyer's registered country. Available legal forms cover Tilta's operating countries.
Available options:
LIMITED_COMPANY, SOLE_TRADER, PARTNERSHIP, PUBLIC_COMPANY, COOPERATIVE, GOVERNMENT, OTHER Buyer's billing address.
Show child attributes
Show child attributes
Buyer's trading name. If it's not provided, Tilta will use the legal_name.
Example:
"ACME"
Buyer' registration date (unix time in seconds), when they signed up on your platform.
Example:
1582896122
Buyer's date of incorporation (unix time in seconds), meaning the date when the business of registered or started.
Example:
1582896122
A list of business identifiers
Show child attributes
Show child attributes
Buyer's default delivery address.
Show child attributes
Show child attributes
Free-form metadata for storing integration-specific data alongside this buyer. Replaces the existing object entirely on update.
Show child attributes
Show child attributes
Response
A buyer has been successfully created or updated.
Unique identifier of a buyer.
Maximum string length:
100Pattern:
^[a-zA-Z0-9-_]+$Timestamp indicating when the buyer was created (unix time in seconds).
Example:
1582896122
Timestamp indicating the last time the buyer was updated (unix time in seconds).
Example:
1582896122
Maximum days past due among DUE invoices.
Buyer's full legal name incl. the legal form if applicable.
Example:
"ACME GmbH"
Buyer's legal form which depends on the buyer's registered country. Available legal forms cover Tilta's operating countries.
Available options:
LIMITED_COMPANY, SOLE_TRADER, PARTNERSHIP, PUBLIC_COMPANY, COOPERATIVE, GOVERNMENT, OTHER Buyer's billing address.
Show child attributes
Show child attributes
Buyer's trading name. If it's not provided, Tilta will use the legal_name.
Example:
"ACME"
Buyer' registration date (unix time in seconds), when they signed up on your platform.
Example:
1582896122
Buyer's date of incorporation (unix time in seconds), meaning the date when the business of registered or started.
Example:
1582896122
A list of business identifiers
Show child attributes
Show child attributes
Buyer's default delivery address.
Show child attributes
Show child attributes
Free-form metadata for storing integration-specific data alongside this buyer. Replaces the existing object entirely on update.
Show child attributes
Show child attributes