Create Corporate Customer
curl --request POST \
--url https://sigmacdd.sabipay.com/api/v1/cdd/customers \
--header 'Content-Type: application/json' \
--header 'apiKey: <api-key>' \
--header 'apiSecret: <api-key>' \
--data '
{
"uniqueId": "CUS-NG-20240101-002",
"externalId": "EXT-0048292",
"type": "corporate",
"status": "active",
"customerSegment": "sme",
"riskClassification": "medium",
"kycLevel": "tier_3",
"channel": "branch",
"source": "api",
"isSanctioned": false,
"isPep": false,
"watchlist": false,
"lastReviewDate": "2024-06-01T00:00:00.000Z",
"nextReviewDate": "2025-06-01T00:00:00.000Z",
"lastCheck": "2024-12-01T00:00:00.000Z",
"businessName": "Okafor & Sons Trading Limited",
"businessType": "Limited Liability Company",
"industryType": "wholesale_trade",
"natureOfBusiness": "Import and wholesale distribution of industrial machinery and spare parts",
"registrationNumber": "RC-1048291",
"taxIdentificationNumber": "9876543210",
"incorporationDate": "2015-08-14T00:00:00.000Z",
"countryOfIncorporation": "NG",
"stateOfIncorporation": "Lagos",
"website": "https://okaforandsons.example.com",
"numberOfEmployees": 47,
"phone": "+2341234567890",
"businessEmail": "info@okaforandsons.example.com",
"headOfficeAddress": "Plot 22, Apapa-Oshodi Expressway, Apapa, Lagos",
"annualRevenue": 850000000,
"annualTurnover": 720000000,
"authorizedCapital": 100000000,
"paidUpCapital": 75000000,
"sourceOfFunds": "business_revenue",
"parentCompany": null,
"regulatoryLicenses": [
"SON/NG/2019/0012341 - Standards Organisation of Nigeria",
"NESREA/2020/IMP/00892 - Import Permit (Environmental Compliance)"
],
"bankCode": "044",
"bankName": "Access Bank",
"bankCountry": "NG",
"relationshipStartDate": "2016-01-20T00:00:00.000Z",
"accounts": [
{
"accountNumber": "0987654321",
"accountType": "current",
"accountCurrency": "NGN",
"purposeOfAccount": "primary business operations and payroll",
"openingDate": "2016-01-20T00:00:00.000Z",
"accountStatus": "active",
"averageBalance": 42000000,
"overdraftLimit": 20000000,
"dailyLimit": 100000000,
"isPrimaryAccount": true
},
{
"accountNumber": "0912837465",
"accountType": "domiciliary",
"accountCurrency": "USD",
"purposeOfAccount": "import payments and foreign supplier settlements",
"openingDate": "2017-03-10T00:00:00.000Z",
"accountStatus": "active",
"averageBalance": 185000,
"isPrimaryAccount": false
},
{
"accountNumber": "0956473829",
"accountType": "fixed_deposit",
"accountCurrency": "NGN",
"purposeOfAccount": "short-term investment of idle funds",
"openingDate": "2023-09-01T00:00:00.000Z",
"closingDate": "2024-09-01T00:00:00.000Z",
"accountStatus": "active",
"averageBalance": 50000000,
"isPrimaryAccount": false
}
],
"directors": [
{
"firstName": "Chukwuemeka",
"lastName": "Okafor",
"middleName": "Tochukwu",
"dob": "1965-03-15T00:00:00.000Z",
"gender": "male",
"nationality": "Nigerian",
"phone": "+2348031234567",
"email": "c.okafor@okaforandsons.example.com",
"address": "14 Adeola Odeku Street, Victoria Island, Lagos",
"identificationType": "bvn",
"identificationNumber": "22198765432",
"isPep": false,
"isSanctioned": false
},
{
"firstName": "Ngozi",
"lastName": "Okafor",
"middleName": "Adaeze",
"dob": "1968-11-22T00:00:00.000Z",
"gender": "female",
"nationality": "Nigerian",
"phone": "+2348059876543",
"email": "n.okafor@okaforandsons.example.com",
"address": "14 Adeola Odeku Street, Victoria Island, Lagos",
"identificationType": "bvn",
"identificationNumber": "22345678901",
"isPep": false,
"isSanctioned": false
}
],
"signatories": [
{
"firstName": "Chukwuemeka",
"lastName": "Okafor",
"middleName": "Tochukwu",
"dob": "1965-03-15T00:00:00.000Z",
"gender": "male",
"nationality": "Nigerian",
"phone": "+2348031234567",
"email": "c.okafor@okaforandsons.example.com",
"address": "14 Adeola Odeku Street, Victoria Island, Lagos",
"identificationType": "bvn",
"identificationNumber": "22198765432",
"isPep": false,
"isSanctioned": false
},
{
"firstName": "Emeka",
"lastName": "Eze",
"middleName": "Chidi",
"dob": "1980-07-04T00:00:00.000Z",
"gender": "male",
"nationality": "Nigerian",
"phone": "+2348076543210",
"email": "emeka.eze@okaforandsons.example.com",
"address": "7 Bode Thomas Street, Surulere, Lagos",
"identificationType": "nin",
"identificationNumber": "98765432101",
"isPep": false,
"isSanctioned": false
}
],
"ultimateBeneficialOwners": [
{
"firstName": "Chukwuemeka",
"lastName": "Okafor",
"middleName": "Tochukwu",
"dob": "1965-03-15T00:00:00.000Z",
"nationality": "Nigerian",
"identificationType": "bvn",
"identificationNumber": "22198765432",
"ownershipPercentage": 60,
"isPep": false,
"isSanctioned": false
},
{
"firstName": "Ngozi",
"lastName": "Okafor",
"middleName": "Adaeze",
"dob": "1968-11-22T00:00:00.000Z",
"nationality": "Nigerian",
"identificationType": "bvn",
"identificationNumber": "22345678901",
"ownershipPercentage": 40,
"isPep": false,
"isSanctioned": false
}
],
"metadata": {
"onboardingBranch": "Apapa",
"relationshipManager": "Adewale Fashola",
"preferredLanguage": "en",
"importerExporterCode": "IMP/2017/NG/00482",
"cacDocumentUrl": "https://docs.example.com/kyc/cac/CUS-NG-20240101-002.pdf",
"memart": "https://docs.example.com/kyc/memart/CUS-NG-20240101-002.pdf"
}
}
'import requests
url = "https://sigmacdd.sabipay.com/api/v1/cdd/customers"
payload = {
"uniqueId": "CUS-NG-20240101-002",
"externalId": "EXT-0048292",
"type": "corporate",
"status": "active",
"customerSegment": "sme",
"riskClassification": "medium",
"kycLevel": "tier_3",
"channel": "branch",
"source": "api",
"isSanctioned": False,
"isPep": False,
"watchlist": False,
"lastReviewDate": "2024-06-01T00:00:00.000Z",
"nextReviewDate": "2025-06-01T00:00:00.000Z",
"lastCheck": "2024-12-01T00:00:00.000Z",
"businessName": "Okafor & Sons Trading Limited",
"businessType": "Limited Liability Company",
"industryType": "wholesale_trade",
"natureOfBusiness": "Import and wholesale distribution of industrial machinery and spare parts",
"registrationNumber": "RC-1048291",
"taxIdentificationNumber": "9876543210",
"incorporationDate": "2015-08-14T00:00:00.000Z",
"countryOfIncorporation": "NG",
"stateOfIncorporation": "Lagos",
"website": "https://okaforandsons.example.com",
"numberOfEmployees": 47,
"phone": "+2341234567890",
"businessEmail": "info@okaforandsons.example.com",
"headOfficeAddress": "Plot 22, Apapa-Oshodi Expressway, Apapa, Lagos",
"annualRevenue": 850000000,
"annualTurnover": 720000000,
"authorizedCapital": 100000000,
"paidUpCapital": 75000000,
"sourceOfFunds": "business_revenue",
"parentCompany": None,
"regulatoryLicenses": ["SON/NG/2019/0012341 - Standards Organisation of Nigeria", "NESREA/2020/IMP/00892 - Import Permit (Environmental Compliance)"],
"bankCode": "044",
"bankName": "Access Bank",
"bankCountry": "NG",
"relationshipStartDate": "2016-01-20T00:00:00.000Z",
"accounts": [
{
"accountNumber": "0987654321",
"accountType": "current",
"accountCurrency": "NGN",
"purposeOfAccount": "primary business operations and payroll",
"openingDate": "2016-01-20T00:00:00.000Z",
"accountStatus": "active",
"averageBalance": 42000000,
"overdraftLimit": 20000000,
"dailyLimit": 100000000,
"isPrimaryAccount": True
},
{
"accountNumber": "0912837465",
"accountType": "domiciliary",
"accountCurrency": "USD",
"purposeOfAccount": "import payments and foreign supplier settlements",
"openingDate": "2017-03-10T00:00:00.000Z",
"accountStatus": "active",
"averageBalance": 185000,
"isPrimaryAccount": False
},
{
"accountNumber": "0956473829",
"accountType": "fixed_deposit",
"accountCurrency": "NGN",
"purposeOfAccount": "short-term investment of idle funds",
"openingDate": "2023-09-01T00:00:00.000Z",
"closingDate": "2024-09-01T00:00:00.000Z",
"accountStatus": "active",
"averageBalance": 50000000,
"isPrimaryAccount": False
}
],
"directors": [
{
"firstName": "Chukwuemeka",
"lastName": "Okafor",
"middleName": "Tochukwu",
"dob": "1965-03-15T00:00:00.000Z",
"gender": "male",
"nationality": "Nigerian",
"phone": "+2348031234567",
"email": "c.okafor@okaforandsons.example.com",
"address": "14 Adeola Odeku Street, Victoria Island, Lagos",
"identificationType": "bvn",
"identificationNumber": "22198765432",
"isPep": False,
"isSanctioned": False
},
{
"firstName": "Ngozi",
"lastName": "Okafor",
"middleName": "Adaeze",
"dob": "1968-11-22T00:00:00.000Z",
"gender": "female",
"nationality": "Nigerian",
"phone": "+2348059876543",
"email": "n.okafor@okaforandsons.example.com",
"address": "14 Adeola Odeku Street, Victoria Island, Lagos",
"identificationType": "bvn",
"identificationNumber": "22345678901",
"isPep": False,
"isSanctioned": False
}
],
"signatories": [
{
"firstName": "Chukwuemeka",
"lastName": "Okafor",
"middleName": "Tochukwu",
"dob": "1965-03-15T00:00:00.000Z",
"gender": "male",
"nationality": "Nigerian",
"phone": "+2348031234567",
"email": "c.okafor@okaforandsons.example.com",
"address": "14 Adeola Odeku Street, Victoria Island, Lagos",
"identificationType": "bvn",
"identificationNumber": "22198765432",
"isPep": False,
"isSanctioned": False
},
{
"firstName": "Emeka",
"lastName": "Eze",
"middleName": "Chidi",
"dob": "1980-07-04T00:00:00.000Z",
"gender": "male",
"nationality": "Nigerian",
"phone": "+2348076543210",
"email": "emeka.eze@okaforandsons.example.com",
"address": "7 Bode Thomas Street, Surulere, Lagos",
"identificationType": "nin",
"identificationNumber": "98765432101",
"isPep": False,
"isSanctioned": False
}
],
"ultimateBeneficialOwners": [
{
"firstName": "Chukwuemeka",
"lastName": "Okafor",
"middleName": "Tochukwu",
"dob": "1965-03-15T00:00:00.000Z",
"nationality": "Nigerian",
"identificationType": "bvn",
"identificationNumber": "22198765432",
"ownershipPercentage": 60,
"isPep": False,
"isSanctioned": False
},
{
"firstName": "Ngozi",
"lastName": "Okafor",
"middleName": "Adaeze",
"dob": "1968-11-22T00:00:00.000Z",
"nationality": "Nigerian",
"identificationType": "bvn",
"identificationNumber": "22345678901",
"ownershipPercentage": 40,
"isPep": False,
"isSanctioned": False
}
],
"metadata": {
"onboardingBranch": "Apapa",
"relationshipManager": "Adewale Fashola",
"preferredLanguage": "en",
"importerExporterCode": "IMP/2017/NG/00482",
"cacDocumentUrl": "https://docs.example.com/kyc/cac/CUS-NG-20240101-002.pdf",
"memart": "https://docs.example.com/kyc/memart/CUS-NG-20240101-002.pdf"
}
}
headers = {
"apiKey": "<api-key>",
"apiSecret": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
apiKey: '<api-key>',
apiSecret: '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
uniqueId: 'CUS-NG-20240101-002',
externalId: 'EXT-0048292',
type: 'corporate',
status: 'active',
customerSegment: 'sme',
riskClassification: 'medium',
kycLevel: 'tier_3',
channel: 'branch',
source: 'api',
isSanctioned: false,
isPep: false,
watchlist: false,
lastReviewDate: '2024-06-01T00:00:00.000Z',
nextReviewDate: '2025-06-01T00:00:00.000Z',
lastCheck: '2024-12-01T00:00:00.000Z',
businessName: 'Okafor & Sons Trading Limited',
businessType: 'Limited Liability Company',
industryType: 'wholesale_trade',
natureOfBusiness: 'Import and wholesale distribution of industrial machinery and spare parts',
registrationNumber: 'RC-1048291',
taxIdentificationNumber: '9876543210',
incorporationDate: '2015-08-14T00:00:00.000Z',
countryOfIncorporation: 'NG',
stateOfIncorporation: 'Lagos',
website: 'https://okaforandsons.example.com',
numberOfEmployees: 47,
phone: '+2341234567890',
businessEmail: 'info@okaforandsons.example.com',
headOfficeAddress: 'Plot 22, Apapa-Oshodi Expressway, Apapa, Lagos',
annualRevenue: 850000000,
annualTurnover: 720000000,
authorizedCapital: 100000000,
paidUpCapital: 75000000,
sourceOfFunds: 'business_revenue',
parentCompany: null,
regulatoryLicenses: [
'SON/NG/2019/0012341 - Standards Organisation of Nigeria',
'NESREA/2020/IMP/00892 - Import Permit (Environmental Compliance)'
],
bankCode: '044',
bankName: 'Access Bank',
bankCountry: 'NG',
relationshipStartDate: '2016-01-20T00:00:00.000Z',
accounts: [
{
accountNumber: '0987654321',
accountType: 'current',
accountCurrency: 'NGN',
purposeOfAccount: 'primary business operations and payroll',
openingDate: '2016-01-20T00:00:00.000Z',
accountStatus: 'active',
averageBalance: 42000000,
overdraftLimit: 20000000,
dailyLimit: 100000000,
isPrimaryAccount: true
},
{
accountNumber: '0912837465',
accountType: 'domiciliary',
accountCurrency: 'USD',
purposeOfAccount: 'import payments and foreign supplier settlements',
openingDate: '2017-03-10T00:00:00.000Z',
accountStatus: 'active',
averageBalance: 185000,
isPrimaryAccount: false
},
{
accountNumber: '0956473829',
accountType: 'fixed_deposit',
accountCurrency: 'NGN',
purposeOfAccount: 'short-term investment of idle funds',
openingDate: '2023-09-01T00:00:00.000Z',
closingDate: '2024-09-01T00:00:00.000Z',
accountStatus: 'active',
averageBalance: 50000000,
isPrimaryAccount: false
}
],
directors: [
{
firstName: 'Chukwuemeka',
lastName: 'Okafor',
middleName: 'Tochukwu',
dob: '1965-03-15T00:00:00.000Z',
gender: 'male',
nationality: 'Nigerian',
phone: '+2348031234567',
email: 'c.okafor@okaforandsons.example.com',
address: '14 Adeola Odeku Street, Victoria Island, Lagos',
identificationType: 'bvn',
identificationNumber: '22198765432',
isPep: false,
isSanctioned: false
},
{
firstName: 'Ngozi',
lastName: 'Okafor',
middleName: 'Adaeze',
dob: '1968-11-22T00:00:00.000Z',
gender: 'female',
nationality: 'Nigerian',
phone: '+2348059876543',
email: 'n.okafor@okaforandsons.example.com',
address: '14 Adeola Odeku Street, Victoria Island, Lagos',
identificationType: 'bvn',
identificationNumber: '22345678901',
isPep: false,
isSanctioned: false
}
],
signatories: [
{
firstName: 'Chukwuemeka',
lastName: 'Okafor',
middleName: 'Tochukwu',
dob: '1965-03-15T00:00:00.000Z',
gender: 'male',
nationality: 'Nigerian',
phone: '+2348031234567',
email: 'c.okafor@okaforandsons.example.com',
address: '14 Adeola Odeku Street, Victoria Island, Lagos',
identificationType: 'bvn',
identificationNumber: '22198765432',
isPep: false,
isSanctioned: false
},
{
firstName: 'Emeka',
lastName: 'Eze',
middleName: 'Chidi',
dob: '1980-07-04T00:00:00.000Z',
gender: 'male',
nationality: 'Nigerian',
phone: '+2348076543210',
email: 'emeka.eze@okaforandsons.example.com',
address: '7 Bode Thomas Street, Surulere, Lagos',
identificationType: 'nin',
identificationNumber: '98765432101',
isPep: false,
isSanctioned: false
}
],
ultimateBeneficialOwners: [
{
firstName: 'Chukwuemeka',
lastName: 'Okafor',
middleName: 'Tochukwu',
dob: '1965-03-15T00:00:00.000Z',
nationality: 'Nigerian',
identificationType: 'bvn',
identificationNumber: '22198765432',
ownershipPercentage: 60,
isPep: false,
isSanctioned: false
},
{
firstName: 'Ngozi',
lastName: 'Okafor',
middleName: 'Adaeze',
dob: '1968-11-22T00:00:00.000Z',
nationality: 'Nigerian',
identificationType: 'bvn',
identificationNumber: '22345678901',
ownershipPercentage: 40,
isPep: false,
isSanctioned: false
}
],
metadata: {
onboardingBranch: 'Apapa',
relationshipManager: 'Adewale Fashola',
preferredLanguage: 'en',
importerExporterCode: 'IMP/2017/NG/00482',
cacDocumentUrl: 'https://docs.example.com/kyc/cac/CUS-NG-20240101-002.pdf',
memart: 'https://docs.example.com/kyc/memart/CUS-NG-20240101-002.pdf'
}
})
};
fetch('https://sigmacdd.sabipay.com/api/v1/cdd/customers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://sigmacdd.sabipay.com/api/v1/cdd/customers",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'uniqueId' => 'CUS-NG-20240101-002',
'externalId' => 'EXT-0048292',
'type' => 'corporate',
'status' => 'active',
'customerSegment' => 'sme',
'riskClassification' => 'medium',
'kycLevel' => 'tier_3',
'channel' => 'branch',
'source' => 'api',
'isSanctioned' => false,
'isPep' => false,
'watchlist' => false,
'lastReviewDate' => '2024-06-01T00:00:00.000Z',
'nextReviewDate' => '2025-06-01T00:00:00.000Z',
'lastCheck' => '2024-12-01T00:00:00.000Z',
'businessName' => 'Okafor & Sons Trading Limited',
'businessType' => 'Limited Liability Company',
'industryType' => 'wholesale_trade',
'natureOfBusiness' => 'Import and wholesale distribution of industrial machinery and spare parts',
'registrationNumber' => 'RC-1048291',
'taxIdentificationNumber' => '9876543210',
'incorporationDate' => '2015-08-14T00:00:00.000Z',
'countryOfIncorporation' => 'NG',
'stateOfIncorporation' => 'Lagos',
'website' => 'https://okaforandsons.example.com',
'numberOfEmployees' => 47,
'phone' => '+2341234567890',
'businessEmail' => 'info@okaforandsons.example.com',
'headOfficeAddress' => 'Plot 22, Apapa-Oshodi Expressway, Apapa, Lagos',
'annualRevenue' => 850000000,
'annualTurnover' => 720000000,
'authorizedCapital' => 100000000,
'paidUpCapital' => 75000000,
'sourceOfFunds' => 'business_revenue',
'parentCompany' => null,
'regulatoryLicenses' => [
'SON/NG/2019/0012341 - Standards Organisation of Nigeria',
'NESREA/2020/IMP/00892 - Import Permit (Environmental Compliance)'
],
'bankCode' => '044',
'bankName' => 'Access Bank',
'bankCountry' => 'NG',
'relationshipStartDate' => '2016-01-20T00:00:00.000Z',
'accounts' => [
[
'accountNumber' => '0987654321',
'accountType' => 'current',
'accountCurrency' => 'NGN',
'purposeOfAccount' => 'primary business operations and payroll',
'openingDate' => '2016-01-20T00:00:00.000Z',
'accountStatus' => 'active',
'averageBalance' => 42000000,
'overdraftLimit' => 20000000,
'dailyLimit' => 100000000,
'isPrimaryAccount' => true
],
[
'accountNumber' => '0912837465',
'accountType' => 'domiciliary',
'accountCurrency' => 'USD',
'purposeOfAccount' => 'import payments and foreign supplier settlements',
'openingDate' => '2017-03-10T00:00:00.000Z',
'accountStatus' => 'active',
'averageBalance' => 185000,
'isPrimaryAccount' => false
],
[
'accountNumber' => '0956473829',
'accountType' => 'fixed_deposit',
'accountCurrency' => 'NGN',
'purposeOfAccount' => 'short-term investment of idle funds',
'openingDate' => '2023-09-01T00:00:00.000Z',
'closingDate' => '2024-09-01T00:00:00.000Z',
'accountStatus' => 'active',
'averageBalance' => 50000000,
'isPrimaryAccount' => false
]
],
'directors' => [
[
'firstName' => 'Chukwuemeka',
'lastName' => 'Okafor',
'middleName' => 'Tochukwu',
'dob' => '1965-03-15T00:00:00.000Z',
'gender' => 'male',
'nationality' => 'Nigerian',
'phone' => '+2348031234567',
'email' => 'c.okafor@okaforandsons.example.com',
'address' => '14 Adeola Odeku Street, Victoria Island, Lagos',
'identificationType' => 'bvn',
'identificationNumber' => '22198765432',
'isPep' => false,
'isSanctioned' => false
],
[
'firstName' => 'Ngozi',
'lastName' => 'Okafor',
'middleName' => 'Adaeze',
'dob' => '1968-11-22T00:00:00.000Z',
'gender' => 'female',
'nationality' => 'Nigerian',
'phone' => '+2348059876543',
'email' => 'n.okafor@okaforandsons.example.com',
'address' => '14 Adeola Odeku Street, Victoria Island, Lagos',
'identificationType' => 'bvn',
'identificationNumber' => '22345678901',
'isPep' => false,
'isSanctioned' => false
]
],
'signatories' => [
[
'firstName' => 'Chukwuemeka',
'lastName' => 'Okafor',
'middleName' => 'Tochukwu',
'dob' => '1965-03-15T00:00:00.000Z',
'gender' => 'male',
'nationality' => 'Nigerian',
'phone' => '+2348031234567',
'email' => 'c.okafor@okaforandsons.example.com',
'address' => '14 Adeola Odeku Street, Victoria Island, Lagos',
'identificationType' => 'bvn',
'identificationNumber' => '22198765432',
'isPep' => false,
'isSanctioned' => false
],
[
'firstName' => 'Emeka',
'lastName' => 'Eze',
'middleName' => 'Chidi',
'dob' => '1980-07-04T00:00:00.000Z',
'gender' => 'male',
'nationality' => 'Nigerian',
'phone' => '+2348076543210',
'email' => 'emeka.eze@okaforandsons.example.com',
'address' => '7 Bode Thomas Street, Surulere, Lagos',
'identificationType' => 'nin',
'identificationNumber' => '98765432101',
'isPep' => false,
'isSanctioned' => false
]
],
'ultimateBeneficialOwners' => [
[
'firstName' => 'Chukwuemeka',
'lastName' => 'Okafor',
'middleName' => 'Tochukwu',
'dob' => '1965-03-15T00:00:00.000Z',
'nationality' => 'Nigerian',
'identificationType' => 'bvn',
'identificationNumber' => '22198765432',
'ownershipPercentage' => 60,
'isPep' => false,
'isSanctioned' => false
],
[
'firstName' => 'Ngozi',
'lastName' => 'Okafor',
'middleName' => 'Adaeze',
'dob' => '1968-11-22T00:00:00.000Z',
'nationality' => 'Nigerian',
'identificationType' => 'bvn',
'identificationNumber' => '22345678901',
'ownershipPercentage' => 40,
'isPep' => false,
'isSanctioned' => false
]
],
'metadata' => [
'onboardingBranch' => 'Apapa',
'relationshipManager' => 'Adewale Fashola',
'preferredLanguage' => 'en',
'importerExporterCode' => 'IMP/2017/NG/00482',
'cacDocumentUrl' => 'https://docs.example.com/kyc/cac/CUS-NG-20240101-002.pdf',
'memart' => 'https://docs.example.com/kyc/memart/CUS-NG-20240101-002.pdf'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"apiKey: <api-key>",
"apiSecret: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://sigmacdd.sabipay.com/api/v1/cdd/customers"
payload := strings.NewReader("{\n \"uniqueId\": \"CUS-NG-20240101-002\",\n \"externalId\": \"EXT-0048292\",\n \"type\": \"corporate\",\n \"status\": \"active\",\n \"customerSegment\": \"sme\",\n \"riskClassification\": \"medium\",\n \"kycLevel\": \"tier_3\",\n \"channel\": \"branch\",\n \"source\": \"api\",\n \"isSanctioned\": false,\n \"isPep\": false,\n \"watchlist\": false,\n \"lastReviewDate\": \"2024-06-01T00:00:00.000Z\",\n \"nextReviewDate\": \"2025-06-01T00:00:00.000Z\",\n \"lastCheck\": \"2024-12-01T00:00:00.000Z\",\n \"businessName\": \"Okafor & Sons Trading Limited\",\n \"businessType\": \"Limited Liability Company\",\n \"industryType\": \"wholesale_trade\",\n \"natureOfBusiness\": \"Import and wholesale distribution of industrial machinery and spare parts\",\n \"registrationNumber\": \"RC-1048291\",\n \"taxIdentificationNumber\": \"9876543210\",\n \"incorporationDate\": \"2015-08-14T00:00:00.000Z\",\n \"countryOfIncorporation\": \"NG\",\n \"stateOfIncorporation\": \"Lagos\",\n \"website\": \"https://okaforandsons.example.com\",\n \"numberOfEmployees\": 47,\n \"phone\": \"+2341234567890\",\n \"businessEmail\": \"info@okaforandsons.example.com\",\n \"headOfficeAddress\": \"Plot 22, Apapa-Oshodi Expressway, Apapa, Lagos\",\n \"annualRevenue\": 850000000,\n \"annualTurnover\": 720000000,\n \"authorizedCapital\": 100000000,\n \"paidUpCapital\": 75000000,\n \"sourceOfFunds\": \"business_revenue\",\n \"parentCompany\": null,\n \"regulatoryLicenses\": [\n \"SON/NG/2019/0012341 - Standards Organisation of Nigeria\",\n \"NESREA/2020/IMP/00892 - Import Permit (Environmental Compliance)\"\n ],\n \"bankCode\": \"044\",\n \"bankName\": \"Access Bank\",\n \"bankCountry\": \"NG\",\n \"relationshipStartDate\": \"2016-01-20T00:00:00.000Z\",\n \"accounts\": [\n {\n \"accountNumber\": \"0987654321\",\n \"accountType\": \"current\",\n \"accountCurrency\": \"NGN\",\n \"purposeOfAccount\": \"primary business operations and payroll\",\n \"openingDate\": \"2016-01-20T00:00:00.000Z\",\n \"accountStatus\": \"active\",\n \"averageBalance\": 42000000,\n \"overdraftLimit\": 20000000,\n \"dailyLimit\": 100000000,\n \"isPrimaryAccount\": true\n },\n {\n \"accountNumber\": \"0912837465\",\n \"accountType\": \"domiciliary\",\n \"accountCurrency\": \"USD\",\n \"purposeOfAccount\": \"import payments and foreign supplier settlements\",\n \"openingDate\": \"2017-03-10T00:00:00.000Z\",\n \"accountStatus\": \"active\",\n \"averageBalance\": 185000,\n \"isPrimaryAccount\": false\n },\n {\n \"accountNumber\": \"0956473829\",\n \"accountType\": \"fixed_deposit\",\n \"accountCurrency\": \"NGN\",\n \"purposeOfAccount\": \"short-term investment of idle funds\",\n \"openingDate\": \"2023-09-01T00:00:00.000Z\",\n \"closingDate\": \"2024-09-01T00:00:00.000Z\",\n \"accountStatus\": \"active\",\n \"averageBalance\": 50000000,\n \"isPrimaryAccount\": false\n }\n ],\n \"directors\": [\n {\n \"firstName\": \"Chukwuemeka\",\n \"lastName\": \"Okafor\",\n \"middleName\": \"Tochukwu\",\n \"dob\": \"1965-03-15T00:00:00.000Z\",\n \"gender\": \"male\",\n \"nationality\": \"Nigerian\",\n \"phone\": \"+2348031234567\",\n \"email\": \"c.okafor@okaforandsons.example.com\",\n \"address\": \"14 Adeola Odeku Street, Victoria Island, Lagos\",\n \"identificationType\": \"bvn\",\n \"identificationNumber\": \"22198765432\",\n \"isPep\": false,\n \"isSanctioned\": false\n },\n {\n \"firstName\": \"Ngozi\",\n \"lastName\": \"Okafor\",\n \"middleName\": \"Adaeze\",\n \"dob\": \"1968-11-22T00:00:00.000Z\",\n \"gender\": \"female\",\n \"nationality\": \"Nigerian\",\n \"phone\": \"+2348059876543\",\n \"email\": \"n.okafor@okaforandsons.example.com\",\n \"address\": \"14 Adeola Odeku Street, Victoria Island, Lagos\",\n \"identificationType\": \"bvn\",\n \"identificationNumber\": \"22345678901\",\n \"isPep\": false,\n \"isSanctioned\": false\n }\n ],\n \"signatories\": [\n {\n \"firstName\": \"Chukwuemeka\",\n \"lastName\": \"Okafor\",\n \"middleName\": \"Tochukwu\",\n \"dob\": \"1965-03-15T00:00:00.000Z\",\n \"gender\": \"male\",\n \"nationality\": \"Nigerian\",\n \"phone\": \"+2348031234567\",\n \"email\": \"c.okafor@okaforandsons.example.com\",\n \"address\": \"14 Adeola Odeku Street, Victoria Island, Lagos\",\n \"identificationType\": \"bvn\",\n \"identificationNumber\": \"22198765432\",\n \"isPep\": false,\n \"isSanctioned\": false\n },\n {\n \"firstName\": \"Emeka\",\n \"lastName\": \"Eze\",\n \"middleName\": \"Chidi\",\n \"dob\": \"1980-07-04T00:00:00.000Z\",\n \"gender\": \"male\",\n \"nationality\": \"Nigerian\",\n \"phone\": \"+2348076543210\",\n \"email\": \"emeka.eze@okaforandsons.example.com\",\n \"address\": \"7 Bode Thomas Street, Surulere, Lagos\",\n \"identificationType\": \"nin\",\n \"identificationNumber\": \"98765432101\",\n \"isPep\": false,\n \"isSanctioned\": false\n }\n ],\n \"ultimateBeneficialOwners\": [\n {\n \"firstName\": \"Chukwuemeka\",\n \"lastName\": \"Okafor\",\n \"middleName\": \"Tochukwu\",\n \"dob\": \"1965-03-15T00:00:00.000Z\",\n \"nationality\": \"Nigerian\",\n \"identificationType\": \"bvn\",\n \"identificationNumber\": \"22198765432\",\n \"ownershipPercentage\": 60,\n \"isPep\": false,\n \"isSanctioned\": false\n },\n {\n \"firstName\": \"Ngozi\",\n \"lastName\": \"Okafor\",\n \"middleName\": \"Adaeze\",\n \"dob\": \"1968-11-22T00:00:00.000Z\",\n \"nationality\": \"Nigerian\",\n \"identificationType\": \"bvn\",\n \"identificationNumber\": \"22345678901\",\n \"ownershipPercentage\": 40,\n \"isPep\": false,\n \"isSanctioned\": false\n }\n ],\n \"metadata\": {\n \"onboardingBranch\": \"Apapa\",\n \"relationshipManager\": \"Adewale Fashola\",\n \"preferredLanguage\": \"en\",\n \"importerExporterCode\": \"IMP/2017/NG/00482\",\n \"cacDocumentUrl\": \"https://docs.example.com/kyc/cac/CUS-NG-20240101-002.pdf\",\n \"memart\": \"https://docs.example.com/kyc/memart/CUS-NG-20240101-002.pdf\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("apiKey", "<api-key>")
req.Header.Add("apiSecret", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://sigmacdd.sabipay.com/api/v1/cdd/customers")
.header("apiKey", "<api-key>")
.header("apiSecret", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"uniqueId\": \"CUS-NG-20240101-002\",\n \"externalId\": \"EXT-0048292\",\n \"type\": \"corporate\",\n \"status\": \"active\",\n \"customerSegment\": \"sme\",\n \"riskClassification\": \"medium\",\n \"kycLevel\": \"tier_3\",\n \"channel\": \"branch\",\n \"source\": \"api\",\n \"isSanctioned\": false,\n \"isPep\": false,\n \"watchlist\": false,\n \"lastReviewDate\": \"2024-06-01T00:00:00.000Z\",\n \"nextReviewDate\": \"2025-06-01T00:00:00.000Z\",\n \"lastCheck\": \"2024-12-01T00:00:00.000Z\",\n \"businessName\": \"Okafor & Sons Trading Limited\",\n \"businessType\": \"Limited Liability Company\",\n \"industryType\": \"wholesale_trade\",\n \"natureOfBusiness\": \"Import and wholesale distribution of industrial machinery and spare parts\",\n \"registrationNumber\": \"RC-1048291\",\n \"taxIdentificationNumber\": \"9876543210\",\n \"incorporationDate\": \"2015-08-14T00:00:00.000Z\",\n \"countryOfIncorporation\": \"NG\",\n \"stateOfIncorporation\": \"Lagos\",\n \"website\": \"https://okaforandsons.example.com\",\n \"numberOfEmployees\": 47,\n \"phone\": \"+2341234567890\",\n \"businessEmail\": \"info@okaforandsons.example.com\",\n \"headOfficeAddress\": \"Plot 22, Apapa-Oshodi Expressway, Apapa, Lagos\",\n \"annualRevenue\": 850000000,\n \"annualTurnover\": 720000000,\n \"authorizedCapital\": 100000000,\n \"paidUpCapital\": 75000000,\n \"sourceOfFunds\": \"business_revenue\",\n \"parentCompany\": null,\n \"regulatoryLicenses\": [\n \"SON/NG/2019/0012341 - Standards Organisation of Nigeria\",\n \"NESREA/2020/IMP/00892 - Import Permit (Environmental Compliance)\"\n ],\n \"bankCode\": \"044\",\n \"bankName\": \"Access Bank\",\n \"bankCountry\": \"NG\",\n \"relationshipStartDate\": \"2016-01-20T00:00:00.000Z\",\n \"accounts\": [\n {\n \"accountNumber\": \"0987654321\",\n \"accountType\": \"current\",\n \"accountCurrency\": \"NGN\",\n \"purposeOfAccount\": \"primary business operations and payroll\",\n \"openingDate\": \"2016-01-20T00:00:00.000Z\",\n \"accountStatus\": \"active\",\n \"averageBalance\": 42000000,\n \"overdraftLimit\": 20000000,\n \"dailyLimit\": 100000000,\n \"isPrimaryAccount\": true\n },\n {\n \"accountNumber\": \"0912837465\",\n \"accountType\": \"domiciliary\",\n \"accountCurrency\": \"USD\",\n \"purposeOfAccount\": \"import payments and foreign supplier settlements\",\n \"openingDate\": \"2017-03-10T00:00:00.000Z\",\n \"accountStatus\": \"active\",\n \"averageBalance\": 185000,\n \"isPrimaryAccount\": false\n },\n {\n \"accountNumber\": \"0956473829\",\n \"accountType\": \"fixed_deposit\",\n \"accountCurrency\": \"NGN\",\n \"purposeOfAccount\": \"short-term investment of idle funds\",\n \"openingDate\": \"2023-09-01T00:00:00.000Z\",\n \"closingDate\": \"2024-09-01T00:00:00.000Z\",\n \"accountStatus\": \"active\",\n \"averageBalance\": 50000000,\n \"isPrimaryAccount\": false\n }\n ],\n \"directors\": [\n {\n \"firstName\": \"Chukwuemeka\",\n \"lastName\": \"Okafor\",\n \"middleName\": \"Tochukwu\",\n \"dob\": \"1965-03-15T00:00:00.000Z\",\n \"gender\": \"male\",\n \"nationality\": \"Nigerian\",\n \"phone\": \"+2348031234567\",\n \"email\": \"c.okafor@okaforandsons.example.com\",\n \"address\": \"14 Adeola Odeku Street, Victoria Island, Lagos\",\n \"identificationType\": \"bvn\",\n \"identificationNumber\": \"22198765432\",\n \"isPep\": false,\n \"isSanctioned\": false\n },\n {\n \"firstName\": \"Ngozi\",\n \"lastName\": \"Okafor\",\n \"middleName\": \"Adaeze\",\n \"dob\": \"1968-11-22T00:00:00.000Z\",\n \"gender\": \"female\",\n \"nationality\": \"Nigerian\",\n \"phone\": \"+2348059876543\",\n \"email\": \"n.okafor@okaforandsons.example.com\",\n \"address\": \"14 Adeola Odeku Street, Victoria Island, Lagos\",\n \"identificationType\": \"bvn\",\n \"identificationNumber\": \"22345678901\",\n \"isPep\": false,\n \"isSanctioned\": false\n }\n ],\n \"signatories\": [\n {\n \"firstName\": \"Chukwuemeka\",\n \"lastName\": \"Okafor\",\n \"middleName\": \"Tochukwu\",\n \"dob\": \"1965-03-15T00:00:00.000Z\",\n \"gender\": \"male\",\n \"nationality\": \"Nigerian\",\n \"phone\": \"+2348031234567\",\n \"email\": \"c.okafor@okaforandsons.example.com\",\n \"address\": \"14 Adeola Odeku Street, Victoria Island, Lagos\",\n \"identificationType\": \"bvn\",\n \"identificationNumber\": \"22198765432\",\n \"isPep\": false,\n \"isSanctioned\": false\n },\n {\n \"firstName\": \"Emeka\",\n \"lastName\": \"Eze\",\n \"middleName\": \"Chidi\",\n \"dob\": \"1980-07-04T00:00:00.000Z\",\n \"gender\": \"male\",\n \"nationality\": \"Nigerian\",\n \"phone\": \"+2348076543210\",\n \"email\": \"emeka.eze@okaforandsons.example.com\",\n \"address\": \"7 Bode Thomas Street, Surulere, Lagos\",\n \"identificationType\": \"nin\",\n \"identificationNumber\": \"98765432101\",\n \"isPep\": false,\n \"isSanctioned\": false\n }\n ],\n \"ultimateBeneficialOwners\": [\n {\n \"firstName\": \"Chukwuemeka\",\n \"lastName\": \"Okafor\",\n \"middleName\": \"Tochukwu\",\n \"dob\": \"1965-03-15T00:00:00.000Z\",\n \"nationality\": \"Nigerian\",\n \"identificationType\": \"bvn\",\n \"identificationNumber\": \"22198765432\",\n \"ownershipPercentage\": 60,\n \"isPep\": false,\n \"isSanctioned\": false\n },\n {\n \"firstName\": \"Ngozi\",\n \"lastName\": \"Okafor\",\n \"middleName\": \"Adaeze\",\n \"dob\": \"1968-11-22T00:00:00.000Z\",\n \"nationality\": \"Nigerian\",\n \"identificationType\": \"bvn\",\n \"identificationNumber\": \"22345678901\",\n \"ownershipPercentage\": 40,\n \"isPep\": false,\n \"isSanctioned\": false\n }\n ],\n \"metadata\": {\n \"onboardingBranch\": \"Apapa\",\n \"relationshipManager\": \"Adewale Fashola\",\n \"preferredLanguage\": \"en\",\n \"importerExporterCode\": \"IMP/2017/NG/00482\",\n \"cacDocumentUrl\": \"https://docs.example.com/kyc/cac/CUS-NG-20240101-002.pdf\",\n \"memart\": \"https://docs.example.com/kyc/memart/CUS-NG-20240101-002.pdf\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://sigmacdd.sabipay.com/api/v1/cdd/customers")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["apiKey"] = '<api-key>'
request["apiSecret"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"uniqueId\": \"CUS-NG-20240101-002\",\n \"externalId\": \"EXT-0048292\",\n \"type\": \"corporate\",\n \"status\": \"active\",\n \"customerSegment\": \"sme\",\n \"riskClassification\": \"medium\",\n \"kycLevel\": \"tier_3\",\n \"channel\": \"branch\",\n \"source\": \"api\",\n \"isSanctioned\": false,\n \"isPep\": false,\n \"watchlist\": false,\n \"lastReviewDate\": \"2024-06-01T00:00:00.000Z\",\n \"nextReviewDate\": \"2025-06-01T00:00:00.000Z\",\n \"lastCheck\": \"2024-12-01T00:00:00.000Z\",\n \"businessName\": \"Okafor & Sons Trading Limited\",\n \"businessType\": \"Limited Liability Company\",\n \"industryType\": \"wholesale_trade\",\n \"natureOfBusiness\": \"Import and wholesale distribution of industrial machinery and spare parts\",\n \"registrationNumber\": \"RC-1048291\",\n \"taxIdentificationNumber\": \"9876543210\",\n \"incorporationDate\": \"2015-08-14T00:00:00.000Z\",\n \"countryOfIncorporation\": \"NG\",\n \"stateOfIncorporation\": \"Lagos\",\n \"website\": \"https://okaforandsons.example.com\",\n \"numberOfEmployees\": 47,\n \"phone\": \"+2341234567890\",\n \"businessEmail\": \"info@okaforandsons.example.com\",\n \"headOfficeAddress\": \"Plot 22, Apapa-Oshodi Expressway, Apapa, Lagos\",\n \"annualRevenue\": 850000000,\n \"annualTurnover\": 720000000,\n \"authorizedCapital\": 100000000,\n \"paidUpCapital\": 75000000,\n \"sourceOfFunds\": \"business_revenue\",\n \"parentCompany\": null,\n \"regulatoryLicenses\": [\n \"SON/NG/2019/0012341 - Standards Organisation of Nigeria\",\n \"NESREA/2020/IMP/00892 - Import Permit (Environmental Compliance)\"\n ],\n \"bankCode\": \"044\",\n \"bankName\": \"Access Bank\",\n \"bankCountry\": \"NG\",\n \"relationshipStartDate\": \"2016-01-20T00:00:00.000Z\",\n \"accounts\": [\n {\n \"accountNumber\": \"0987654321\",\n \"accountType\": \"current\",\n \"accountCurrency\": \"NGN\",\n \"purposeOfAccount\": \"primary business operations and payroll\",\n \"openingDate\": \"2016-01-20T00:00:00.000Z\",\n \"accountStatus\": \"active\",\n \"averageBalance\": 42000000,\n \"overdraftLimit\": 20000000,\n \"dailyLimit\": 100000000,\n \"isPrimaryAccount\": true\n },\n {\n \"accountNumber\": \"0912837465\",\n \"accountType\": \"domiciliary\",\n \"accountCurrency\": \"USD\",\n \"purposeOfAccount\": \"import payments and foreign supplier settlements\",\n \"openingDate\": \"2017-03-10T00:00:00.000Z\",\n \"accountStatus\": \"active\",\n \"averageBalance\": 185000,\n \"isPrimaryAccount\": false\n },\n {\n \"accountNumber\": \"0956473829\",\n \"accountType\": \"fixed_deposit\",\n \"accountCurrency\": \"NGN\",\n \"purposeOfAccount\": \"short-term investment of idle funds\",\n \"openingDate\": \"2023-09-01T00:00:00.000Z\",\n \"closingDate\": \"2024-09-01T00:00:00.000Z\",\n \"accountStatus\": \"active\",\n \"averageBalance\": 50000000,\n \"isPrimaryAccount\": false\n }\n ],\n \"directors\": [\n {\n \"firstName\": \"Chukwuemeka\",\n \"lastName\": \"Okafor\",\n \"middleName\": \"Tochukwu\",\n \"dob\": \"1965-03-15T00:00:00.000Z\",\n \"gender\": \"male\",\n \"nationality\": \"Nigerian\",\n \"phone\": \"+2348031234567\",\n \"email\": \"c.okafor@okaforandsons.example.com\",\n \"address\": \"14 Adeola Odeku Street, Victoria Island, Lagos\",\n \"identificationType\": \"bvn\",\n \"identificationNumber\": \"22198765432\",\n \"isPep\": false,\n \"isSanctioned\": false\n },\n {\n \"firstName\": \"Ngozi\",\n \"lastName\": \"Okafor\",\n \"middleName\": \"Adaeze\",\n \"dob\": \"1968-11-22T00:00:00.000Z\",\n \"gender\": \"female\",\n \"nationality\": \"Nigerian\",\n \"phone\": \"+2348059876543\",\n \"email\": \"n.okafor@okaforandsons.example.com\",\n \"address\": \"14 Adeola Odeku Street, Victoria Island, Lagos\",\n \"identificationType\": \"bvn\",\n \"identificationNumber\": \"22345678901\",\n \"isPep\": false,\n \"isSanctioned\": false\n }\n ],\n \"signatories\": [\n {\n \"firstName\": \"Chukwuemeka\",\n \"lastName\": \"Okafor\",\n \"middleName\": \"Tochukwu\",\n \"dob\": \"1965-03-15T00:00:00.000Z\",\n \"gender\": \"male\",\n \"nationality\": \"Nigerian\",\n \"phone\": \"+2348031234567\",\n \"email\": \"c.okafor@okaforandsons.example.com\",\n \"address\": \"14 Adeola Odeku Street, Victoria Island, Lagos\",\n \"identificationType\": \"bvn\",\n \"identificationNumber\": \"22198765432\",\n \"isPep\": false,\n \"isSanctioned\": false\n },\n {\n \"firstName\": \"Emeka\",\n \"lastName\": \"Eze\",\n \"middleName\": \"Chidi\",\n \"dob\": \"1980-07-04T00:00:00.000Z\",\n \"gender\": \"male\",\n \"nationality\": \"Nigerian\",\n \"phone\": \"+2348076543210\",\n \"email\": \"emeka.eze@okaforandsons.example.com\",\n \"address\": \"7 Bode Thomas Street, Surulere, Lagos\",\n \"identificationType\": \"nin\",\n \"identificationNumber\": \"98765432101\",\n \"isPep\": false,\n \"isSanctioned\": false\n }\n ],\n \"ultimateBeneficialOwners\": [\n {\n \"firstName\": \"Chukwuemeka\",\n \"lastName\": \"Okafor\",\n \"middleName\": \"Tochukwu\",\n \"dob\": \"1965-03-15T00:00:00.000Z\",\n \"nationality\": \"Nigerian\",\n \"identificationType\": \"bvn\",\n \"identificationNumber\": \"22198765432\",\n \"ownershipPercentage\": 60,\n \"isPep\": false,\n \"isSanctioned\": false\n },\n {\n \"firstName\": \"Ngozi\",\n \"lastName\": \"Okafor\",\n \"middleName\": \"Adaeze\",\n \"dob\": \"1968-11-22T00:00:00.000Z\",\n \"nationality\": \"Nigerian\",\n \"identificationType\": \"bvn\",\n \"identificationNumber\": \"22345678901\",\n \"ownershipPercentage\": 40,\n \"isPep\": false,\n \"isSanctioned\": false\n }\n ],\n \"metadata\": {\n \"onboardingBranch\": \"Apapa\",\n \"relationshipManager\": \"Adewale Fashola\",\n \"preferredLanguage\": \"en\",\n \"importerExporterCode\": \"IMP/2017/NG/00482\",\n \"cacDocumentUrl\": \"https://docs.example.com/kyc/cac/CUS-NG-20240101-002.pdf\",\n \"memart\": \"https://docs.example.com/kyc/memart/CUS-NG-20240101-002.pdf\"\n }\n}"
response = http.request(request)
puts response.read_body{
"message": "CDD customer created successfully",
"data": {
"_id": "67f50d48c2a7d1f2b6e99390",
"uniqueId": "CUS-NG-20240101-002",
"type": "corporate",
"businessName": "Okafor & Sons Trading Limited",
"channel": "branch",
"status": "active",
"createdAt": "2026-03-25T10:25:00.000Z"
}
}{
"message": "Customer with uniqueId CUS-NG-20240101-002 already exists"
}Customer Due Diligence
Create Corporate Customer
POST api/v1/cdd/customers
Create Corporate Customer
curl --request POST \
--url https://sigmacdd.sabipay.com/api/v1/cdd/customers \
--header 'Content-Type: application/json' \
--header 'apiKey: <api-key>' \
--header 'apiSecret: <api-key>' \
--data '
{
"uniqueId": "CUS-NG-20240101-002",
"externalId": "EXT-0048292",
"type": "corporate",
"status": "active",
"customerSegment": "sme",
"riskClassification": "medium",
"kycLevel": "tier_3",
"channel": "branch",
"source": "api",
"isSanctioned": false,
"isPep": false,
"watchlist": false,
"lastReviewDate": "2024-06-01T00:00:00.000Z",
"nextReviewDate": "2025-06-01T00:00:00.000Z",
"lastCheck": "2024-12-01T00:00:00.000Z",
"businessName": "Okafor & Sons Trading Limited",
"businessType": "Limited Liability Company",
"industryType": "wholesale_trade",
"natureOfBusiness": "Import and wholesale distribution of industrial machinery and spare parts",
"registrationNumber": "RC-1048291",
"taxIdentificationNumber": "9876543210",
"incorporationDate": "2015-08-14T00:00:00.000Z",
"countryOfIncorporation": "NG",
"stateOfIncorporation": "Lagos",
"website": "https://okaforandsons.example.com",
"numberOfEmployees": 47,
"phone": "+2341234567890",
"businessEmail": "info@okaforandsons.example.com",
"headOfficeAddress": "Plot 22, Apapa-Oshodi Expressway, Apapa, Lagos",
"annualRevenue": 850000000,
"annualTurnover": 720000000,
"authorizedCapital": 100000000,
"paidUpCapital": 75000000,
"sourceOfFunds": "business_revenue",
"parentCompany": null,
"regulatoryLicenses": [
"SON/NG/2019/0012341 - Standards Organisation of Nigeria",
"NESREA/2020/IMP/00892 - Import Permit (Environmental Compliance)"
],
"bankCode": "044",
"bankName": "Access Bank",
"bankCountry": "NG",
"relationshipStartDate": "2016-01-20T00:00:00.000Z",
"accounts": [
{
"accountNumber": "0987654321",
"accountType": "current",
"accountCurrency": "NGN",
"purposeOfAccount": "primary business operations and payroll",
"openingDate": "2016-01-20T00:00:00.000Z",
"accountStatus": "active",
"averageBalance": 42000000,
"overdraftLimit": 20000000,
"dailyLimit": 100000000,
"isPrimaryAccount": true
},
{
"accountNumber": "0912837465",
"accountType": "domiciliary",
"accountCurrency": "USD",
"purposeOfAccount": "import payments and foreign supplier settlements",
"openingDate": "2017-03-10T00:00:00.000Z",
"accountStatus": "active",
"averageBalance": 185000,
"isPrimaryAccount": false
},
{
"accountNumber": "0956473829",
"accountType": "fixed_deposit",
"accountCurrency": "NGN",
"purposeOfAccount": "short-term investment of idle funds",
"openingDate": "2023-09-01T00:00:00.000Z",
"closingDate": "2024-09-01T00:00:00.000Z",
"accountStatus": "active",
"averageBalance": 50000000,
"isPrimaryAccount": false
}
],
"directors": [
{
"firstName": "Chukwuemeka",
"lastName": "Okafor",
"middleName": "Tochukwu",
"dob": "1965-03-15T00:00:00.000Z",
"gender": "male",
"nationality": "Nigerian",
"phone": "+2348031234567",
"email": "c.okafor@okaforandsons.example.com",
"address": "14 Adeola Odeku Street, Victoria Island, Lagos",
"identificationType": "bvn",
"identificationNumber": "22198765432",
"isPep": false,
"isSanctioned": false
},
{
"firstName": "Ngozi",
"lastName": "Okafor",
"middleName": "Adaeze",
"dob": "1968-11-22T00:00:00.000Z",
"gender": "female",
"nationality": "Nigerian",
"phone": "+2348059876543",
"email": "n.okafor@okaforandsons.example.com",
"address": "14 Adeola Odeku Street, Victoria Island, Lagos",
"identificationType": "bvn",
"identificationNumber": "22345678901",
"isPep": false,
"isSanctioned": false
}
],
"signatories": [
{
"firstName": "Chukwuemeka",
"lastName": "Okafor",
"middleName": "Tochukwu",
"dob": "1965-03-15T00:00:00.000Z",
"gender": "male",
"nationality": "Nigerian",
"phone": "+2348031234567",
"email": "c.okafor@okaforandsons.example.com",
"address": "14 Adeola Odeku Street, Victoria Island, Lagos",
"identificationType": "bvn",
"identificationNumber": "22198765432",
"isPep": false,
"isSanctioned": false
},
{
"firstName": "Emeka",
"lastName": "Eze",
"middleName": "Chidi",
"dob": "1980-07-04T00:00:00.000Z",
"gender": "male",
"nationality": "Nigerian",
"phone": "+2348076543210",
"email": "emeka.eze@okaforandsons.example.com",
"address": "7 Bode Thomas Street, Surulere, Lagos",
"identificationType": "nin",
"identificationNumber": "98765432101",
"isPep": false,
"isSanctioned": false
}
],
"ultimateBeneficialOwners": [
{
"firstName": "Chukwuemeka",
"lastName": "Okafor",
"middleName": "Tochukwu",
"dob": "1965-03-15T00:00:00.000Z",
"nationality": "Nigerian",
"identificationType": "bvn",
"identificationNumber": "22198765432",
"ownershipPercentage": 60,
"isPep": false,
"isSanctioned": false
},
{
"firstName": "Ngozi",
"lastName": "Okafor",
"middleName": "Adaeze",
"dob": "1968-11-22T00:00:00.000Z",
"nationality": "Nigerian",
"identificationType": "bvn",
"identificationNumber": "22345678901",
"ownershipPercentage": 40,
"isPep": false,
"isSanctioned": false
}
],
"metadata": {
"onboardingBranch": "Apapa",
"relationshipManager": "Adewale Fashola",
"preferredLanguage": "en",
"importerExporterCode": "IMP/2017/NG/00482",
"cacDocumentUrl": "https://docs.example.com/kyc/cac/CUS-NG-20240101-002.pdf",
"memart": "https://docs.example.com/kyc/memart/CUS-NG-20240101-002.pdf"
}
}
'import requests
url = "https://sigmacdd.sabipay.com/api/v1/cdd/customers"
payload = {
"uniqueId": "CUS-NG-20240101-002",
"externalId": "EXT-0048292",
"type": "corporate",
"status": "active",
"customerSegment": "sme",
"riskClassification": "medium",
"kycLevel": "tier_3",
"channel": "branch",
"source": "api",
"isSanctioned": False,
"isPep": False,
"watchlist": False,
"lastReviewDate": "2024-06-01T00:00:00.000Z",
"nextReviewDate": "2025-06-01T00:00:00.000Z",
"lastCheck": "2024-12-01T00:00:00.000Z",
"businessName": "Okafor & Sons Trading Limited",
"businessType": "Limited Liability Company",
"industryType": "wholesale_trade",
"natureOfBusiness": "Import and wholesale distribution of industrial machinery and spare parts",
"registrationNumber": "RC-1048291",
"taxIdentificationNumber": "9876543210",
"incorporationDate": "2015-08-14T00:00:00.000Z",
"countryOfIncorporation": "NG",
"stateOfIncorporation": "Lagos",
"website": "https://okaforandsons.example.com",
"numberOfEmployees": 47,
"phone": "+2341234567890",
"businessEmail": "info@okaforandsons.example.com",
"headOfficeAddress": "Plot 22, Apapa-Oshodi Expressway, Apapa, Lagos",
"annualRevenue": 850000000,
"annualTurnover": 720000000,
"authorizedCapital": 100000000,
"paidUpCapital": 75000000,
"sourceOfFunds": "business_revenue",
"parentCompany": None,
"regulatoryLicenses": ["SON/NG/2019/0012341 - Standards Organisation of Nigeria", "NESREA/2020/IMP/00892 - Import Permit (Environmental Compliance)"],
"bankCode": "044",
"bankName": "Access Bank",
"bankCountry": "NG",
"relationshipStartDate": "2016-01-20T00:00:00.000Z",
"accounts": [
{
"accountNumber": "0987654321",
"accountType": "current",
"accountCurrency": "NGN",
"purposeOfAccount": "primary business operations and payroll",
"openingDate": "2016-01-20T00:00:00.000Z",
"accountStatus": "active",
"averageBalance": 42000000,
"overdraftLimit": 20000000,
"dailyLimit": 100000000,
"isPrimaryAccount": True
},
{
"accountNumber": "0912837465",
"accountType": "domiciliary",
"accountCurrency": "USD",
"purposeOfAccount": "import payments and foreign supplier settlements",
"openingDate": "2017-03-10T00:00:00.000Z",
"accountStatus": "active",
"averageBalance": 185000,
"isPrimaryAccount": False
},
{
"accountNumber": "0956473829",
"accountType": "fixed_deposit",
"accountCurrency": "NGN",
"purposeOfAccount": "short-term investment of idle funds",
"openingDate": "2023-09-01T00:00:00.000Z",
"closingDate": "2024-09-01T00:00:00.000Z",
"accountStatus": "active",
"averageBalance": 50000000,
"isPrimaryAccount": False
}
],
"directors": [
{
"firstName": "Chukwuemeka",
"lastName": "Okafor",
"middleName": "Tochukwu",
"dob": "1965-03-15T00:00:00.000Z",
"gender": "male",
"nationality": "Nigerian",
"phone": "+2348031234567",
"email": "c.okafor@okaforandsons.example.com",
"address": "14 Adeola Odeku Street, Victoria Island, Lagos",
"identificationType": "bvn",
"identificationNumber": "22198765432",
"isPep": False,
"isSanctioned": False
},
{
"firstName": "Ngozi",
"lastName": "Okafor",
"middleName": "Adaeze",
"dob": "1968-11-22T00:00:00.000Z",
"gender": "female",
"nationality": "Nigerian",
"phone": "+2348059876543",
"email": "n.okafor@okaforandsons.example.com",
"address": "14 Adeola Odeku Street, Victoria Island, Lagos",
"identificationType": "bvn",
"identificationNumber": "22345678901",
"isPep": False,
"isSanctioned": False
}
],
"signatories": [
{
"firstName": "Chukwuemeka",
"lastName": "Okafor",
"middleName": "Tochukwu",
"dob": "1965-03-15T00:00:00.000Z",
"gender": "male",
"nationality": "Nigerian",
"phone": "+2348031234567",
"email": "c.okafor@okaforandsons.example.com",
"address": "14 Adeola Odeku Street, Victoria Island, Lagos",
"identificationType": "bvn",
"identificationNumber": "22198765432",
"isPep": False,
"isSanctioned": False
},
{
"firstName": "Emeka",
"lastName": "Eze",
"middleName": "Chidi",
"dob": "1980-07-04T00:00:00.000Z",
"gender": "male",
"nationality": "Nigerian",
"phone": "+2348076543210",
"email": "emeka.eze@okaforandsons.example.com",
"address": "7 Bode Thomas Street, Surulere, Lagos",
"identificationType": "nin",
"identificationNumber": "98765432101",
"isPep": False,
"isSanctioned": False
}
],
"ultimateBeneficialOwners": [
{
"firstName": "Chukwuemeka",
"lastName": "Okafor",
"middleName": "Tochukwu",
"dob": "1965-03-15T00:00:00.000Z",
"nationality": "Nigerian",
"identificationType": "bvn",
"identificationNumber": "22198765432",
"ownershipPercentage": 60,
"isPep": False,
"isSanctioned": False
},
{
"firstName": "Ngozi",
"lastName": "Okafor",
"middleName": "Adaeze",
"dob": "1968-11-22T00:00:00.000Z",
"nationality": "Nigerian",
"identificationType": "bvn",
"identificationNumber": "22345678901",
"ownershipPercentage": 40,
"isPep": False,
"isSanctioned": False
}
],
"metadata": {
"onboardingBranch": "Apapa",
"relationshipManager": "Adewale Fashola",
"preferredLanguage": "en",
"importerExporterCode": "IMP/2017/NG/00482",
"cacDocumentUrl": "https://docs.example.com/kyc/cac/CUS-NG-20240101-002.pdf",
"memart": "https://docs.example.com/kyc/memart/CUS-NG-20240101-002.pdf"
}
}
headers = {
"apiKey": "<api-key>",
"apiSecret": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
apiKey: '<api-key>',
apiSecret: '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
uniqueId: 'CUS-NG-20240101-002',
externalId: 'EXT-0048292',
type: 'corporate',
status: 'active',
customerSegment: 'sme',
riskClassification: 'medium',
kycLevel: 'tier_3',
channel: 'branch',
source: 'api',
isSanctioned: false,
isPep: false,
watchlist: false,
lastReviewDate: '2024-06-01T00:00:00.000Z',
nextReviewDate: '2025-06-01T00:00:00.000Z',
lastCheck: '2024-12-01T00:00:00.000Z',
businessName: 'Okafor & Sons Trading Limited',
businessType: 'Limited Liability Company',
industryType: 'wholesale_trade',
natureOfBusiness: 'Import and wholesale distribution of industrial machinery and spare parts',
registrationNumber: 'RC-1048291',
taxIdentificationNumber: '9876543210',
incorporationDate: '2015-08-14T00:00:00.000Z',
countryOfIncorporation: 'NG',
stateOfIncorporation: 'Lagos',
website: 'https://okaforandsons.example.com',
numberOfEmployees: 47,
phone: '+2341234567890',
businessEmail: 'info@okaforandsons.example.com',
headOfficeAddress: 'Plot 22, Apapa-Oshodi Expressway, Apapa, Lagos',
annualRevenue: 850000000,
annualTurnover: 720000000,
authorizedCapital: 100000000,
paidUpCapital: 75000000,
sourceOfFunds: 'business_revenue',
parentCompany: null,
regulatoryLicenses: [
'SON/NG/2019/0012341 - Standards Organisation of Nigeria',
'NESREA/2020/IMP/00892 - Import Permit (Environmental Compliance)'
],
bankCode: '044',
bankName: 'Access Bank',
bankCountry: 'NG',
relationshipStartDate: '2016-01-20T00:00:00.000Z',
accounts: [
{
accountNumber: '0987654321',
accountType: 'current',
accountCurrency: 'NGN',
purposeOfAccount: 'primary business operations and payroll',
openingDate: '2016-01-20T00:00:00.000Z',
accountStatus: 'active',
averageBalance: 42000000,
overdraftLimit: 20000000,
dailyLimit: 100000000,
isPrimaryAccount: true
},
{
accountNumber: '0912837465',
accountType: 'domiciliary',
accountCurrency: 'USD',
purposeOfAccount: 'import payments and foreign supplier settlements',
openingDate: '2017-03-10T00:00:00.000Z',
accountStatus: 'active',
averageBalance: 185000,
isPrimaryAccount: false
},
{
accountNumber: '0956473829',
accountType: 'fixed_deposit',
accountCurrency: 'NGN',
purposeOfAccount: 'short-term investment of idle funds',
openingDate: '2023-09-01T00:00:00.000Z',
closingDate: '2024-09-01T00:00:00.000Z',
accountStatus: 'active',
averageBalance: 50000000,
isPrimaryAccount: false
}
],
directors: [
{
firstName: 'Chukwuemeka',
lastName: 'Okafor',
middleName: 'Tochukwu',
dob: '1965-03-15T00:00:00.000Z',
gender: 'male',
nationality: 'Nigerian',
phone: '+2348031234567',
email: 'c.okafor@okaforandsons.example.com',
address: '14 Adeola Odeku Street, Victoria Island, Lagos',
identificationType: 'bvn',
identificationNumber: '22198765432',
isPep: false,
isSanctioned: false
},
{
firstName: 'Ngozi',
lastName: 'Okafor',
middleName: 'Adaeze',
dob: '1968-11-22T00:00:00.000Z',
gender: 'female',
nationality: 'Nigerian',
phone: '+2348059876543',
email: 'n.okafor@okaforandsons.example.com',
address: '14 Adeola Odeku Street, Victoria Island, Lagos',
identificationType: 'bvn',
identificationNumber: '22345678901',
isPep: false,
isSanctioned: false
}
],
signatories: [
{
firstName: 'Chukwuemeka',
lastName: 'Okafor',
middleName: 'Tochukwu',
dob: '1965-03-15T00:00:00.000Z',
gender: 'male',
nationality: 'Nigerian',
phone: '+2348031234567',
email: 'c.okafor@okaforandsons.example.com',
address: '14 Adeola Odeku Street, Victoria Island, Lagos',
identificationType: 'bvn',
identificationNumber: '22198765432',
isPep: false,
isSanctioned: false
},
{
firstName: 'Emeka',
lastName: 'Eze',
middleName: 'Chidi',
dob: '1980-07-04T00:00:00.000Z',
gender: 'male',
nationality: 'Nigerian',
phone: '+2348076543210',
email: 'emeka.eze@okaforandsons.example.com',
address: '7 Bode Thomas Street, Surulere, Lagos',
identificationType: 'nin',
identificationNumber: '98765432101',
isPep: false,
isSanctioned: false
}
],
ultimateBeneficialOwners: [
{
firstName: 'Chukwuemeka',
lastName: 'Okafor',
middleName: 'Tochukwu',
dob: '1965-03-15T00:00:00.000Z',
nationality: 'Nigerian',
identificationType: 'bvn',
identificationNumber: '22198765432',
ownershipPercentage: 60,
isPep: false,
isSanctioned: false
},
{
firstName: 'Ngozi',
lastName: 'Okafor',
middleName: 'Adaeze',
dob: '1968-11-22T00:00:00.000Z',
nationality: 'Nigerian',
identificationType: 'bvn',
identificationNumber: '22345678901',
ownershipPercentage: 40,
isPep: false,
isSanctioned: false
}
],
metadata: {
onboardingBranch: 'Apapa',
relationshipManager: 'Adewale Fashola',
preferredLanguage: 'en',
importerExporterCode: 'IMP/2017/NG/00482',
cacDocumentUrl: 'https://docs.example.com/kyc/cac/CUS-NG-20240101-002.pdf',
memart: 'https://docs.example.com/kyc/memart/CUS-NG-20240101-002.pdf'
}
})
};
fetch('https://sigmacdd.sabipay.com/api/v1/cdd/customers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://sigmacdd.sabipay.com/api/v1/cdd/customers",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'uniqueId' => 'CUS-NG-20240101-002',
'externalId' => 'EXT-0048292',
'type' => 'corporate',
'status' => 'active',
'customerSegment' => 'sme',
'riskClassification' => 'medium',
'kycLevel' => 'tier_3',
'channel' => 'branch',
'source' => 'api',
'isSanctioned' => false,
'isPep' => false,
'watchlist' => false,
'lastReviewDate' => '2024-06-01T00:00:00.000Z',
'nextReviewDate' => '2025-06-01T00:00:00.000Z',
'lastCheck' => '2024-12-01T00:00:00.000Z',
'businessName' => 'Okafor & Sons Trading Limited',
'businessType' => 'Limited Liability Company',
'industryType' => 'wholesale_trade',
'natureOfBusiness' => 'Import and wholesale distribution of industrial machinery and spare parts',
'registrationNumber' => 'RC-1048291',
'taxIdentificationNumber' => '9876543210',
'incorporationDate' => '2015-08-14T00:00:00.000Z',
'countryOfIncorporation' => 'NG',
'stateOfIncorporation' => 'Lagos',
'website' => 'https://okaforandsons.example.com',
'numberOfEmployees' => 47,
'phone' => '+2341234567890',
'businessEmail' => 'info@okaforandsons.example.com',
'headOfficeAddress' => 'Plot 22, Apapa-Oshodi Expressway, Apapa, Lagos',
'annualRevenue' => 850000000,
'annualTurnover' => 720000000,
'authorizedCapital' => 100000000,
'paidUpCapital' => 75000000,
'sourceOfFunds' => 'business_revenue',
'parentCompany' => null,
'regulatoryLicenses' => [
'SON/NG/2019/0012341 - Standards Organisation of Nigeria',
'NESREA/2020/IMP/00892 - Import Permit (Environmental Compliance)'
],
'bankCode' => '044',
'bankName' => 'Access Bank',
'bankCountry' => 'NG',
'relationshipStartDate' => '2016-01-20T00:00:00.000Z',
'accounts' => [
[
'accountNumber' => '0987654321',
'accountType' => 'current',
'accountCurrency' => 'NGN',
'purposeOfAccount' => 'primary business operations and payroll',
'openingDate' => '2016-01-20T00:00:00.000Z',
'accountStatus' => 'active',
'averageBalance' => 42000000,
'overdraftLimit' => 20000000,
'dailyLimit' => 100000000,
'isPrimaryAccount' => true
],
[
'accountNumber' => '0912837465',
'accountType' => 'domiciliary',
'accountCurrency' => 'USD',
'purposeOfAccount' => 'import payments and foreign supplier settlements',
'openingDate' => '2017-03-10T00:00:00.000Z',
'accountStatus' => 'active',
'averageBalance' => 185000,
'isPrimaryAccount' => false
],
[
'accountNumber' => '0956473829',
'accountType' => 'fixed_deposit',
'accountCurrency' => 'NGN',
'purposeOfAccount' => 'short-term investment of idle funds',
'openingDate' => '2023-09-01T00:00:00.000Z',
'closingDate' => '2024-09-01T00:00:00.000Z',
'accountStatus' => 'active',
'averageBalance' => 50000000,
'isPrimaryAccount' => false
]
],
'directors' => [
[
'firstName' => 'Chukwuemeka',
'lastName' => 'Okafor',
'middleName' => 'Tochukwu',
'dob' => '1965-03-15T00:00:00.000Z',
'gender' => 'male',
'nationality' => 'Nigerian',
'phone' => '+2348031234567',
'email' => 'c.okafor@okaforandsons.example.com',
'address' => '14 Adeola Odeku Street, Victoria Island, Lagos',
'identificationType' => 'bvn',
'identificationNumber' => '22198765432',
'isPep' => false,
'isSanctioned' => false
],
[
'firstName' => 'Ngozi',
'lastName' => 'Okafor',
'middleName' => 'Adaeze',
'dob' => '1968-11-22T00:00:00.000Z',
'gender' => 'female',
'nationality' => 'Nigerian',
'phone' => '+2348059876543',
'email' => 'n.okafor@okaforandsons.example.com',
'address' => '14 Adeola Odeku Street, Victoria Island, Lagos',
'identificationType' => 'bvn',
'identificationNumber' => '22345678901',
'isPep' => false,
'isSanctioned' => false
]
],
'signatories' => [
[
'firstName' => 'Chukwuemeka',
'lastName' => 'Okafor',
'middleName' => 'Tochukwu',
'dob' => '1965-03-15T00:00:00.000Z',
'gender' => 'male',
'nationality' => 'Nigerian',
'phone' => '+2348031234567',
'email' => 'c.okafor@okaforandsons.example.com',
'address' => '14 Adeola Odeku Street, Victoria Island, Lagos',
'identificationType' => 'bvn',
'identificationNumber' => '22198765432',
'isPep' => false,
'isSanctioned' => false
],
[
'firstName' => 'Emeka',
'lastName' => 'Eze',
'middleName' => 'Chidi',
'dob' => '1980-07-04T00:00:00.000Z',
'gender' => 'male',
'nationality' => 'Nigerian',
'phone' => '+2348076543210',
'email' => 'emeka.eze@okaforandsons.example.com',
'address' => '7 Bode Thomas Street, Surulere, Lagos',
'identificationType' => 'nin',
'identificationNumber' => '98765432101',
'isPep' => false,
'isSanctioned' => false
]
],
'ultimateBeneficialOwners' => [
[
'firstName' => 'Chukwuemeka',
'lastName' => 'Okafor',
'middleName' => 'Tochukwu',
'dob' => '1965-03-15T00:00:00.000Z',
'nationality' => 'Nigerian',
'identificationType' => 'bvn',
'identificationNumber' => '22198765432',
'ownershipPercentage' => 60,
'isPep' => false,
'isSanctioned' => false
],
[
'firstName' => 'Ngozi',
'lastName' => 'Okafor',
'middleName' => 'Adaeze',
'dob' => '1968-11-22T00:00:00.000Z',
'nationality' => 'Nigerian',
'identificationType' => 'bvn',
'identificationNumber' => '22345678901',
'ownershipPercentage' => 40,
'isPep' => false,
'isSanctioned' => false
]
],
'metadata' => [
'onboardingBranch' => 'Apapa',
'relationshipManager' => 'Adewale Fashola',
'preferredLanguage' => 'en',
'importerExporterCode' => 'IMP/2017/NG/00482',
'cacDocumentUrl' => 'https://docs.example.com/kyc/cac/CUS-NG-20240101-002.pdf',
'memart' => 'https://docs.example.com/kyc/memart/CUS-NG-20240101-002.pdf'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"apiKey: <api-key>",
"apiSecret: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://sigmacdd.sabipay.com/api/v1/cdd/customers"
payload := strings.NewReader("{\n \"uniqueId\": \"CUS-NG-20240101-002\",\n \"externalId\": \"EXT-0048292\",\n \"type\": \"corporate\",\n \"status\": \"active\",\n \"customerSegment\": \"sme\",\n \"riskClassification\": \"medium\",\n \"kycLevel\": \"tier_3\",\n \"channel\": \"branch\",\n \"source\": \"api\",\n \"isSanctioned\": false,\n \"isPep\": false,\n \"watchlist\": false,\n \"lastReviewDate\": \"2024-06-01T00:00:00.000Z\",\n \"nextReviewDate\": \"2025-06-01T00:00:00.000Z\",\n \"lastCheck\": \"2024-12-01T00:00:00.000Z\",\n \"businessName\": \"Okafor & Sons Trading Limited\",\n \"businessType\": \"Limited Liability Company\",\n \"industryType\": \"wholesale_trade\",\n \"natureOfBusiness\": \"Import and wholesale distribution of industrial machinery and spare parts\",\n \"registrationNumber\": \"RC-1048291\",\n \"taxIdentificationNumber\": \"9876543210\",\n \"incorporationDate\": \"2015-08-14T00:00:00.000Z\",\n \"countryOfIncorporation\": \"NG\",\n \"stateOfIncorporation\": \"Lagos\",\n \"website\": \"https://okaforandsons.example.com\",\n \"numberOfEmployees\": 47,\n \"phone\": \"+2341234567890\",\n \"businessEmail\": \"info@okaforandsons.example.com\",\n \"headOfficeAddress\": \"Plot 22, Apapa-Oshodi Expressway, Apapa, Lagos\",\n \"annualRevenue\": 850000000,\n \"annualTurnover\": 720000000,\n \"authorizedCapital\": 100000000,\n \"paidUpCapital\": 75000000,\n \"sourceOfFunds\": \"business_revenue\",\n \"parentCompany\": null,\n \"regulatoryLicenses\": [\n \"SON/NG/2019/0012341 - Standards Organisation of Nigeria\",\n \"NESREA/2020/IMP/00892 - Import Permit (Environmental Compliance)\"\n ],\n \"bankCode\": \"044\",\n \"bankName\": \"Access Bank\",\n \"bankCountry\": \"NG\",\n \"relationshipStartDate\": \"2016-01-20T00:00:00.000Z\",\n \"accounts\": [\n {\n \"accountNumber\": \"0987654321\",\n \"accountType\": \"current\",\n \"accountCurrency\": \"NGN\",\n \"purposeOfAccount\": \"primary business operations and payroll\",\n \"openingDate\": \"2016-01-20T00:00:00.000Z\",\n \"accountStatus\": \"active\",\n \"averageBalance\": 42000000,\n \"overdraftLimit\": 20000000,\n \"dailyLimit\": 100000000,\n \"isPrimaryAccount\": true\n },\n {\n \"accountNumber\": \"0912837465\",\n \"accountType\": \"domiciliary\",\n \"accountCurrency\": \"USD\",\n \"purposeOfAccount\": \"import payments and foreign supplier settlements\",\n \"openingDate\": \"2017-03-10T00:00:00.000Z\",\n \"accountStatus\": \"active\",\n \"averageBalance\": 185000,\n \"isPrimaryAccount\": false\n },\n {\n \"accountNumber\": \"0956473829\",\n \"accountType\": \"fixed_deposit\",\n \"accountCurrency\": \"NGN\",\n \"purposeOfAccount\": \"short-term investment of idle funds\",\n \"openingDate\": \"2023-09-01T00:00:00.000Z\",\n \"closingDate\": \"2024-09-01T00:00:00.000Z\",\n \"accountStatus\": \"active\",\n \"averageBalance\": 50000000,\n \"isPrimaryAccount\": false\n }\n ],\n \"directors\": [\n {\n \"firstName\": \"Chukwuemeka\",\n \"lastName\": \"Okafor\",\n \"middleName\": \"Tochukwu\",\n \"dob\": \"1965-03-15T00:00:00.000Z\",\n \"gender\": \"male\",\n \"nationality\": \"Nigerian\",\n \"phone\": \"+2348031234567\",\n \"email\": \"c.okafor@okaforandsons.example.com\",\n \"address\": \"14 Adeola Odeku Street, Victoria Island, Lagos\",\n \"identificationType\": \"bvn\",\n \"identificationNumber\": \"22198765432\",\n \"isPep\": false,\n \"isSanctioned\": false\n },\n {\n \"firstName\": \"Ngozi\",\n \"lastName\": \"Okafor\",\n \"middleName\": \"Adaeze\",\n \"dob\": \"1968-11-22T00:00:00.000Z\",\n \"gender\": \"female\",\n \"nationality\": \"Nigerian\",\n \"phone\": \"+2348059876543\",\n \"email\": \"n.okafor@okaforandsons.example.com\",\n \"address\": \"14 Adeola Odeku Street, Victoria Island, Lagos\",\n \"identificationType\": \"bvn\",\n \"identificationNumber\": \"22345678901\",\n \"isPep\": false,\n \"isSanctioned\": false\n }\n ],\n \"signatories\": [\n {\n \"firstName\": \"Chukwuemeka\",\n \"lastName\": \"Okafor\",\n \"middleName\": \"Tochukwu\",\n \"dob\": \"1965-03-15T00:00:00.000Z\",\n \"gender\": \"male\",\n \"nationality\": \"Nigerian\",\n \"phone\": \"+2348031234567\",\n \"email\": \"c.okafor@okaforandsons.example.com\",\n \"address\": \"14 Adeola Odeku Street, Victoria Island, Lagos\",\n \"identificationType\": \"bvn\",\n \"identificationNumber\": \"22198765432\",\n \"isPep\": false,\n \"isSanctioned\": false\n },\n {\n \"firstName\": \"Emeka\",\n \"lastName\": \"Eze\",\n \"middleName\": \"Chidi\",\n \"dob\": \"1980-07-04T00:00:00.000Z\",\n \"gender\": \"male\",\n \"nationality\": \"Nigerian\",\n \"phone\": \"+2348076543210\",\n \"email\": \"emeka.eze@okaforandsons.example.com\",\n \"address\": \"7 Bode Thomas Street, Surulere, Lagos\",\n \"identificationType\": \"nin\",\n \"identificationNumber\": \"98765432101\",\n \"isPep\": false,\n \"isSanctioned\": false\n }\n ],\n \"ultimateBeneficialOwners\": [\n {\n \"firstName\": \"Chukwuemeka\",\n \"lastName\": \"Okafor\",\n \"middleName\": \"Tochukwu\",\n \"dob\": \"1965-03-15T00:00:00.000Z\",\n \"nationality\": \"Nigerian\",\n \"identificationType\": \"bvn\",\n \"identificationNumber\": \"22198765432\",\n \"ownershipPercentage\": 60,\n \"isPep\": false,\n \"isSanctioned\": false\n },\n {\n \"firstName\": \"Ngozi\",\n \"lastName\": \"Okafor\",\n \"middleName\": \"Adaeze\",\n \"dob\": \"1968-11-22T00:00:00.000Z\",\n \"nationality\": \"Nigerian\",\n \"identificationType\": \"bvn\",\n \"identificationNumber\": \"22345678901\",\n \"ownershipPercentage\": 40,\n \"isPep\": false,\n \"isSanctioned\": false\n }\n ],\n \"metadata\": {\n \"onboardingBranch\": \"Apapa\",\n \"relationshipManager\": \"Adewale Fashola\",\n \"preferredLanguage\": \"en\",\n \"importerExporterCode\": \"IMP/2017/NG/00482\",\n \"cacDocumentUrl\": \"https://docs.example.com/kyc/cac/CUS-NG-20240101-002.pdf\",\n \"memart\": \"https://docs.example.com/kyc/memart/CUS-NG-20240101-002.pdf\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("apiKey", "<api-key>")
req.Header.Add("apiSecret", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://sigmacdd.sabipay.com/api/v1/cdd/customers")
.header("apiKey", "<api-key>")
.header("apiSecret", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"uniqueId\": \"CUS-NG-20240101-002\",\n \"externalId\": \"EXT-0048292\",\n \"type\": \"corporate\",\n \"status\": \"active\",\n \"customerSegment\": \"sme\",\n \"riskClassification\": \"medium\",\n \"kycLevel\": \"tier_3\",\n \"channel\": \"branch\",\n \"source\": \"api\",\n \"isSanctioned\": false,\n \"isPep\": false,\n \"watchlist\": false,\n \"lastReviewDate\": \"2024-06-01T00:00:00.000Z\",\n \"nextReviewDate\": \"2025-06-01T00:00:00.000Z\",\n \"lastCheck\": \"2024-12-01T00:00:00.000Z\",\n \"businessName\": \"Okafor & Sons Trading Limited\",\n \"businessType\": \"Limited Liability Company\",\n \"industryType\": \"wholesale_trade\",\n \"natureOfBusiness\": \"Import and wholesale distribution of industrial machinery and spare parts\",\n \"registrationNumber\": \"RC-1048291\",\n \"taxIdentificationNumber\": \"9876543210\",\n \"incorporationDate\": \"2015-08-14T00:00:00.000Z\",\n \"countryOfIncorporation\": \"NG\",\n \"stateOfIncorporation\": \"Lagos\",\n \"website\": \"https://okaforandsons.example.com\",\n \"numberOfEmployees\": 47,\n \"phone\": \"+2341234567890\",\n \"businessEmail\": \"info@okaforandsons.example.com\",\n \"headOfficeAddress\": \"Plot 22, Apapa-Oshodi Expressway, Apapa, Lagos\",\n \"annualRevenue\": 850000000,\n \"annualTurnover\": 720000000,\n \"authorizedCapital\": 100000000,\n \"paidUpCapital\": 75000000,\n \"sourceOfFunds\": \"business_revenue\",\n \"parentCompany\": null,\n \"regulatoryLicenses\": [\n \"SON/NG/2019/0012341 - Standards Organisation of Nigeria\",\n \"NESREA/2020/IMP/00892 - Import Permit (Environmental Compliance)\"\n ],\n \"bankCode\": \"044\",\n \"bankName\": \"Access Bank\",\n \"bankCountry\": \"NG\",\n \"relationshipStartDate\": \"2016-01-20T00:00:00.000Z\",\n \"accounts\": [\n {\n \"accountNumber\": \"0987654321\",\n \"accountType\": \"current\",\n \"accountCurrency\": \"NGN\",\n \"purposeOfAccount\": \"primary business operations and payroll\",\n \"openingDate\": \"2016-01-20T00:00:00.000Z\",\n \"accountStatus\": \"active\",\n \"averageBalance\": 42000000,\n \"overdraftLimit\": 20000000,\n \"dailyLimit\": 100000000,\n \"isPrimaryAccount\": true\n },\n {\n \"accountNumber\": \"0912837465\",\n \"accountType\": \"domiciliary\",\n \"accountCurrency\": \"USD\",\n \"purposeOfAccount\": \"import payments and foreign supplier settlements\",\n \"openingDate\": \"2017-03-10T00:00:00.000Z\",\n \"accountStatus\": \"active\",\n \"averageBalance\": 185000,\n \"isPrimaryAccount\": false\n },\n {\n \"accountNumber\": \"0956473829\",\n \"accountType\": \"fixed_deposit\",\n \"accountCurrency\": \"NGN\",\n \"purposeOfAccount\": \"short-term investment of idle funds\",\n \"openingDate\": \"2023-09-01T00:00:00.000Z\",\n \"closingDate\": \"2024-09-01T00:00:00.000Z\",\n \"accountStatus\": \"active\",\n \"averageBalance\": 50000000,\n \"isPrimaryAccount\": false\n }\n ],\n \"directors\": [\n {\n \"firstName\": \"Chukwuemeka\",\n \"lastName\": \"Okafor\",\n \"middleName\": \"Tochukwu\",\n \"dob\": \"1965-03-15T00:00:00.000Z\",\n \"gender\": \"male\",\n \"nationality\": \"Nigerian\",\n \"phone\": \"+2348031234567\",\n \"email\": \"c.okafor@okaforandsons.example.com\",\n \"address\": \"14 Adeola Odeku Street, Victoria Island, Lagos\",\n \"identificationType\": \"bvn\",\n \"identificationNumber\": \"22198765432\",\n \"isPep\": false,\n \"isSanctioned\": false\n },\n {\n \"firstName\": \"Ngozi\",\n \"lastName\": \"Okafor\",\n \"middleName\": \"Adaeze\",\n \"dob\": \"1968-11-22T00:00:00.000Z\",\n \"gender\": \"female\",\n \"nationality\": \"Nigerian\",\n \"phone\": \"+2348059876543\",\n \"email\": \"n.okafor@okaforandsons.example.com\",\n \"address\": \"14 Adeola Odeku Street, Victoria Island, Lagos\",\n \"identificationType\": \"bvn\",\n \"identificationNumber\": \"22345678901\",\n \"isPep\": false,\n \"isSanctioned\": false\n }\n ],\n \"signatories\": [\n {\n \"firstName\": \"Chukwuemeka\",\n \"lastName\": \"Okafor\",\n \"middleName\": \"Tochukwu\",\n \"dob\": \"1965-03-15T00:00:00.000Z\",\n \"gender\": \"male\",\n \"nationality\": \"Nigerian\",\n \"phone\": \"+2348031234567\",\n \"email\": \"c.okafor@okaforandsons.example.com\",\n \"address\": \"14 Adeola Odeku Street, Victoria Island, Lagos\",\n \"identificationType\": \"bvn\",\n \"identificationNumber\": \"22198765432\",\n \"isPep\": false,\n \"isSanctioned\": false\n },\n {\n \"firstName\": \"Emeka\",\n \"lastName\": \"Eze\",\n \"middleName\": \"Chidi\",\n \"dob\": \"1980-07-04T00:00:00.000Z\",\n \"gender\": \"male\",\n \"nationality\": \"Nigerian\",\n \"phone\": \"+2348076543210\",\n \"email\": \"emeka.eze@okaforandsons.example.com\",\n \"address\": \"7 Bode Thomas Street, Surulere, Lagos\",\n \"identificationType\": \"nin\",\n \"identificationNumber\": \"98765432101\",\n \"isPep\": false,\n \"isSanctioned\": false\n }\n ],\n \"ultimateBeneficialOwners\": [\n {\n \"firstName\": \"Chukwuemeka\",\n \"lastName\": \"Okafor\",\n \"middleName\": \"Tochukwu\",\n \"dob\": \"1965-03-15T00:00:00.000Z\",\n \"nationality\": \"Nigerian\",\n \"identificationType\": \"bvn\",\n \"identificationNumber\": \"22198765432\",\n \"ownershipPercentage\": 60,\n \"isPep\": false,\n \"isSanctioned\": false\n },\n {\n \"firstName\": \"Ngozi\",\n \"lastName\": \"Okafor\",\n \"middleName\": \"Adaeze\",\n \"dob\": \"1968-11-22T00:00:00.000Z\",\n \"nationality\": \"Nigerian\",\n \"identificationType\": \"bvn\",\n \"identificationNumber\": \"22345678901\",\n \"ownershipPercentage\": 40,\n \"isPep\": false,\n \"isSanctioned\": false\n }\n ],\n \"metadata\": {\n \"onboardingBranch\": \"Apapa\",\n \"relationshipManager\": \"Adewale Fashola\",\n \"preferredLanguage\": \"en\",\n \"importerExporterCode\": \"IMP/2017/NG/00482\",\n \"cacDocumentUrl\": \"https://docs.example.com/kyc/cac/CUS-NG-20240101-002.pdf\",\n \"memart\": \"https://docs.example.com/kyc/memart/CUS-NG-20240101-002.pdf\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://sigmacdd.sabipay.com/api/v1/cdd/customers")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["apiKey"] = '<api-key>'
request["apiSecret"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"uniqueId\": \"CUS-NG-20240101-002\",\n \"externalId\": \"EXT-0048292\",\n \"type\": \"corporate\",\n \"status\": \"active\",\n \"customerSegment\": \"sme\",\n \"riskClassification\": \"medium\",\n \"kycLevel\": \"tier_3\",\n \"channel\": \"branch\",\n \"source\": \"api\",\n \"isSanctioned\": false,\n \"isPep\": false,\n \"watchlist\": false,\n \"lastReviewDate\": \"2024-06-01T00:00:00.000Z\",\n \"nextReviewDate\": \"2025-06-01T00:00:00.000Z\",\n \"lastCheck\": \"2024-12-01T00:00:00.000Z\",\n \"businessName\": \"Okafor & Sons Trading Limited\",\n \"businessType\": \"Limited Liability Company\",\n \"industryType\": \"wholesale_trade\",\n \"natureOfBusiness\": \"Import and wholesale distribution of industrial machinery and spare parts\",\n \"registrationNumber\": \"RC-1048291\",\n \"taxIdentificationNumber\": \"9876543210\",\n \"incorporationDate\": \"2015-08-14T00:00:00.000Z\",\n \"countryOfIncorporation\": \"NG\",\n \"stateOfIncorporation\": \"Lagos\",\n \"website\": \"https://okaforandsons.example.com\",\n \"numberOfEmployees\": 47,\n \"phone\": \"+2341234567890\",\n \"businessEmail\": \"info@okaforandsons.example.com\",\n \"headOfficeAddress\": \"Plot 22, Apapa-Oshodi Expressway, Apapa, Lagos\",\n \"annualRevenue\": 850000000,\n \"annualTurnover\": 720000000,\n \"authorizedCapital\": 100000000,\n \"paidUpCapital\": 75000000,\n \"sourceOfFunds\": \"business_revenue\",\n \"parentCompany\": null,\n \"regulatoryLicenses\": [\n \"SON/NG/2019/0012341 - Standards Organisation of Nigeria\",\n \"NESREA/2020/IMP/00892 - Import Permit (Environmental Compliance)\"\n ],\n \"bankCode\": \"044\",\n \"bankName\": \"Access Bank\",\n \"bankCountry\": \"NG\",\n \"relationshipStartDate\": \"2016-01-20T00:00:00.000Z\",\n \"accounts\": [\n {\n \"accountNumber\": \"0987654321\",\n \"accountType\": \"current\",\n \"accountCurrency\": \"NGN\",\n \"purposeOfAccount\": \"primary business operations and payroll\",\n \"openingDate\": \"2016-01-20T00:00:00.000Z\",\n \"accountStatus\": \"active\",\n \"averageBalance\": 42000000,\n \"overdraftLimit\": 20000000,\n \"dailyLimit\": 100000000,\n \"isPrimaryAccount\": true\n },\n {\n \"accountNumber\": \"0912837465\",\n \"accountType\": \"domiciliary\",\n \"accountCurrency\": \"USD\",\n \"purposeOfAccount\": \"import payments and foreign supplier settlements\",\n \"openingDate\": \"2017-03-10T00:00:00.000Z\",\n \"accountStatus\": \"active\",\n \"averageBalance\": 185000,\n \"isPrimaryAccount\": false\n },\n {\n \"accountNumber\": \"0956473829\",\n \"accountType\": \"fixed_deposit\",\n \"accountCurrency\": \"NGN\",\n \"purposeOfAccount\": \"short-term investment of idle funds\",\n \"openingDate\": \"2023-09-01T00:00:00.000Z\",\n \"closingDate\": \"2024-09-01T00:00:00.000Z\",\n \"accountStatus\": \"active\",\n \"averageBalance\": 50000000,\n \"isPrimaryAccount\": false\n }\n ],\n \"directors\": [\n {\n \"firstName\": \"Chukwuemeka\",\n \"lastName\": \"Okafor\",\n \"middleName\": \"Tochukwu\",\n \"dob\": \"1965-03-15T00:00:00.000Z\",\n \"gender\": \"male\",\n \"nationality\": \"Nigerian\",\n \"phone\": \"+2348031234567\",\n \"email\": \"c.okafor@okaforandsons.example.com\",\n \"address\": \"14 Adeola Odeku Street, Victoria Island, Lagos\",\n \"identificationType\": \"bvn\",\n \"identificationNumber\": \"22198765432\",\n \"isPep\": false,\n \"isSanctioned\": false\n },\n {\n \"firstName\": \"Ngozi\",\n \"lastName\": \"Okafor\",\n \"middleName\": \"Adaeze\",\n \"dob\": \"1968-11-22T00:00:00.000Z\",\n \"gender\": \"female\",\n \"nationality\": \"Nigerian\",\n \"phone\": \"+2348059876543\",\n \"email\": \"n.okafor@okaforandsons.example.com\",\n \"address\": \"14 Adeola Odeku Street, Victoria Island, Lagos\",\n \"identificationType\": \"bvn\",\n \"identificationNumber\": \"22345678901\",\n \"isPep\": false,\n \"isSanctioned\": false\n }\n ],\n \"signatories\": [\n {\n \"firstName\": \"Chukwuemeka\",\n \"lastName\": \"Okafor\",\n \"middleName\": \"Tochukwu\",\n \"dob\": \"1965-03-15T00:00:00.000Z\",\n \"gender\": \"male\",\n \"nationality\": \"Nigerian\",\n \"phone\": \"+2348031234567\",\n \"email\": \"c.okafor@okaforandsons.example.com\",\n \"address\": \"14 Adeola Odeku Street, Victoria Island, Lagos\",\n \"identificationType\": \"bvn\",\n \"identificationNumber\": \"22198765432\",\n \"isPep\": false,\n \"isSanctioned\": false\n },\n {\n \"firstName\": \"Emeka\",\n \"lastName\": \"Eze\",\n \"middleName\": \"Chidi\",\n \"dob\": \"1980-07-04T00:00:00.000Z\",\n \"gender\": \"male\",\n \"nationality\": \"Nigerian\",\n \"phone\": \"+2348076543210\",\n \"email\": \"emeka.eze@okaforandsons.example.com\",\n \"address\": \"7 Bode Thomas Street, Surulere, Lagos\",\n \"identificationType\": \"nin\",\n \"identificationNumber\": \"98765432101\",\n \"isPep\": false,\n \"isSanctioned\": false\n }\n ],\n \"ultimateBeneficialOwners\": [\n {\n \"firstName\": \"Chukwuemeka\",\n \"lastName\": \"Okafor\",\n \"middleName\": \"Tochukwu\",\n \"dob\": \"1965-03-15T00:00:00.000Z\",\n \"nationality\": \"Nigerian\",\n \"identificationType\": \"bvn\",\n \"identificationNumber\": \"22198765432\",\n \"ownershipPercentage\": 60,\n \"isPep\": false,\n \"isSanctioned\": false\n },\n {\n \"firstName\": \"Ngozi\",\n \"lastName\": \"Okafor\",\n \"middleName\": \"Adaeze\",\n \"dob\": \"1968-11-22T00:00:00.000Z\",\n \"nationality\": \"Nigerian\",\n \"identificationType\": \"bvn\",\n \"identificationNumber\": \"22345678901\",\n \"ownershipPercentage\": 40,\n \"isPep\": false,\n \"isSanctioned\": false\n }\n ],\n \"metadata\": {\n \"onboardingBranch\": \"Apapa\",\n \"relationshipManager\": \"Adewale Fashola\",\n \"preferredLanguage\": \"en\",\n \"importerExporterCode\": \"IMP/2017/NG/00482\",\n \"cacDocumentUrl\": \"https://docs.example.com/kyc/cac/CUS-NG-20240101-002.pdf\",\n \"memart\": \"https://docs.example.com/kyc/memart/CUS-NG-20240101-002.pdf\"\n }\n}"
response = http.request(request)
puts response.read_body{
"message": "CDD customer created successfully",
"data": {
"_id": "67f50d48c2a7d1f2b6e99390",
"uniqueId": "CUS-NG-20240101-002",
"type": "corporate",
"businessName": "Okafor & Sons Trading Limited",
"channel": "branch",
"status": "active",
"createdAt": "2026-03-25T10:25:00.000Z"
}
}{
"message": "Customer with uniqueId CUS-NG-20240101-002 already exists"
}This endpoint is for creating corporate customers. For individual customers, see Create Individual Customer.
Body
application/json
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes