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": "CUST-CORP-001",
"type": "corporate",
"channel": "branch",
"businessName": "Pastel Technologies Ltd",
"registrationNumber": "RC1234567",
"taxIdentificationNumber": "19876543-0001",
"headOfficeAddress": "Plot 7, Wuse Zone 4, Abuja, FCT",
"incorporationDate": "2018-03-22",
"countryOfIncorporation": "Nigeria",
"stateOfIncorporation": "FCT",
"signatories": [
{
"firstName": "Emeka",
"lastName": "Nwosu",
"title": "Mr",
"middleName": "Chidi",
"dob": "1985-07-10",
"gender": "male",
"phone": "+2348023456789",
"address": "5 Aminu Kano Crescent, Wuse 2, Abuja",
"bvnNumber": "22334455667",
"ninNumber": "11223344556",
"passportNumber": "B98765432",
"accountNumber": "9876543210",
"nationality": "Nigerian",
"occupation": "Chief Executive Officer",
"politicalAffiliation": false,
"politicalPosition": false,
"sourceOfFunds": "business income"
}
],
"directors": [
{
"firstName": "Ngozi",
"lastName": "Adeyemi",
"title": "Dr",
"dob": "1978-11-30",
"gender": "female",
"phone": "+2347034567890",
"address": "22 Marina Road, Lagos Island, Lagos",
"bvnNumber": "33445566778",
"nationality": "Nigerian",
"occupation": "Non-Executive Director",
"politicalAffiliation": true,
"politicalPosition": false,
"politicalAffiliationRelationship": "Spouse of former senator"
}
],
"groupName": "Corporate Clients 2024"
}
'import requests
url = "https://sigmacdd.sabipay.com/api/v1/cdd/customers"
payload = {
"uniqueId": "CUST-CORP-001",
"type": "corporate",
"channel": "branch",
"businessName": "Pastel Technologies Ltd",
"registrationNumber": "RC1234567",
"taxIdentificationNumber": "19876543-0001",
"headOfficeAddress": "Plot 7, Wuse Zone 4, Abuja, FCT",
"incorporationDate": "2018-03-22",
"countryOfIncorporation": "Nigeria",
"stateOfIncorporation": "FCT",
"signatories": [
{
"firstName": "Emeka",
"lastName": "Nwosu",
"title": "Mr",
"middleName": "Chidi",
"dob": "1985-07-10",
"gender": "male",
"phone": "+2348023456789",
"address": "5 Aminu Kano Crescent, Wuse 2, Abuja",
"bvnNumber": "22334455667",
"ninNumber": "11223344556",
"passportNumber": "B98765432",
"accountNumber": "9876543210",
"nationality": "Nigerian",
"occupation": "Chief Executive Officer",
"politicalAffiliation": False,
"politicalPosition": False,
"sourceOfFunds": "business income"
}
],
"directors": [
{
"firstName": "Ngozi",
"lastName": "Adeyemi",
"title": "Dr",
"dob": "1978-11-30",
"gender": "female",
"phone": "+2347034567890",
"address": "22 Marina Road, Lagos Island, Lagos",
"bvnNumber": "33445566778",
"nationality": "Nigerian",
"occupation": "Non-Executive Director",
"politicalAffiliation": True,
"politicalPosition": False,
"politicalAffiliationRelationship": "Spouse of former senator"
}
],
"groupName": "Corporate Clients 2024"
}
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: 'CUST-CORP-001',
type: 'corporate',
channel: 'branch',
businessName: 'Pastel Technologies Ltd',
registrationNumber: 'RC1234567',
taxIdentificationNumber: '19876543-0001',
headOfficeAddress: 'Plot 7, Wuse Zone 4, Abuja, FCT',
incorporationDate: '2018-03-22',
countryOfIncorporation: 'Nigeria',
stateOfIncorporation: 'FCT',
signatories: [
{
firstName: 'Emeka',
lastName: 'Nwosu',
title: 'Mr',
middleName: 'Chidi',
dob: '1985-07-10',
gender: 'male',
phone: '+2348023456789',
address: '5 Aminu Kano Crescent, Wuse 2, Abuja',
bvnNumber: '22334455667',
ninNumber: '11223344556',
passportNumber: 'B98765432',
accountNumber: '9876543210',
nationality: 'Nigerian',
occupation: 'Chief Executive Officer',
politicalAffiliation: false,
politicalPosition: false,
sourceOfFunds: 'business income'
}
],
directors: [
{
firstName: 'Ngozi',
lastName: 'Adeyemi',
title: 'Dr',
dob: '1978-11-30',
gender: 'female',
phone: '+2347034567890',
address: '22 Marina Road, Lagos Island, Lagos',
bvnNumber: '33445566778',
nationality: 'Nigerian',
occupation: 'Non-Executive Director',
politicalAffiliation: true,
politicalPosition: false,
politicalAffiliationRelationship: 'Spouse of former senator'
}
],
groupName: 'Corporate Clients 2024'
})
};
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' => 'CUST-CORP-001',
'type' => 'corporate',
'channel' => 'branch',
'businessName' => 'Pastel Technologies Ltd',
'registrationNumber' => 'RC1234567',
'taxIdentificationNumber' => '19876543-0001',
'headOfficeAddress' => 'Plot 7, Wuse Zone 4, Abuja, FCT',
'incorporationDate' => '2018-03-22',
'countryOfIncorporation' => 'Nigeria',
'stateOfIncorporation' => 'FCT',
'signatories' => [
[
'firstName' => 'Emeka',
'lastName' => 'Nwosu',
'title' => 'Mr',
'middleName' => 'Chidi',
'dob' => '1985-07-10',
'gender' => 'male',
'phone' => '+2348023456789',
'address' => '5 Aminu Kano Crescent, Wuse 2, Abuja',
'bvnNumber' => '22334455667',
'ninNumber' => '11223344556',
'passportNumber' => 'B98765432',
'accountNumber' => '9876543210',
'nationality' => 'Nigerian',
'occupation' => 'Chief Executive Officer',
'politicalAffiliation' => false,
'politicalPosition' => false,
'sourceOfFunds' => 'business income'
]
],
'directors' => [
[
'firstName' => 'Ngozi',
'lastName' => 'Adeyemi',
'title' => 'Dr',
'dob' => '1978-11-30',
'gender' => 'female',
'phone' => '+2347034567890',
'address' => '22 Marina Road, Lagos Island, Lagos',
'bvnNumber' => '33445566778',
'nationality' => 'Nigerian',
'occupation' => 'Non-Executive Director',
'politicalAffiliation' => true,
'politicalPosition' => false,
'politicalAffiliationRelationship' => 'Spouse of former senator'
]
],
'groupName' => 'Corporate Clients 2024'
]),
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\": \"CUST-CORP-001\",\n \"type\": \"corporate\",\n \"channel\": \"branch\",\n \"businessName\": \"Pastel Technologies Ltd\",\n \"registrationNumber\": \"RC1234567\",\n \"taxIdentificationNumber\": \"19876543-0001\",\n \"headOfficeAddress\": \"Plot 7, Wuse Zone 4, Abuja, FCT\",\n \"incorporationDate\": \"2018-03-22\",\n \"countryOfIncorporation\": \"Nigeria\",\n \"stateOfIncorporation\": \"FCT\",\n \"signatories\": [\n {\n \"firstName\": \"Emeka\",\n \"lastName\": \"Nwosu\",\n \"title\": \"Mr\",\n \"middleName\": \"Chidi\",\n \"dob\": \"1985-07-10\",\n \"gender\": \"male\",\n \"phone\": \"+2348023456789\",\n \"address\": \"5 Aminu Kano Crescent, Wuse 2, Abuja\",\n \"bvnNumber\": \"22334455667\",\n \"ninNumber\": \"11223344556\",\n \"passportNumber\": \"B98765432\",\n \"accountNumber\": \"9876543210\",\n \"nationality\": \"Nigerian\",\n \"occupation\": \"Chief Executive Officer\",\n \"politicalAffiliation\": false,\n \"politicalPosition\": false,\n \"sourceOfFunds\": \"business income\"\n }\n ],\n \"directors\": [\n {\n \"firstName\": \"Ngozi\",\n \"lastName\": \"Adeyemi\",\n \"title\": \"Dr\",\n \"dob\": \"1978-11-30\",\n \"gender\": \"female\",\n \"phone\": \"+2347034567890\",\n \"address\": \"22 Marina Road, Lagos Island, Lagos\",\n \"bvnNumber\": \"33445566778\",\n \"nationality\": \"Nigerian\",\n \"occupation\": \"Non-Executive Director\",\n \"politicalAffiliation\": true,\n \"politicalPosition\": false,\n \"politicalAffiliationRelationship\": \"Spouse of former senator\"\n }\n ],\n \"groupName\": \"Corporate Clients 2024\"\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\": \"CUST-CORP-001\",\n \"type\": \"corporate\",\n \"channel\": \"branch\",\n \"businessName\": \"Pastel Technologies Ltd\",\n \"registrationNumber\": \"RC1234567\",\n \"taxIdentificationNumber\": \"19876543-0001\",\n \"headOfficeAddress\": \"Plot 7, Wuse Zone 4, Abuja, FCT\",\n \"incorporationDate\": \"2018-03-22\",\n \"countryOfIncorporation\": \"Nigeria\",\n \"stateOfIncorporation\": \"FCT\",\n \"signatories\": [\n {\n \"firstName\": \"Emeka\",\n \"lastName\": \"Nwosu\",\n \"title\": \"Mr\",\n \"middleName\": \"Chidi\",\n \"dob\": \"1985-07-10\",\n \"gender\": \"male\",\n \"phone\": \"+2348023456789\",\n \"address\": \"5 Aminu Kano Crescent, Wuse 2, Abuja\",\n \"bvnNumber\": \"22334455667\",\n \"ninNumber\": \"11223344556\",\n \"passportNumber\": \"B98765432\",\n \"accountNumber\": \"9876543210\",\n \"nationality\": \"Nigerian\",\n \"occupation\": \"Chief Executive Officer\",\n \"politicalAffiliation\": false,\n \"politicalPosition\": false,\n \"sourceOfFunds\": \"business income\"\n }\n ],\n \"directors\": [\n {\n \"firstName\": \"Ngozi\",\n \"lastName\": \"Adeyemi\",\n \"title\": \"Dr\",\n \"dob\": \"1978-11-30\",\n \"gender\": \"female\",\n \"phone\": \"+2347034567890\",\n \"address\": \"22 Marina Road, Lagos Island, Lagos\",\n \"bvnNumber\": \"33445566778\",\n \"nationality\": \"Nigerian\",\n \"occupation\": \"Non-Executive Director\",\n \"politicalAffiliation\": true,\n \"politicalPosition\": false,\n \"politicalAffiliationRelationship\": \"Spouse of former senator\"\n }\n ],\n \"groupName\": \"Corporate Clients 2024\"\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\": \"CUST-CORP-001\",\n \"type\": \"corporate\",\n \"channel\": \"branch\",\n \"businessName\": \"Pastel Technologies Ltd\",\n \"registrationNumber\": \"RC1234567\",\n \"taxIdentificationNumber\": \"19876543-0001\",\n \"headOfficeAddress\": \"Plot 7, Wuse Zone 4, Abuja, FCT\",\n \"incorporationDate\": \"2018-03-22\",\n \"countryOfIncorporation\": \"Nigeria\",\n \"stateOfIncorporation\": \"FCT\",\n \"signatories\": [\n {\n \"firstName\": \"Emeka\",\n \"lastName\": \"Nwosu\",\n \"title\": \"Mr\",\n \"middleName\": \"Chidi\",\n \"dob\": \"1985-07-10\",\n \"gender\": \"male\",\n \"phone\": \"+2348023456789\",\n \"address\": \"5 Aminu Kano Crescent, Wuse 2, Abuja\",\n \"bvnNumber\": \"22334455667\",\n \"ninNumber\": \"11223344556\",\n \"passportNumber\": \"B98765432\",\n \"accountNumber\": \"9876543210\",\n \"nationality\": \"Nigerian\",\n \"occupation\": \"Chief Executive Officer\",\n \"politicalAffiliation\": false,\n \"politicalPosition\": false,\n \"sourceOfFunds\": \"business income\"\n }\n ],\n \"directors\": [\n {\n \"firstName\": \"Ngozi\",\n \"lastName\": \"Adeyemi\",\n \"title\": \"Dr\",\n \"dob\": \"1978-11-30\",\n \"gender\": \"female\",\n \"phone\": \"+2347034567890\",\n \"address\": \"22 Marina Road, Lagos Island, Lagos\",\n \"bvnNumber\": \"33445566778\",\n \"nationality\": \"Nigerian\",\n \"occupation\": \"Non-Executive Director\",\n \"politicalAffiliation\": true,\n \"politicalPosition\": false,\n \"politicalAffiliationRelationship\": \"Spouse of former senator\"\n }\n ],\n \"groupName\": \"Corporate Clients 2024\"\n}"
response = http.request(request)
puts response.read_body{
"message": "CDD customer created successfully",
"data": {
"_id": "67f50d48c2a7d1f2b6e99390",
"uniqueId": "CUST-CORP-001",
"type": "corporate",
"businessName": "Pastel Technologies Ltd",
"channel": "branch",
"status": "active",
"createdAt": "2026-03-25T10:25:00.000Z"
}
}{
"message": "Group type does not match customer type"
}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": "CUST-CORP-001",
"type": "corporate",
"channel": "branch",
"businessName": "Pastel Technologies Ltd",
"registrationNumber": "RC1234567",
"taxIdentificationNumber": "19876543-0001",
"headOfficeAddress": "Plot 7, Wuse Zone 4, Abuja, FCT",
"incorporationDate": "2018-03-22",
"countryOfIncorporation": "Nigeria",
"stateOfIncorporation": "FCT",
"signatories": [
{
"firstName": "Emeka",
"lastName": "Nwosu",
"title": "Mr",
"middleName": "Chidi",
"dob": "1985-07-10",
"gender": "male",
"phone": "+2348023456789",
"address": "5 Aminu Kano Crescent, Wuse 2, Abuja",
"bvnNumber": "22334455667",
"ninNumber": "11223344556",
"passportNumber": "B98765432",
"accountNumber": "9876543210",
"nationality": "Nigerian",
"occupation": "Chief Executive Officer",
"politicalAffiliation": false,
"politicalPosition": false,
"sourceOfFunds": "business income"
}
],
"directors": [
{
"firstName": "Ngozi",
"lastName": "Adeyemi",
"title": "Dr",
"dob": "1978-11-30",
"gender": "female",
"phone": "+2347034567890",
"address": "22 Marina Road, Lagos Island, Lagos",
"bvnNumber": "33445566778",
"nationality": "Nigerian",
"occupation": "Non-Executive Director",
"politicalAffiliation": true,
"politicalPosition": false,
"politicalAffiliationRelationship": "Spouse of former senator"
}
],
"groupName": "Corporate Clients 2024"
}
'import requests
url = "https://sigmacdd.sabipay.com/api/v1/cdd/customers"
payload = {
"uniqueId": "CUST-CORP-001",
"type": "corporate",
"channel": "branch",
"businessName": "Pastel Technologies Ltd",
"registrationNumber": "RC1234567",
"taxIdentificationNumber": "19876543-0001",
"headOfficeAddress": "Plot 7, Wuse Zone 4, Abuja, FCT",
"incorporationDate": "2018-03-22",
"countryOfIncorporation": "Nigeria",
"stateOfIncorporation": "FCT",
"signatories": [
{
"firstName": "Emeka",
"lastName": "Nwosu",
"title": "Mr",
"middleName": "Chidi",
"dob": "1985-07-10",
"gender": "male",
"phone": "+2348023456789",
"address": "5 Aminu Kano Crescent, Wuse 2, Abuja",
"bvnNumber": "22334455667",
"ninNumber": "11223344556",
"passportNumber": "B98765432",
"accountNumber": "9876543210",
"nationality": "Nigerian",
"occupation": "Chief Executive Officer",
"politicalAffiliation": False,
"politicalPosition": False,
"sourceOfFunds": "business income"
}
],
"directors": [
{
"firstName": "Ngozi",
"lastName": "Adeyemi",
"title": "Dr",
"dob": "1978-11-30",
"gender": "female",
"phone": "+2347034567890",
"address": "22 Marina Road, Lagos Island, Lagos",
"bvnNumber": "33445566778",
"nationality": "Nigerian",
"occupation": "Non-Executive Director",
"politicalAffiliation": True,
"politicalPosition": False,
"politicalAffiliationRelationship": "Spouse of former senator"
}
],
"groupName": "Corporate Clients 2024"
}
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: 'CUST-CORP-001',
type: 'corporate',
channel: 'branch',
businessName: 'Pastel Technologies Ltd',
registrationNumber: 'RC1234567',
taxIdentificationNumber: '19876543-0001',
headOfficeAddress: 'Plot 7, Wuse Zone 4, Abuja, FCT',
incorporationDate: '2018-03-22',
countryOfIncorporation: 'Nigeria',
stateOfIncorporation: 'FCT',
signatories: [
{
firstName: 'Emeka',
lastName: 'Nwosu',
title: 'Mr',
middleName: 'Chidi',
dob: '1985-07-10',
gender: 'male',
phone: '+2348023456789',
address: '5 Aminu Kano Crescent, Wuse 2, Abuja',
bvnNumber: '22334455667',
ninNumber: '11223344556',
passportNumber: 'B98765432',
accountNumber: '9876543210',
nationality: 'Nigerian',
occupation: 'Chief Executive Officer',
politicalAffiliation: false,
politicalPosition: false,
sourceOfFunds: 'business income'
}
],
directors: [
{
firstName: 'Ngozi',
lastName: 'Adeyemi',
title: 'Dr',
dob: '1978-11-30',
gender: 'female',
phone: '+2347034567890',
address: '22 Marina Road, Lagos Island, Lagos',
bvnNumber: '33445566778',
nationality: 'Nigerian',
occupation: 'Non-Executive Director',
politicalAffiliation: true,
politicalPosition: false,
politicalAffiliationRelationship: 'Spouse of former senator'
}
],
groupName: 'Corporate Clients 2024'
})
};
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' => 'CUST-CORP-001',
'type' => 'corporate',
'channel' => 'branch',
'businessName' => 'Pastel Technologies Ltd',
'registrationNumber' => 'RC1234567',
'taxIdentificationNumber' => '19876543-0001',
'headOfficeAddress' => 'Plot 7, Wuse Zone 4, Abuja, FCT',
'incorporationDate' => '2018-03-22',
'countryOfIncorporation' => 'Nigeria',
'stateOfIncorporation' => 'FCT',
'signatories' => [
[
'firstName' => 'Emeka',
'lastName' => 'Nwosu',
'title' => 'Mr',
'middleName' => 'Chidi',
'dob' => '1985-07-10',
'gender' => 'male',
'phone' => '+2348023456789',
'address' => '5 Aminu Kano Crescent, Wuse 2, Abuja',
'bvnNumber' => '22334455667',
'ninNumber' => '11223344556',
'passportNumber' => 'B98765432',
'accountNumber' => '9876543210',
'nationality' => 'Nigerian',
'occupation' => 'Chief Executive Officer',
'politicalAffiliation' => false,
'politicalPosition' => false,
'sourceOfFunds' => 'business income'
]
],
'directors' => [
[
'firstName' => 'Ngozi',
'lastName' => 'Adeyemi',
'title' => 'Dr',
'dob' => '1978-11-30',
'gender' => 'female',
'phone' => '+2347034567890',
'address' => '22 Marina Road, Lagos Island, Lagos',
'bvnNumber' => '33445566778',
'nationality' => 'Nigerian',
'occupation' => 'Non-Executive Director',
'politicalAffiliation' => true,
'politicalPosition' => false,
'politicalAffiliationRelationship' => 'Spouse of former senator'
]
],
'groupName' => 'Corporate Clients 2024'
]),
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\": \"CUST-CORP-001\",\n \"type\": \"corporate\",\n \"channel\": \"branch\",\n \"businessName\": \"Pastel Technologies Ltd\",\n \"registrationNumber\": \"RC1234567\",\n \"taxIdentificationNumber\": \"19876543-0001\",\n \"headOfficeAddress\": \"Plot 7, Wuse Zone 4, Abuja, FCT\",\n \"incorporationDate\": \"2018-03-22\",\n \"countryOfIncorporation\": \"Nigeria\",\n \"stateOfIncorporation\": \"FCT\",\n \"signatories\": [\n {\n \"firstName\": \"Emeka\",\n \"lastName\": \"Nwosu\",\n \"title\": \"Mr\",\n \"middleName\": \"Chidi\",\n \"dob\": \"1985-07-10\",\n \"gender\": \"male\",\n \"phone\": \"+2348023456789\",\n \"address\": \"5 Aminu Kano Crescent, Wuse 2, Abuja\",\n \"bvnNumber\": \"22334455667\",\n \"ninNumber\": \"11223344556\",\n \"passportNumber\": \"B98765432\",\n \"accountNumber\": \"9876543210\",\n \"nationality\": \"Nigerian\",\n \"occupation\": \"Chief Executive Officer\",\n \"politicalAffiliation\": false,\n \"politicalPosition\": false,\n \"sourceOfFunds\": \"business income\"\n }\n ],\n \"directors\": [\n {\n \"firstName\": \"Ngozi\",\n \"lastName\": \"Adeyemi\",\n \"title\": \"Dr\",\n \"dob\": \"1978-11-30\",\n \"gender\": \"female\",\n \"phone\": \"+2347034567890\",\n \"address\": \"22 Marina Road, Lagos Island, Lagos\",\n \"bvnNumber\": \"33445566778\",\n \"nationality\": \"Nigerian\",\n \"occupation\": \"Non-Executive Director\",\n \"politicalAffiliation\": true,\n \"politicalPosition\": false,\n \"politicalAffiliationRelationship\": \"Spouse of former senator\"\n }\n ],\n \"groupName\": \"Corporate Clients 2024\"\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\": \"CUST-CORP-001\",\n \"type\": \"corporate\",\n \"channel\": \"branch\",\n \"businessName\": \"Pastel Technologies Ltd\",\n \"registrationNumber\": \"RC1234567\",\n \"taxIdentificationNumber\": \"19876543-0001\",\n \"headOfficeAddress\": \"Plot 7, Wuse Zone 4, Abuja, FCT\",\n \"incorporationDate\": \"2018-03-22\",\n \"countryOfIncorporation\": \"Nigeria\",\n \"stateOfIncorporation\": \"FCT\",\n \"signatories\": [\n {\n \"firstName\": \"Emeka\",\n \"lastName\": \"Nwosu\",\n \"title\": \"Mr\",\n \"middleName\": \"Chidi\",\n \"dob\": \"1985-07-10\",\n \"gender\": \"male\",\n \"phone\": \"+2348023456789\",\n \"address\": \"5 Aminu Kano Crescent, Wuse 2, Abuja\",\n \"bvnNumber\": \"22334455667\",\n \"ninNumber\": \"11223344556\",\n \"passportNumber\": \"B98765432\",\n \"accountNumber\": \"9876543210\",\n \"nationality\": \"Nigerian\",\n \"occupation\": \"Chief Executive Officer\",\n \"politicalAffiliation\": false,\n \"politicalPosition\": false,\n \"sourceOfFunds\": \"business income\"\n }\n ],\n \"directors\": [\n {\n \"firstName\": \"Ngozi\",\n \"lastName\": \"Adeyemi\",\n \"title\": \"Dr\",\n \"dob\": \"1978-11-30\",\n \"gender\": \"female\",\n \"phone\": \"+2347034567890\",\n \"address\": \"22 Marina Road, Lagos Island, Lagos\",\n \"bvnNumber\": \"33445566778\",\n \"nationality\": \"Nigerian\",\n \"occupation\": \"Non-Executive Director\",\n \"politicalAffiliation\": true,\n \"politicalPosition\": false,\n \"politicalAffiliationRelationship\": \"Spouse of former senator\"\n }\n ],\n \"groupName\": \"Corporate Clients 2024\"\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\": \"CUST-CORP-001\",\n \"type\": \"corporate\",\n \"channel\": \"branch\",\n \"businessName\": \"Pastel Technologies Ltd\",\n \"registrationNumber\": \"RC1234567\",\n \"taxIdentificationNumber\": \"19876543-0001\",\n \"headOfficeAddress\": \"Plot 7, Wuse Zone 4, Abuja, FCT\",\n \"incorporationDate\": \"2018-03-22\",\n \"countryOfIncorporation\": \"Nigeria\",\n \"stateOfIncorporation\": \"FCT\",\n \"signatories\": [\n {\n \"firstName\": \"Emeka\",\n \"lastName\": \"Nwosu\",\n \"title\": \"Mr\",\n \"middleName\": \"Chidi\",\n \"dob\": \"1985-07-10\",\n \"gender\": \"male\",\n \"phone\": \"+2348023456789\",\n \"address\": \"5 Aminu Kano Crescent, Wuse 2, Abuja\",\n \"bvnNumber\": \"22334455667\",\n \"ninNumber\": \"11223344556\",\n \"passportNumber\": \"B98765432\",\n \"accountNumber\": \"9876543210\",\n \"nationality\": \"Nigerian\",\n \"occupation\": \"Chief Executive Officer\",\n \"politicalAffiliation\": false,\n \"politicalPosition\": false,\n \"sourceOfFunds\": \"business income\"\n }\n ],\n \"directors\": [\n {\n \"firstName\": \"Ngozi\",\n \"lastName\": \"Adeyemi\",\n \"title\": \"Dr\",\n \"dob\": \"1978-11-30\",\n \"gender\": \"female\",\n \"phone\": \"+2347034567890\",\n \"address\": \"22 Marina Road, Lagos Island, Lagos\",\n \"bvnNumber\": \"33445566778\",\n \"nationality\": \"Nigerian\",\n \"occupation\": \"Non-Executive Director\",\n \"politicalAffiliation\": true,\n \"politicalPosition\": false,\n \"politicalAffiliationRelationship\": \"Spouse of former senator\"\n }\n ],\n \"groupName\": \"Corporate Clients 2024\"\n}"
response = http.request(request)
puts response.read_body{
"message": "CDD customer created successfully",
"data": {
"_id": "67f50d48c2a7d1f2b6e99390",
"uniqueId": "CUST-CORP-001",
"type": "corporate",
"businessName": "Pastel Technologies Ltd",
"channel": "branch",
"status": "active",
"createdAt": "2026-03-25T10:25:00.000Z"
}
}{
"message": "Group type does not match customer type"
}This endpoint is for creating corporate customers. For individual customers, see Create Individual Customer.
Body
application/json
Example:
"corporate"
Show child attributes
Show child attributes
Show child attributes
Show child attributes
⌘I