Register a Customer | Redpin

Register a new customer in the system. Since customer registration is processed asynchronously, you’ll receive a unique_identifier right away while the full customer record is being created. Use this identifier to retrieve the finalized customer data, or set up webhooks to receive automatic notifications when the customer’s status changes.

Authentication: Bearer token required

Use Cases:

Register new customers for payment services
Onboard customers with complete profile information
Set up customer accounts for international transfers
Enable customers for foreign exchange (FX) and currency conversion services
Register business customers for B2B payment processing and bulk transactions
Onboard property transaction customers for real estate payment processing
Create customer records for multi-currency account management
Set up KYC/AML compliance for new customers before processing payments
Register customers for third-party payment processing and property-related transactions
Initialize customer accounts for receiving quotes and managing currency exchange operations

Register a new customer in the system. Since customer registration is processed asynchronously, you'll receive a unique_identifier right away while the full customer record is being created. Use this identifier to retrieve the finalized customer data, or set up webhooks to receive automatic notifications when the customer's status changes. **Authentication:** [Bearer token required](/api-guide/getting-started/authentication#oauth-20-authentication) **Use Cases:** - Register new customers for payment services - Onboard customers with complete profile information - Set up customer accounts for international transfers - Enable customers for foreign exchange (FX) and currency conversion services - Register business customers for B2B payment processing and bulk transactions - Onboard property transaction customers for real estate payment processing - Create customer records for multi-currency account management - Set up KYC/AML compliance for new customers before processing payments - Register customers for third-party payment processing and property-related transactions - Initialize customer accounts for receiving quotes and managing currency exchange operations

Authentication

AuthorizationBearer

OAuth 2.0 Bearer token authentication. This API uses OAuth 2.0 Client Credentials flow. Please refer to the Authentication section for detailed information on how to obtain and use your OAuth credentials.

Request

This endpoint expects an object.

customer_typeenumRequired

The type of customer being registered.

Allowed values:

Personal: Use this for individual customers registering for personal transactions. This is suitable for individuals making personal payments, transfers, or currency exchanges.
Business: Use this for business entities, corporations, or organizations. When selecting “Business”, you should provide company details in the company field including business registration information, incorporation details, and business address.

Allowed values:

contactslist of objectsRequired

Customer-facing contacts responsible for communication and trading authorisation. Provide one or two contact records for each customer.

additional_detailsobjectRequired

companyobjectOptional

Response

OK. Everything worked as expected. The customer object was created and is pending review. The returned temporary customer number can be used to check for the Customer ID.

client_reference_idstring

Unique reference id that you want to assign to this customer for your own purposes

unique_identifierstring

A unique identifier returned immediately after customer registration. Use this identifier with the Get Customer’s ID endpoint to retrieve the customer’s ID once the registration process is complete.

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

500

Internal Server Error

Authentication: Bearer token required

Use Cases:

Register new customers for payment services
Onboard customers with complete profile information
Set up customer accounts for international transfers
Enable customers for foreign exchange (FX) and currency conversion services
Register business customers for B2B payment processing and bulk transactions
Onboard property transaction customers for real estate payment processing
Create customer records for multi-currency account management
Set up KYC/AML compliance for new customers before processing payments
Register customers for third-party payment processing and property-related transactions
Initialize customer accounts for receiving quotes and managing currency exchange operations

1	curl -X POST https://sandbox.currenciesdirect.com/v1/customers \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"customer_type": "Personal",
6	"contacts": [
7	{
8	"first_name": "Carlos",
9	"last_name": "Lopez",
10	"date_of_birth": "1980-02-14",
11	"email": "carlos@hotmail.com",
12	"mobile_number": "+44-987654321",
13	"primary_contact": true,
14	"authorize_to_trade": true,
15	"address": {
16	"post_code": "77023",
17	"city": "Houston",
18	"country": "USA",
19	"unit_number": "321",
20	"street_number": "468",
21	"street": "Bissonnet Plaza, El Campo",
22	"street_type": "Plaza",
23	"civic_number": "741",
24	"state": "Texas"
25	},
26	"middle_name": "John",
27	"employment_status": "Full-time",
28	"industry": "Technology and Software",
29	"nationality": "United States of America",
30	"phone_number": "(020)123456789",
31	"proof_of_identity": {
32	"passport": {
33	"number": "12345",
34	"place_of_birth": "Houston, USA",
35	"expiry_date": "2025-09-30",
36	"issuing_country": "USA",
37	"name_at_citizenship": "Lopez",
38	"family_name_at_birth": "Lopez"
39	}
40	}
41	}
42	],
43	"additional_details": {
44	"etv": "5,000 - 10,000",
45	"ccy_pair": "GBPUSD",
46	"client_reference_id": "987564823645",
47	"campaign": "987564823645",
48	"campaign_reference": "987564823645",
49	"interested_currencies_to_sell": [
50	"GBP",
51	"USD"
52	],
53	"interested_currencies_to_buy": [
54	"GBP",
55	"USD"
56	]
57	},
58	"company": {
59	"name": "Currencies Direct Ltd.",
60	"type": "Limited",
61	"registration_number": "7878768678",
62	"country_of_incorporation": "IND",
63	"address": {
64	"post_code": "E14 5AA",
65	"city": "London",
66	"country": "GBR",
67	"unit_number": "Floor 45",
68	"street_number": "1",
69	"street": "Canada Square, Canary Wharf",
70	"street_type": "Square",
71	"civic_number": "12345",
72	"state": "England"
73	},
74	"vat_number": "7878768678"
75	}
76	}'

1	{
2	"client_reference_id": "987564823645",
3	"unique_identifier": "6d23072a-ac3e-4146-9b83-7ad384d65707"
4	}