Create

Overview

The create method creates a customer record in the payment processor system.

Business Use Case: A new user signs up. Create their profile for faster checkout.

Purpose

Scenario	Benefit
Faster checkout	Skip entering details
Payment history	Track payments

Request Fields

Field	Type	Required	Description
merchantCustomerId	string	Yes	Your unique customer reference
email	string	No	Customer email
name	string	No	Customer name
phone	string	No	Customer phone

Response Fields

Field	Type	Description
merchantCustomerId	string	Your reference
connectorCustomerId	string	Connector's customer ID
status	CustomerStatus	ACTIVE
statusCode	int	HTTP status code

Example

SDK Setup

use HyperswitchPrism\CustomerClient;

$customerClient = new CustomerClient([
    'connector' => 'stripe',
    'apiKey' => 'YOUR_API_KEY',
    'environment' => 'SANDBOX'
]);

Request

$request = [
    'merchantCustomerId' => 'cust_user_12345',
    'email' => '[email protected]',
    'name' => 'John Doe',
    'phone' => '[phone]'
];

$response = $customerClient->create($request);

Response

[
    'merchantCustomerId' => 'cust_user_12345',
    'connectorCustomerId' => 'cus_xxx',
    'status' => 'ACTIVE',
    'statusCode' => 200
]

Next Steps

• Payment Method Service - Store payment methods

• Payment Service - Process payments