Create Customer
curl --request POST \
--url https://flickopenapi.co/merchant/create-customer \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"first_name": "Kingsley",
"last_name": "Doe",
"middle_name": "Doe",
"sum_sub": {
"userProvidedKey": "userProvidedValue"
},
"dob": "1981-10-22",
"id_document_base64": "AMTQA2iiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigD/2Q==",
"kyc_details": {
"phone_no": "+23313405943",
"country_of_residence": "NG",
"nationality": "NG",
"city": "lagos",
"state": "lagos",
"street": "no 1 Kings Street",
"zip": "120039",
"birth_place": "Victoria, NG",
"id_type": "national_id",
"id_number": "1111222000",
"date_onboarded": "2025-01-21",
"expiration_date": "2025-01-21",
"issued_date": "21.10.2021",
"issued_by": "NG",
"issued_country_code": "NG",
"tax_residency": "<string>"
}
}
'import requests
url = "https://flickopenapi.co/merchant/create-customer"
payload = {
"first_name": "Kingsley",
"last_name": "Doe",
"middle_name": "Doe",
"sum_sub": { "userProvidedKey": "userProvidedValue" },
"dob": "1981-10-22",
"id_document_base64": "AMTQA2iiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigD/2Q==",
"kyc_details": {
"phone_no": "+23313405943",
"country_of_residence": "NG",
"nationality": "NG",
"city": "lagos",
"state": "lagos",
"street": "no 1 Kings Street",
"zip": "120039",
"birth_place": "Victoria, NG",
"id_type": "national_id",
"id_number": "1111222000",
"date_onboarded": "2025-01-21",
"expiration_date": "2025-01-21",
"issued_date": "21.10.2021",
"issued_by": "NG",
"issued_country_code": "NG",
"tax_residency": "<string>"
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
first_name: 'Kingsley',
last_name: 'Doe',
middle_name: 'Doe',
sum_sub: {userProvidedKey: 'userProvidedValue'},
dob: '1981-10-22',
id_document_base64: 'AMTQA2iiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigD/2Q==',
kyc_details: {
phone_no: '+23313405943',
country_of_residence: 'NG',
nationality: 'NG',
city: 'lagos',
state: 'lagos',
street: 'no 1 Kings Street',
zip: '120039',
birth_place: 'Victoria, NG',
id_type: 'national_id',
id_number: '1111222000',
date_onboarded: '2025-01-21',
expiration_date: '2025-01-21',
issued_date: '21.10.2021',
issued_by: 'NG',
issued_country_code: 'NG',
tax_residency: '<string>'
}
})
};
fetch('https://flickopenapi.co/merchant/create-customer', 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://flickopenapi.co/merchant/create-customer",
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([
'first_name' => 'Kingsley',
'last_name' => 'Doe',
'middle_name' => 'Doe',
'sum_sub' => [
'userProvidedKey' => 'userProvidedValue'
],
'dob' => '1981-10-22',
'id_document_base64' => 'AMTQA2iiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigD/2Q==',
'kyc_details' => [
'phone_no' => '+23313405943',
'country_of_residence' => 'NG',
'nationality' => 'NG',
'city' => 'lagos',
'state' => 'lagos',
'street' => 'no 1 Kings Street',
'zip' => '120039',
'birth_place' => 'Victoria, NG',
'id_type' => 'national_id',
'id_number' => '1111222000',
'date_onboarded' => '2025-01-21',
'expiration_date' => '2025-01-21',
'issued_date' => '21.10.2021',
'issued_by' => 'NG',
'issued_country_code' => 'NG',
'tax_residency' => '<string>'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$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://flickopenapi.co/merchant/create-customer"
payload := strings.NewReader("{\n \"first_name\": \"Kingsley\",\n \"last_name\": \"Doe\",\n \"middle_name\": \"Doe\",\n \"sum_sub\": {\n \"userProvidedKey\": \"userProvidedValue\"\n },\n \"dob\": \"1981-10-22\",\n \"id_document_base64\": \"AMTQA2iiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigD/2Q==\",\n \"kyc_details\": {\n \"phone_no\": \"+23313405943\",\n \"country_of_residence\": \"NG\",\n \"nationality\": \"NG\",\n \"city\": \"lagos\",\n \"state\": \"lagos\",\n \"street\": \"no 1 Kings Street\",\n \"zip\": \"120039\",\n \"birth_place\": \"Victoria, NG\",\n \"id_type\": \"national_id\",\n \"id_number\": \"1111222000\",\n \"date_onboarded\": \"2025-01-21\",\n \"expiration_date\": \"2025-01-21\",\n \"issued_date\": \"21.10.2021\",\n \"issued_by\": \"NG\",\n \"issued_country_code\": \"NG\",\n \"tax_residency\": \"<string>\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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://flickopenapi.co/merchant/create-customer")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"first_name\": \"Kingsley\",\n \"last_name\": \"Doe\",\n \"middle_name\": \"Doe\",\n \"sum_sub\": {\n \"userProvidedKey\": \"userProvidedValue\"\n },\n \"dob\": \"1981-10-22\",\n \"id_document_base64\": \"AMTQA2iiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigD/2Q==\",\n \"kyc_details\": {\n \"phone_no\": \"+23313405943\",\n \"country_of_residence\": \"NG\",\n \"nationality\": \"NG\",\n \"city\": \"lagos\",\n \"state\": \"lagos\",\n \"street\": \"no 1 Kings Street\",\n \"zip\": \"120039\",\n \"birth_place\": \"Victoria, NG\",\n \"id_type\": \"national_id\",\n \"id_number\": \"1111222000\",\n \"date_onboarded\": \"2025-01-21\",\n \"expiration_date\": \"2025-01-21\",\n \"issued_date\": \"21.10.2021\",\n \"issued_by\": \"NG\",\n \"issued_country_code\": \"NG\",\n \"tax_residency\": \"<string>\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://flickopenapi.co/merchant/create-customer")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"first_name\": \"Kingsley\",\n \"last_name\": \"Doe\",\n \"middle_name\": \"Doe\",\n \"sum_sub\": {\n \"userProvidedKey\": \"userProvidedValue\"\n },\n \"dob\": \"1981-10-22\",\n \"id_document_base64\": \"AMTQA2iiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigD/2Q==\",\n \"kyc_details\": {\n \"phone_no\": \"+23313405943\",\n \"country_of_residence\": \"NG\",\n \"nationality\": \"NG\",\n \"city\": \"lagos\",\n \"state\": \"lagos\",\n \"street\": \"no 1 Kings Street\",\n \"zip\": \"120039\",\n \"birth_place\": \"Victoria, NG\",\n \"id_type\": \"national_id\",\n \"id_number\": \"1111222000\",\n \"date_onboarded\": \"2025-01-21\",\n \"expiration_date\": \"2025-01-21\",\n \"issued_date\": \"21.10.2021\",\n \"issued_by\": \"NG\",\n \"issued_country_code\": \"NG\",\n \"tax_residency\": \"<string>\"\n }\n}"
response = http.request(request)
puts response.read_body{
"status": 200,
"message": "Payer created successfully",
"payerId": "ehuf-47a1-89gg6-460bf99bd"
}API Reference
Create Customer
Creating a customer
POST
/
merchant
/
create-customer
Create Customer
curl --request POST \
--url https://flickopenapi.co/merchant/create-customer \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"first_name": "Kingsley",
"last_name": "Doe",
"middle_name": "Doe",
"sum_sub": {
"userProvidedKey": "userProvidedValue"
},
"dob": "1981-10-22",
"id_document_base64": "AMTQA2iiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigD/2Q==",
"kyc_details": {
"phone_no": "+23313405943",
"country_of_residence": "NG",
"nationality": "NG",
"city": "lagos",
"state": "lagos",
"street": "no 1 Kings Street",
"zip": "120039",
"birth_place": "Victoria, NG",
"id_type": "national_id",
"id_number": "1111222000",
"date_onboarded": "2025-01-21",
"expiration_date": "2025-01-21",
"issued_date": "21.10.2021",
"issued_by": "NG",
"issued_country_code": "NG",
"tax_residency": "<string>"
}
}
'import requests
url = "https://flickopenapi.co/merchant/create-customer"
payload = {
"first_name": "Kingsley",
"last_name": "Doe",
"middle_name": "Doe",
"sum_sub": { "userProvidedKey": "userProvidedValue" },
"dob": "1981-10-22",
"id_document_base64": "AMTQA2iiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigD/2Q==",
"kyc_details": {
"phone_no": "+23313405943",
"country_of_residence": "NG",
"nationality": "NG",
"city": "lagos",
"state": "lagos",
"street": "no 1 Kings Street",
"zip": "120039",
"birth_place": "Victoria, NG",
"id_type": "national_id",
"id_number": "1111222000",
"date_onboarded": "2025-01-21",
"expiration_date": "2025-01-21",
"issued_date": "21.10.2021",
"issued_by": "NG",
"issued_country_code": "NG",
"tax_residency": "<string>"
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
first_name: 'Kingsley',
last_name: 'Doe',
middle_name: 'Doe',
sum_sub: {userProvidedKey: 'userProvidedValue'},
dob: '1981-10-22',
id_document_base64: 'AMTQA2iiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigD/2Q==',
kyc_details: {
phone_no: '+23313405943',
country_of_residence: 'NG',
nationality: 'NG',
city: 'lagos',
state: 'lagos',
street: 'no 1 Kings Street',
zip: '120039',
birth_place: 'Victoria, NG',
id_type: 'national_id',
id_number: '1111222000',
date_onboarded: '2025-01-21',
expiration_date: '2025-01-21',
issued_date: '21.10.2021',
issued_by: 'NG',
issued_country_code: 'NG',
tax_residency: '<string>'
}
})
};
fetch('https://flickopenapi.co/merchant/create-customer', 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://flickopenapi.co/merchant/create-customer",
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([
'first_name' => 'Kingsley',
'last_name' => 'Doe',
'middle_name' => 'Doe',
'sum_sub' => [
'userProvidedKey' => 'userProvidedValue'
],
'dob' => '1981-10-22',
'id_document_base64' => 'AMTQA2iiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigD/2Q==',
'kyc_details' => [
'phone_no' => '+23313405943',
'country_of_residence' => 'NG',
'nationality' => 'NG',
'city' => 'lagos',
'state' => 'lagos',
'street' => 'no 1 Kings Street',
'zip' => '120039',
'birth_place' => 'Victoria, NG',
'id_type' => 'national_id',
'id_number' => '1111222000',
'date_onboarded' => '2025-01-21',
'expiration_date' => '2025-01-21',
'issued_date' => '21.10.2021',
'issued_by' => 'NG',
'issued_country_code' => 'NG',
'tax_residency' => '<string>'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$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://flickopenapi.co/merchant/create-customer"
payload := strings.NewReader("{\n \"first_name\": \"Kingsley\",\n \"last_name\": \"Doe\",\n \"middle_name\": \"Doe\",\n \"sum_sub\": {\n \"userProvidedKey\": \"userProvidedValue\"\n },\n \"dob\": \"1981-10-22\",\n \"id_document_base64\": \"AMTQA2iiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigD/2Q==\",\n \"kyc_details\": {\n \"phone_no\": \"+23313405943\",\n \"country_of_residence\": \"NG\",\n \"nationality\": \"NG\",\n \"city\": \"lagos\",\n \"state\": \"lagos\",\n \"street\": \"no 1 Kings Street\",\n \"zip\": \"120039\",\n \"birth_place\": \"Victoria, NG\",\n \"id_type\": \"national_id\",\n \"id_number\": \"1111222000\",\n \"date_onboarded\": \"2025-01-21\",\n \"expiration_date\": \"2025-01-21\",\n \"issued_date\": \"21.10.2021\",\n \"issued_by\": \"NG\",\n \"issued_country_code\": \"NG\",\n \"tax_residency\": \"<string>\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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://flickopenapi.co/merchant/create-customer")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"first_name\": \"Kingsley\",\n \"last_name\": \"Doe\",\n \"middle_name\": \"Doe\",\n \"sum_sub\": {\n \"userProvidedKey\": \"userProvidedValue\"\n },\n \"dob\": \"1981-10-22\",\n \"id_document_base64\": \"AMTQA2iiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigD/2Q==\",\n \"kyc_details\": {\n \"phone_no\": \"+23313405943\",\n \"country_of_residence\": \"NG\",\n \"nationality\": \"NG\",\n \"city\": \"lagos\",\n \"state\": \"lagos\",\n \"street\": \"no 1 Kings Street\",\n \"zip\": \"120039\",\n \"birth_place\": \"Victoria, NG\",\n \"id_type\": \"national_id\",\n \"id_number\": \"1111222000\",\n \"date_onboarded\": \"2025-01-21\",\n \"expiration_date\": \"2025-01-21\",\n \"issued_date\": \"21.10.2021\",\n \"issued_by\": \"NG\",\n \"issued_country_code\": \"NG\",\n \"tax_residency\": \"<string>\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://flickopenapi.co/merchant/create-customer")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"first_name\": \"Kingsley\",\n \"last_name\": \"Doe\",\n \"middle_name\": \"Doe\",\n \"sum_sub\": {\n \"userProvidedKey\": \"userProvidedValue\"\n },\n \"dob\": \"1981-10-22\",\n \"id_document_base64\": \"AMTQA2iiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigD/2Q==\",\n \"kyc_details\": {\n \"phone_no\": \"+23313405943\",\n \"country_of_residence\": \"NG\",\n \"nationality\": \"NG\",\n \"city\": \"lagos\",\n \"state\": \"lagos\",\n \"street\": \"no 1 Kings Street\",\n \"zip\": \"120039\",\n \"birth_place\": \"Victoria, NG\",\n \"id_type\": \"national_id\",\n \"id_number\": \"1111222000\",\n \"date_onboarded\": \"2025-01-21\",\n \"expiration_date\": \"2025-01-21\",\n \"issued_date\": \"21.10.2021\",\n \"issued_by\": \"NG\",\n \"issued_country_code\": \"NG\",\n \"tax_residency\": \"<string>\"\n }\n}"
response = http.request(request)
puts response.read_body{
"status": 200,
"message": "Payer created successfully",
"payerId": "ehuf-47a1-89gg6-460bf99bd"
}Authorizations
Your live or test secret key, prefixed sk-. Send as Authorization: Bearer sk-....
Body
application/json
Customer details
Example:
"Kingsley"
Example:
"Doe"
Example:
"Doe"
Show child attributes
Show child attributes
Example:
{ "userProvidedKey": "userProvidedValue" }
Example:
"1981-10-22"
max 5mb
Example:
"AMTQA2iiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigD/2Q=="
Show child attributes
Show child attributes