# Create Customer Create a new customer record for tracking payments and transactions. ## Request ### Headers ### Body Parameters ## Response ### Success (201 Created) ```json { "success": true, "data": { "customerId": "cust_a1b2c3d4e5f6g7h8", "email": "john@example.com", "phone": "+1234567890", "firstName": "John", "lastName": "Doe", "country": "US", "status": "active", "riskLevel": "low", "createdAt": "2024-01-15T10:30:00.000Z", "updatedAt": "2024-01-15T10:30:00.000Z" }, "message": "Customer created successfully", "error": null, "meta": { "request_id": "req_xxxxx", "timestamp": "2024-01-15T10:30:00.000Z", "processing_time_ms": 120, "api_version": "v1", "endpoint": "POST /customers", "user_type": "merchant" } } ``` ### Error Responses ## Examples ```bash curl -X POST https://api.zenpayz.com/merchant/api/v1/customers \ -H "Authorization: Bearer zp_test_xxxxx" \ -H "X-Timestamp: 2024-01-15T10:30:00.000Z" \ -H "X-Signature: a1b2c3d4e5f6..." \ -H "X-Secret-Salt: your_secret_salt" \ -H "Content-Type: application/json" \ -d '{ "email": "john@example.com", "firstName": "John", "lastName": "Doe", "phone": "+1234567890", "country": "US", "ipAddress": "203.0.113.42" }' ``` ```javascript const response = await fetch('https://api.zenpayz.com/merchant/api/v1/customers', { method: 'POST', headers: { 'Authorization': `Bearer ${apiKey}`, 'X-Timestamp': timestamp, 'X-Signature': signature, 'X-Secret-Salt': secretSalt, 'Content-Type': 'application/json', }, body: JSON.stringify({ email: 'john@example.com', firstName: 'John', lastName: 'Doe', phone: '+1234567890', country: 'US', ipAddress: '203.0.113.42', }), }); const result = await response.json(); console.log(result.data.customerId); // cust_a1b2c3d4e5f6g7h8 ``` ```javascript const customer = await zenpays.customers.create({ email: 'john@example.com', firstName: 'John', lastName: 'Doe', phone: '+1234567890', country: 'US', ipAddress: '203.0.113.42', }); console.log(customer.customerId); // cust_a1b2c3d4e5f6g7h8 ``` ## Related Endpoints - [Get Customer](/docs/rest-api/endpoints/customers/get-customer) - [List Customers](/docs/rest-api/endpoints/customers/list-customers) - [Update Customer](/docs/rest-api/endpoints/customers/update-customer)