Create Third-Party Customer | Redpin

This is a compliance data collection endpoint that gathers information about the actual end users (funding parties) who will be making property payments through Redpin’s platform via partner applications, without creating direct customer relationships with Redpin. These end users are referred to as “third-parties” because they access Redpin’s services indirectly through their relationship with the partner, making them third-party to the direct Redpin-partner relationship.

This allows Redpin to meet regulatory requirements for international property payments while the customer relationship remains entirely with the partner platform.

Common Use Cases This endpoint is specifically designed for:

Property Developers facilitating international buyer payments
Real Estate Asset Management Platforms handling investor transactions
Fractional Investment Platforms managing partial property ownership payments
Title Company Software Providers processing closing transactions
Real Estate Sales Management Solutions coordinating international property purchases

Authentication: Bearer token required

This is a compliance data collection endpoint that gathers information about the actual end users (funding parties) who will be making property payments through Redpin's platform via partner applications, without creating direct customer relationships with Redpin. These end users are referred to as "third-parties" because they access Redpin's services indirectly through their relationship with the partner, making them third-party to the direct Redpin-partner relationship. This allows Redpin to meet regulatory requirements for international property payments while the customer relationship remains entirely with the partner platform. **Common Use Cases** This endpoint is specifically designed for: - Property Developers facilitating international buyer payments - Real Estate Asset Management Platforms handling investor transactions - Fractional Investment Platforms managing partial property ownership payments - Title Company Software Providers processing closing transactions - Real Estate Sales Management Solutions coordinating international property purchases **Authentication:** [Bearer token required](/api-guide/getting-started/authentication#oauth-20-authentication)

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

customer_idstringRequired

Unique identifier of the partner platform creating the third-party customer

Request

This endpoint expects an object.

client_customer_detailsobjectRequired

property_detailslist of objectsRequired

Array of property details to associate with the third-party customer.

Multiple Properties Support: This endpoint supports creating a customer with multiple property associations in a single request. Each property in the array will be processed and linked to the customer, enabling management of diversified property portfolios under one customer profile.

Array of property details to associate with the third-party customer. **Multiple Properties Support:** This endpoint supports creating a customer with multiple property associations in a single request. Each property in the array will be processed and linked to the customer, enabling management of diversified property portfolios under one customer profile.

Response

Third-party customer created successfully

client_customer_refstring

The customer reference that was provided in the request

statusenum

Status of the third party customer.

APPROVED: Compliance check has passed successfully.
REJECTED: Compliance check has failed due to validation or regulatory issues.
PENDING: Compliance check is still in progress.

Status of the third party customer. - `APPROVED`: Compliance check has passed successfully. - `REJECTED`: Compliance check has failed due to validation or regulatory issues. - `PENDING`: Compliance check is still in progress.

Allowed values:

Errors

This allows Redpin to meet regulatory requirements for international property payments while the customer relationship remains entirely with the partner platform.

Common Use Cases This endpoint is specifically designed for:

Property Developers facilitating international buyer payments
Real Estate Asset Management Platforms handling investor transactions
Fractional Investment Platforms managing partial property ownership payments
Title Company Software Providers processing closing transactions
Real Estate Sales Management Solutions coordinating international property purchases

Authentication: Bearer token required

1	curl -X POST https://api.redpincompany.com/v1/customers/020123456789/third-parties \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"client_customer_details": {
6	"client_customer_ref": "SKYLINE-CLIENT-001",
7	"first_name": "Sarah",
8	"last_name": "Johnson",
9	"email": "sarah.johnson@example.com",
10	"mobile_phone": "+14155552671",
11	"country": "USA",
12	"date_of_birth": "1985-03-15",
13	"address": {
14	"address_line": "123 Main St, Apt 4B",
15	"city": "New York",
16	"state": "NY",
17	"post_code": "10001",
18	"country": "USA"
19	},
20	"currency": "USD",
21	"occupation": "Software Engineer",
22	"employer_name": "Google",
23	"income_range": {
24	"currency": "GBP",
25	"min_value": 10000,
26	"max_value": 20000
27	}
28	},
29	"property_details": [
30	{
31	"property_ref": "SKYLINE_HEIGHTS/SKYLINE_TOWER/1001",
32	"unit_number": "1001",
33	"building_name": "Skyline Tower",
34	"project_name": "Skyline Heights Apartments",
35	"property_purchase_amount": {
36	"currency": "USD",
37	"value": 10000
38	},
39	"payment_schedule": [
40	{
41	"payment_date": "2024-01-15",
42	"amount": {
43	"currency": "USD",
44	"value": 5000
45	}
46	},
47	{
48	"payment_date": "2024-06-15",
49	"amount": {
50	"currency": "USD",
51	"value": 5000
52	}
53	}
54	]
55	},
56	{
57	"property_ref": "SKYLINE_HEIGHTS/SKYLINE_TOWER/1002",
58	"unit_number": "1002",
59	"building_name": "Skyline Tower",
60	"project_name": "Skyline Heights Apartments",
61	"property_purchase_amount": {
62	"currency": "USD",
63	"value": 12000
64	},
65	"payment_schedule": [
66	{
67	"payment_date": "2024-02-15",
68	"amount": {
69	"currency": "USD",
70	"value": 6000
71	}
72	},
73	{
74	"payment_date": "2024-07-15",
75	"amount": {
76	"currency": "USD",
77	"value": 6000
78	}
79	}
80	]
81	}
82	]
83	}'

1	{
2	"client_customer_ref": "SKYLINE-CLIENT-001",
3	"status": "APPROVED"
4	}