Create a new customer | Manis Technology

Create the merchant’s customer on a PSP

Request Body:

Field	Type	Required	Description
`pspId`	string	Yes	Identifier of the payment provider (e.g., `nium`, `finmo`).
`type`	string	Yes	Customer type. Acceptable values: `INDIVIDUAL` or `COMPANY`.
`accountUsagePurpose`	string	Yes	Purpose of the account usage (required by Finmo).
`firstName`	string	Yes	Customer’s first name.
`lastName`	string	Yes	Customer’s last name.
`dob`	string	Yes	Date of birth in `YYYY-MM-DD` format.
`countryOfResidence`	string	Yes	Country where the customer resides (ISO 3166-1 alpha-2 code).
`email`	string	Yes	Customer’s email address.
`phoneCountryCode`	string	Yes	Country code for the phone number (e.g., `+1`).
`phoneNumber`	string	Yes	Customer’s phone number.
`addressCountry`	string	Yes	Country of the address (ISO 3166-1 alpha-2 code).
`addressZipCode`	string	Yes	ZIP or postal code.
`addressCity`	string	Yes	City of the address.
`addressState`	string	Yes	State or province.
`addressStreet`	string	Yes	Street name and number.
`addressLocation`	string	Yes	Additional location info (e.g., building, floor).
`identificationType`	string	Yes	Type of ID document (e.g., `PASSPORT`, `NATIONAL_ID`).
`identificationValue`	string	Yes	ID number as shown in the identification document.
`identificationDocumentId`	string	Yes	Document ID from Upload Customer Document API for identification.
`addressProofDocumentId`	string	Yes	Document ID from Upload Customer Document API for address proof.
`companyInfo`	object	Required if `type = COMPANY`	Company details block. Required when creating a company-type customer.

Comapny Information:

Field	Type	Required For `type = COMPANY`	Description
`name`	string	Yes	Legal name of the company.
`website`	string	Yes	Company website URL.
`registrationNumber`	string	Yes	Company registration number.
`incorporationCountry`	string	Yes	Country where the company is incorporated (ISO 3166-1 alpha-2 code).
`incorporationDate`	string	Yes	Incorporation date in `YYYY-MM-DD` format.
`email`	string	Yes	Company contact email.
`phoneCountryCode`	string	Yes	Country code for the company phone number.
`phoneNumber`	string	Yes	Company phone number.
`addressCountry`	string	Yes	Company address country.
`addressZipCode`	string	Yes	ZIP or postal code.
`addressCity`	string	Yes	City of the company address.
`addressState`	string	yes	State or province.
`addressStreet`	string	Yes	Street address.
`addressLocation`	string	Yes	Additional address details (e.g., unit, building).
`incorporationCertificateDocumentId`	string	Yes	Document ID for the incorporation certificate (from Upload API).
`addressProofDocumentId`	string	Yes	Document ID for company address proof (from Upload API).

Response Body

200 OK

Field	Type	Description
`id`	string	Identifier of the customer in Manis
`type`	string	Customer type. Acceptable values: `INDIVIDUAL` or `COMPANY`.
`accountUsagePurpose`	string	Purpose of the account usage (required by Finmo).
`firstName`	string	Customer’s first name.
`lastName`	string	Customer’s last name.
`dob`	string	Date of birth in `YYYY-MM-DD` format.
`countryOfResidence`	string	Country where the customer resides (ISO 3166-1 alpha-2 code).
`email`	string	Customer’s email address.
`phoneCountryCode`	string	Country code for the phone number (e.g., `+1`).
`phoneNumber`	string	Customer’s phone number.
`addressCountry`	string	Country of the address (ISO 3166-1 alpha-2 code).
`addressZipCode`	string	ZIP or postal code.
`addressCity`	string	City of the address.
`addressState`	string	State or province.
`addressStreet`	string	Street name and number.
`addressLocation`	string	Additional location info (e.g., building, floor).
`identificationType`	string	Type of ID document (e.g., `PASSPORT`, `NATIONAL_ID`).
`identificationValue`	string	ID number as shown in the identification document.
`identificationDocumentId`	string	Document ID from Upload Customer Document API for identification.
`addressProofDocumentId`	string	Document ID from Upload Customer Document API for address proof.
`companyInfo`	object	Company details block. Required when creating a company-type customer.
`createdAt`	date(yyyy-MM-dd’T’HH:mm:ss.SSS’Z’)
`createdBy`	string
`updatedAt`	date(yyyy-MM-dd’T’HH:mm:ss.SSS’Z’)
`updatedBy`	string

Comapny Information:

Field	Type	Description
`name`	string	Legal name of the company.
`website`	string	Company website URL.
`registrationNumber`	string	Company registration number.
`incorporationCountry`	string	Country where the company is incorporated (ISO 3166-1 alpha-2 code).
`incorporationDate`	string	Incorporation date in `YYYY-MM-DD` format.
`email`	string	Company contact email.
`phoneCountryCode`	string	Country code for the company phone number.
`phoneNumber`	string	Company phone number.
`addressCountry`	string	Company address country.
`addressZipCode`	string	ZIP or postal code.
`addressCity`	string	City of the company address.
`addressState`	string	State or province.
`addressStreet`	string	Street address.
`addressLocation`	string	Additional address details (e.g., unit, building).
`incorporationCertificateDocumentId`	string	Document ID for the incorporation certificate (from Upload API).
`addressProofDocumentId`	string	Document ID for company address proof (from Upload API).
`createdAt`	date(yyyy-MM-dd’T’HH:mm:ss.SSS’Z’)
`createdBy`	string
`updatedAt`	date(yyyy-MM-dd’T’HH:mm:ss.SSS’Z’)
`updatedBy`	string

400 BAD REQUEST - 403 FORBIDDEN - 401 UNAUTHORIZED - 500 INTERNAL ERROR

Field	type
timestamp	date(yyyy-MM-dd’T’HH:mm:ss.SSS’Z’)
title	string
type	string
status	number
soaCode	string
detail	string

Create the merchant's customer on a PSP **Request Body:** | Field | Type | Required | Description | | --- | --- | --- | --- | | `pspId` | string | Yes | Identifier of the payment provider (e.g., `nium`, `finmo`). | | `type` | string | Yes | Customer type. Acceptable values: `INDIVIDUAL` or `COMPANY`. | | `accountUsagePurpose` | string | Yes | Purpose of the account usage (required by Finmo). | | `firstName` | string | Yes | Customer’s first name. | | `lastName` | string | Yes | Customer’s last name. | | `dob` | string | Yes | Date of birth in `YYYY-MM-DD` format. | | `countryOfResidence` | string | Yes | Country where the customer resides (ISO 3166-1 alpha-2 code). | | `email` | string | Yes | Customer's email address. | | `phoneCountryCode` | string | Yes | Country code for the phone number (e.g., `+1`). | | `phoneNumber` | string | Yes | Customer’s phone number. | | `addressCountry` | string | Yes | Country of the address (ISO 3166-1 alpha-2 code). | | `addressZipCode` | string | Yes | ZIP or postal code. | | `addressCity` | string | Yes | City of the address. | | `addressState` | string | Yes | State or province. | | `addressStreet` | string | Yes | Street name and number. | | `addressLocation` | string | Yes | Additional location info (e.g., building, floor). | | `identificationType` | string | Yes | Type of ID document (e.g., `PASSPORT`, `NATIONAL_ID`). | | `identificationValue` | string | Yes | ID number as shown in the identification document. | | `identificationDocumentId` | string | Yes | Document ID from **Upload Customer Document API** for identification. | | `addressProofDocumentId` | string | Yes | Document ID from **Upload Customer Document API** for address proof. | | `companyInfo` | object | Required if `type = COMPANY` | Company details block. Required when creating a company-type customer. | `Comapny Information:` | Field | Type | Required For `type = COMPANY` | Description | | --- | --- | --- | --- | | `name` | string | Yes | Legal name of the company. | | `website` | string | Yes | Company website URL. | | `registrationNumber` | string | Yes | Company registration number. | | `incorporationCountry` | string | Yes | Country where the company is incorporated (ISO 3166-1 alpha-2 code). | | `incorporationDate` | string | Yes | Incorporation date in `YYYY-MM-DD` format. | | `email` | string | Yes | Company contact email. | | `phoneCountryCode` | string | Yes | Country code for the company phone number. | | `phoneNumber` | string | Yes | Company phone number. | | `addressCountry` | string | Yes | Company address country. | | `addressZipCode` | string | Yes | ZIP or postal code. | | `addressCity` | string | Yes | City of the company address. | | `addressState` | string | yes | State or province. | | `addressStreet` | string | Yes | Street address. | | `addressLocation` | string | Yes | Additional address details (e.g., unit, building). | | `incorporationCertificateDocumentId` | string | Yes | Document ID for the incorporation certificate (from Upload API). | | `addressProofDocumentId` | string | Yes | Document ID for company address proof (from Upload API). | Response Body 200 OK | Field | Type | Description | | --- | --- | --- | | `id` | string | Identifier of the customer in Manis | | `type` | string | Customer type. Acceptable values: `INDIVIDUAL` or `COMPANY`. | | `accountUsagePurpose` | string | Purpose of the account usage (required by Finmo). | | `firstName` | string | Customer’s first name. | | `lastName` | string | Customer’s last name. | | `dob` | string | Date of birth in `YYYY-MM-DD` format. | | `countryOfResidence` | string | Country where the customer resides (ISO 3166-1 alpha-2 code). | | `email` | string | Customer's email address. | | `phoneCountryCode` | string | Country code for the phone number (e.g., `+1`). | | `phoneNumber` | string | Customer’s phone number. | | `addressCountry` | string | Country of the address (ISO 3166-1 alpha-2 code). | | `addressZipCode` | string | ZIP or postal code. | | `addressCity` | string | City of the address. | | `addressState` | string | State or province. | | `addressStreet` | string | Street name and number. | | `addressLocation` | string | Additional location info (e.g., building, floor). | | `identificationType` | string | Type of ID document (e.g., `PASSPORT`, `NATIONAL_ID`). | | `identificationValue` | string | ID number as shown in the identification document. | | `identificationDocumentId` | string | Document ID from **Upload Customer Document API** for identification. | | `addressProofDocumentId` | string | Document ID from **Upload Customer Document API** for address proof. | | `companyInfo` | object | Company details block. Required when creating a company-type customer. | | `createdAt` | date(yyyy-MM-dd'T'HH:mm:ss.SSS'Z') | | | `createdBy` | string | | | `updatedAt` | date(yyyy-MM-dd'T'HH:mm:ss.SSS'Z') | | | `updatedBy` | string | | `Comapny Information:` | Field | Type | Description | | --- | --- | --- | | `name` | string | Legal name of the company. | | `website` | string | Company website URL. | | `registrationNumber` | string | Company registration number. | | `incorporationCountry` | string | Country where the company is incorporated (ISO 3166-1 alpha-2 code). | | `incorporationDate` | string | Incorporation date in `YYYY-MM-DD` format. | | `email` | string | Company contact email. | | `phoneCountryCode` | string | Country code for the company phone number. | | `phoneNumber` | string | Company phone number. | | `addressCountry` | string | Company address country. | | `addressZipCode` | string | ZIP or postal code. | | `addressCity` | string | City of the company address. | | `addressState` | string | State or province. | | `addressStreet` | string | Street address. | | `addressLocation` | string | Additional address details (e.g., unit, building). | | `incorporationCertificateDocumentId` | string | Document ID for the incorporation certificate (from Upload API). | | `addressProofDocumentId` | string | Document ID for company address proof (from Upload API). | | `createdAt` | date(yyyy-MM-dd'T'HH:mm:ss.SSS'Z') | | | `createdBy` | string | | | `updatedAt` | date(yyyy-MM-dd'T'HH:mm:ss.SSS'Z') | | | `updatedBy` | string | | 400 BAD REQUEST - 403 FORBIDDEN - 401 UNAUTHORIZED - 500 INTERNAL ERROR | **Field** | type | | --- | --- | | timestamp | date(yyyy-MM-dd'T'HH:mm:ss.SSS'Z') | | title | string | | type | string | | status | number | | soaCode | string | | detail | string |

Request

This endpoint expects an object.

dobdateRequired

typestringRequired

emailstringRequiredformat: "email"

pspIdstringRequired

lastNamestringRequired

firstNamestringRequired

addressCitystringRequired

companyInfoobjectRequired

phoneNumberstringRequired

addressStatestringRequired

addressStreetstringRequired

addressCountrystringRequired

addressZipCodestringRequired

addressLocationstringRequired

phoneCountryCodestringRequired

countryOfResidencestringRequired

identificationTypestringRequired

accountUsagePurposestringRequired

identificationValuestringRequired

addressProofDocumentIdstringRequired

identificationDocumentIdstringRequired

Response

Create the merchant’s customer on a PSP

Request Body:

Field	Type	Required	Description
`pspId`	string	Yes	Identifier of the payment provider (e.g., `nium`, `finmo`).
`type`	string	Yes	Customer type. Acceptable values: `INDIVIDUAL` or `COMPANY`.
`accountUsagePurpose`	string	Yes	Purpose of the account usage (required by Finmo).
`firstName`	string	Yes	Customer’s first name.
`lastName`	string	Yes	Customer’s last name.
`dob`	string	Yes	Date of birth in `YYYY-MM-DD` format.
`countryOfResidence`	string	Yes	Country where the customer resides (ISO 3166-1 alpha-2 code).
`email`	string	Yes	Customer’s email address.
`phoneCountryCode`	string	Yes	Country code for the phone number (e.g., `+1`).
`phoneNumber`	string	Yes	Customer’s phone number.
`addressCountry`	string	Yes	Country of the address (ISO 3166-1 alpha-2 code).
`addressZipCode`	string	Yes	ZIP or postal code.
`addressCity`	string	Yes	City of the address.
`addressState`	string	Yes	State or province.
`addressStreet`	string	Yes	Street name and number.
`addressLocation`	string	Yes	Additional location info (e.g., building, floor).
`identificationType`	string	Yes	Type of ID document (e.g., `PASSPORT`, `NATIONAL_ID`).
`identificationValue`	string	Yes	ID number as shown in the identification document.
`identificationDocumentId`	string	Yes	Document ID from Upload Customer Document API for identification.
`addressProofDocumentId`	string	Yes	Document ID from Upload Customer Document API for address proof.
`companyInfo`	object	Required if `type = COMPANY`	Company details block. Required when creating a company-type customer.

Comapny Information:

Field	Type	Required For `type = COMPANY`	Description
`name`	string	Yes	Legal name of the company.
`website`	string	Yes	Company website URL.
`registrationNumber`	string	Yes	Company registration number.
`incorporationCountry`	string	Yes	Country where the company is incorporated (ISO 3166-1 alpha-2 code).
`incorporationDate`	string	Yes	Incorporation date in `YYYY-MM-DD` format.
`email`	string	Yes	Company contact email.
`phoneCountryCode`	string	Yes	Country code for the company phone number.
`phoneNumber`	string	Yes	Company phone number.
`addressCountry`	string	Yes	Company address country.
`addressZipCode`	string	Yes	ZIP or postal code.
`addressCity`	string	Yes	City of the company address.
`addressState`	string	yes	State or province.
`addressStreet`	string	Yes	Street address.
`addressLocation`	string	Yes	Additional address details (e.g., unit, building).
`incorporationCertificateDocumentId`	string	Yes	Document ID for the incorporation certificate (from Upload API).
`addressProofDocumentId`	string	Yes	Document ID for company address proof (from Upload API).

Response Body

200 OK

Field	Type	Description
`id`	string	Identifier of the customer in Manis
`type`	string	Customer type. Acceptable values: `INDIVIDUAL` or `COMPANY`.
`accountUsagePurpose`	string	Purpose of the account usage (required by Finmo).
`firstName`	string	Customer’s first name.
`lastName`	string	Customer’s last name.
`dob`	string	Date of birth in `YYYY-MM-DD` format.
`countryOfResidence`	string	Country where the customer resides (ISO 3166-1 alpha-2 code).
`email`	string	Customer’s email address.
`phoneCountryCode`	string	Country code for the phone number (e.g., `+1`).
`phoneNumber`	string	Customer’s phone number.
`addressCountry`	string	Country of the address (ISO 3166-1 alpha-2 code).
`addressZipCode`	string	ZIP or postal code.
`addressCity`	string	City of the address.
`addressState`	string	State or province.
`addressStreet`	string	Street name and number.
`addressLocation`	string	Additional location info (e.g., building, floor).
`identificationType`	string	Type of ID document (e.g., `PASSPORT`, `NATIONAL_ID`).
`identificationValue`	string	ID number as shown in the identification document.
`identificationDocumentId`	string	Document ID from Upload Customer Document API for identification.
`addressProofDocumentId`	string	Document ID from Upload Customer Document API for address proof.
`companyInfo`	object	Company details block. Required when creating a company-type customer.
`createdAt`	date(yyyy-MM-dd’T’HH:mm:ss.SSS’Z’)
`createdBy`	string
`updatedAt`	date(yyyy-MM-dd’T’HH:mm:ss.SSS’Z’)
`updatedBy`	string

Comapny Information:

Field	Type	Description
`name`	string	Legal name of the company.
`website`	string	Company website URL.
`registrationNumber`	string	Company registration number.
`incorporationCountry`	string	Country where the company is incorporated (ISO 3166-1 alpha-2 code).
`incorporationDate`	string	Incorporation date in `YYYY-MM-DD` format.
`email`	string	Company contact email.
`phoneCountryCode`	string	Country code for the company phone number.
`phoneNumber`	string	Company phone number.
`addressCountry`	string	Company address country.
`addressZipCode`	string	ZIP or postal code.
`addressCity`	string	City of the company address.
`addressState`	string	State or province.
`addressStreet`	string	Street address.
`addressLocation`	string	Additional address details (e.g., unit, building).
`incorporationCertificateDocumentId`	string	Document ID for the incorporation certificate (from Upload API).
`addressProofDocumentId`	string	Document ID for company address proof (from Upload API).
`createdAt`	date(yyyy-MM-dd’T’HH:mm:ss.SSS’Z’)
`createdBy`	string
`updatedAt`	date(yyyy-MM-dd’T’HH:mm:ss.SSS’Z’)
`updatedBy`	string

400 BAD REQUEST - 403 FORBIDDEN - 401 UNAUTHORIZED - 500 INTERNAL ERROR

Field	type
timestamp	date(yyyy-MM-dd’T’HH:mm:ss.SSS’Z’)
title	string
type	string
status	number
soaCode	string
detail	string

1	curl -X POST https://https//https/api/v1/customers \
2	-H "Content-Type: application/json" \
3	-d '{
4	"dob": "1999-01-30",
5	"type": "COMPANY",
6	"email": "s7@mail.com",
7	"pspId": "finmo",
8	"lastName": "string",
9	"firstName": "string",
10	"addressCity": "string",
11	"companyInfo": {
12	"name": "string",
13	"email": "stringEmail@gmail.com",
14	"website": "https://https//company.site",
15	"addressCity": "string",
16	"phoneNumber": "920192912",
17	"addressState": "string",
18	"addressStreet": "string",
19	"addressCountry": "US",
20	"addressZipCode": "100",
21	"addressLocation": "string",
22	"phoneCountryCode": "+1",
23	"incorporationDate": "1998-01-01",
24	"registrationNumber": "11",
25	"incorporationCountry": "US",
26	"addressProofDocumentId": "org_doc_9482e9d80ff143beaf52328fb6956058",
27	"incorporationCertificateDocumentId": "org_doc_9482e9d80ff143beaf52328fb6956058"
28	},
29	"phoneNumber": "920192912",
30	"addressState": "string",
31	"addressStreet": "string",
32	"addressCountry": "US",
33	"addressZipCode": "100",
34	"addressLocation": "string",
35	"phoneCountryCode": "+1",
36	"countryOfResidence": "CA",
37	"identificationType": "PASSPORT",
38	"accountUsagePurpose": "string",
39	"identificationValue": "string",
40	"addressProofDocumentId": "org_doc_9482e9d80ff143beaf52328fb6956058",
41	"identificationDocumentId": "org_doc_9482e9d80ff143beaf52328fb6956058"
42	}'