Create a customer in core banking.
Authentication is mandatory.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
📢 Considerations
- Biometric validations and blacklisting of KYC APIs must be performed before invoking this API: KYC Check.
-
When the customer you are trying to create already exists, you will receive as response the value:
existing_customerintrueotherwise infalse. -
The formats of the attributes of type
datemust have the format:yyyy-MM-dd. -
The minimum age (age of majority) to create a client through this API is 18 years old and the maximum age is 100 years old.
-
Due to internal policies OpenBanking does not allow the creation of clients that are PEP (Publicly Exposed Persons), when the field "Is a PEP client" (
is_pep) is set totrue, the API will return a BadRequest and will not allow its creation. -
In order to create clients in LAFISE Bank of Panama (
BLPA) with Nicaraguan nationality and who identify themselves with a passport, the following fields are required:- Work start date (
work_start_date) - Code of the corregimiento where the job is located (
work_geographic_location) - Personal reference (
personal_reference) - Contact number of the personal reference submitted by the customer (
telephone_number) - Work telephone number (
work_phone_number) - Workplace address (
work_address) - Customer's salary or monthly income (
salary) - The customer's job position (
position_in_company) - Employer or company where the customer works (
employer)
- Work start date (
-
To create clients in Banco LAFISE de Costa Rica, you will be asked for authorization (
consultationin_cicac) to access and use your information in the Know Your Customer Information Center (CICAC), in case the client denies such authorization, you must indicate one of the following reason codes (reason_decline_cicac) :1for: Customer who does not have a digital signature and lives abroad.2for: Customer who does not want their information to be in other databases.3for: Others
In case the customer selects the third option, he/she must detail his/her reason in a maximum of 100 characters (
another_reason_cicac).
📖 Example Requests
Below you will find the body of five sample JSON requests:
- Example 1: Create a customer in the Nicaragua Core.
- Example 2: Create a customer in the Costa Rica Core.
- Example 3: Create a customer in the Panamá Core.
- Example 4: Create a customer in the Honduras Core.
- Example 5: Create a customer in the República Dominicana Core (Profile regular).
- Example 6: Create a customer in the República Dominicana Core (Profile simplified).
{
"first_name": "Rosibeth",
"middle_name" : "Abigail",
"last_name": "Meza",
"second_surname" : "Gutierrez",
"identification_type": "4",
"identification": "000-000000-000000",
"mobile_phone_number": 88888888,
"email": "[email protected]",
"date_of_birth": "2001-03-10",
"country_of_residence": "NIC",
"home_address_line1": "Address 1",
"home_address_line2": "Address 2",
"home_address_line3": "Address 2",
"geographic_location": "31-5",
"person_type": "NAT",
"sex": "M",
"identification_expiration_date": "2020-01-25",
"employer": "RESINTO ANGELES",
"country_of_birth": "NIC",
"nationality": "NIC",
"work_phone_number": 22222222,
"title": "00015",
"marital_status" : "C",
"salary" : 20000,
"occupation" : "0SP88",
"economic_activity" : "A09",
"is_pep" : false,
"is_pnp" : false,
"second_nationality" : "USA",
"economic_sector_code" : "PRV"
}{
"first_name": "Walter",
"middle_name": "Rodolph",
"last_name": "White",
"second_surname": "Rivera",
"identification_type": "2",
"identification": "00000000X",
"mobile_phone_number": 88888888,
"email": "[email protected]",
"date_of_birth": "1993-02-04",
"country_of_residence": "COS",
"home_address_line1": "Address 1",
"home_address_line2": "Address 2",
"home_address_line3": "Address 3",
"geographic_location": "PSJ-SJS-001-009",
"person_type": "NAT",
"sex": "M",
"identification_expiration_date": "2030-02-04",
"employer": "Test company",
"position_in_company": "Programmer",
"salary": 1000,
"work_start_date": "2019-04-15",
"personal_reference": "",
"telephone_number": 0,
"work_address": "Test",
"country_of_birth": "COS",
"nationality": "COS",
"work_phone_number": 0,
"title": "PDC",
"marital_status": "1",
"occupation": "PDC",
"economic_activity": "Q55",
"is_pep": false,
"consultation_in_cicac": false,
"reason_decline_cicac": "3",
"another_reason_cicac": "other reason",
"funds_origin": "2"
}{
"first_name": "Luisa",
"last_name": "Lorent",
"identification_type": "0010",
"identification": "8-9999-99999",
"mobile_phone_number": 88888888,
"email": "[email protected]",
"date_of_birth": "2020-08-18",
"country_of_residence": "PAN",
"home_address_line1": "Adderss 1",
"home_address_line2": "Adderss 2",
"home_address_line3": "PANAMA",
"geographic_location": "0001-0101-0001",
"person_type": "NAT",
"sex": "F",
"identification_expiration_date": "2020-01-25",
"employer": "PABANA",
"position_in_company": "Gerente",
"work_start_date": "2019-05-15",
"personal_reference": "Persona estudiosa",
"telephone_number": 88888888,
"work_address": "De la esquina a la derecha",
"country_of_birth": "PAN",
"nationality": "PAN",
"work_geographic_location": "0001-0106-0001",
"title": "AY47",
"marital_status": "1",
"occupation": "0052",
"economic_activity": "SE2",
"is_pep": true,
"second_nationality": "USA"
}{
"first_name": "Matheus",
"middle_name": "Jhosep",
"last_name": "Cabrera",
"second_surname": "Rodriguez",
"identification_type": "1",
"identification": "99999999999X",
"mobile_phone_number": 88888888,
"email": "[email protected]",
"date_of_birth": "1978-07-31",
"country_of_residence": "214",
"home_address_line1": "home_address_line1",
"home_address_line2": "home_address_line2",
"home_address_line3": "home_address_line3",
"geographic_location": "10-1002",
"person_type": "NAT",
"sex": "F",
"identification_expiration_date": "2031-07-31",
"employer": "N1CO",
"salary": 100000,
"work_start_date": "2018-04-16",
"telephone_number": 99999999,
"work_phone_number": 99999999,
"country_of_birth": "214",
"nationality": "214",
"title": "LIC",
"marital_status": "1",
"occupation": "ACIV",
"economic_activity": "COME",
"is_pep": false
}{
"person_type": "NAT",
"first_name": "Carlos",
"middle_name": "Juan",
"last_name": "Lopez",
"second_surname": "Moran",
"sex": "M",
"marital_status": "2",
"nationality": "DO",
"is_fatca": false,
"residence_street": "Marginal Avenida Las Américas",
"residence_building": "Edif. Cumbre 8, NACO",
"residence_apartment_number": "29, Apto. 10 Oeste",
"geographic_location": "0100-0101-01",
"work_geographic_location": "0100-0101-01",
"email": "[email protected]",
"identification": "4013001950848",
"identification_type": "CIP",
"identification_country": "DO",
"identification_expiration_date": "2030-09-06T04:25:21.928Z",
"second_identification_number": "2013001950848",
"second_identification_type_code": "9999",
"second_identification_country_code": "NIC",
"second_identification_expiration_date": "2030-09-06T04:25:21.928Z",
"date_of_birth": "1971-04-18T22:16:33.387Z",
"country_of_birth": "DO",
"telephone_number": 8098888888,
"work_phone_number": 809888888800001,
"mobile_phone_number": 8093402152,
"country_of_residence": "DO",
"economic_activity": "2836",
"occupation": "511",
"employer": "ELECTROVAL, SRL",
"work_address": "AVE. TIRADENTES N14, EDIF. EMPRESARIAL",
"position_in_company": "Ingeniero",
"salary": 32000.33,
"monthly_expenses": 1000.33,
"educational_level": "0300",
"title": "004",
"is_pep": false,
"income_source_code": "1",
"handles_public_resources": false,
"company_economic_activity_code": "2836",
"employer_number": 514,
"reference": {
"full_name": "Carlos Eduardo López",
"phone": 8876735921
},
"spouse": {
"identification_number": "12345678",
"identification_type_code": "9999",
"identification_country_code": "NI",
"full_name": "Glenda Mairena",
"monthly_income": 32000.77
}
}{
"person_type": "NAT",
"first_name": "Carlos",
"last_name": "Lopez",
"sex": "M",
"marital_status": "2",
"nationality": "DO",
"is_fatca": false,
"residence_street": "Marginal Avenida Las Américas",
"residence_building": "Edif. Cumbre 8, NACO",
"residence_apartment_number": "29, Apto. 10 Oeste",
"geographic_location": "0100-0101-01",
"email": "[email protected]",
"identification": "4013001950848",
"identification_type": "CIP",
"identification_expiration_date": "2030-09-06T04:25:21.928Z",
"date_of_birth": "1971-04-18T22:16:33.387Z",
"country_of_birth": "DO",
"mobile_phone_number": 8098888888,
"country_of_residence": "DO",
"economic_activity": "2836",
"employer": "ELECTROVAL, SRL",
"work_address": "AVE. TIRADENTES N14, EDIF. EMPRESARIAL",
"salary": 32000.33,
"title": "004",
"is_pep": false
}JSON response body fields:
Name | Description | Type |
|---|---|---|
| Customer ID number. |
|
| Customer mail. |
|
| Customer's branch identifier. |
|
| Customer mobile number. |
|
| Contact number of the personal reference submitted by the customer. |
|
| Customer number. |
|
| Defines the bank code. |
|
| Customer's date of birth. |
|
| Customer's legal name. |
|
| Indicates if the customer exists. |
|