Create a Tier 1 session
curl --request POST \
--url https://api.daya.co/v1/customers/{id}/tier1-verification/sessions \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--header 'X-Api-Key: <x-api-key>' \
--data '
{
"bvn": "<string>",
"notice_version": "<string>",
"phone_number": "<string>",
"bank_account": {}
}
'import requests
url = "https://api.daya.co/v1/customers/{id}/tier1-verification/sessions"
payload = {
"bvn": "<string>",
"notice_version": "<string>",
"phone_number": "<string>",
"bank_account": {}
}
headers = {
"X-Api-Key": "<x-api-key>",
"Idempotency-Key": "<idempotency-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'X-Api-Key': '<x-api-key>',
'Idempotency-Key': '<idempotency-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
bvn: '<string>',
notice_version: '<string>',
phone_number: '<string>',
bank_account: {}
})
};
fetch('https://api.daya.co/v1/customers/{id}/tier1-verification/sessions', 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://api.daya.co/v1/customers/{id}/tier1-verification/sessions",
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([
'bvn' => '<string>',
'notice_version' => '<string>',
'phone_number' => '<string>',
'bank_account' => [
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"Idempotency-Key: <idempotency-key>",
"X-Api-Key: <x-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://api.daya.co/v1/customers/{id}/tier1-verification/sessions"
payload := strings.NewReader("{\n \"bvn\": \"<string>\",\n \"notice_version\": \"<string>\",\n \"phone_number\": \"<string>\",\n \"bank_account\": {}\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Api-Key", "<x-api-key>")
req.Header.Add("Idempotency-Key", "<idempotency-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://api.daya.co/v1/customers/{id}/tier1-verification/sessions")
.header("X-Api-Key", "<x-api-key>")
.header("Idempotency-Key", "<idempotency-key>")
.header("Content-Type", "application/json")
.body("{\n \"bvn\": \"<string>\",\n \"notice_version\": \"<string>\",\n \"phone_number\": \"<string>\",\n \"bank_account\": {}\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.daya.co/v1/customers/{id}/tier1-verification/sessions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-Api-Key"] = '<x-api-key>'
request["Idempotency-Key"] = '<idempotency-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"bvn\": \"<string>\",\n \"notice_version\": \"<string>\",\n \"phone_number\": \"<string>\",\n \"bank_account\": {}\n}"
response = http.request(request)
puts response.read_bodyCustomers
Create a Tier 1 session
Start a hosted BVN and live selfie verification session
POST
/
v1
/
customers
/
{id}
/
tier1-verification
/
sessions
Create a Tier 1 session
curl --request POST \
--url https://api.daya.co/v1/customers/{id}/tier1-verification/sessions \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--header 'X-Api-Key: <x-api-key>' \
--data '
{
"bvn": "<string>",
"notice_version": "<string>",
"phone_number": "<string>",
"bank_account": {}
}
'import requests
url = "https://api.daya.co/v1/customers/{id}/tier1-verification/sessions"
payload = {
"bvn": "<string>",
"notice_version": "<string>",
"phone_number": "<string>",
"bank_account": {}
}
headers = {
"X-Api-Key": "<x-api-key>",
"Idempotency-Key": "<idempotency-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'X-Api-Key': '<x-api-key>',
'Idempotency-Key': '<idempotency-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
bvn: '<string>',
notice_version: '<string>',
phone_number: '<string>',
bank_account: {}
})
};
fetch('https://api.daya.co/v1/customers/{id}/tier1-verification/sessions', 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://api.daya.co/v1/customers/{id}/tier1-verification/sessions",
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([
'bvn' => '<string>',
'notice_version' => '<string>',
'phone_number' => '<string>',
'bank_account' => [
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"Idempotency-Key: <idempotency-key>",
"X-Api-Key: <x-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://api.daya.co/v1/customers/{id}/tier1-verification/sessions"
payload := strings.NewReader("{\n \"bvn\": \"<string>\",\n \"notice_version\": \"<string>\",\n \"phone_number\": \"<string>\",\n \"bank_account\": {}\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Api-Key", "<x-api-key>")
req.Header.Add("Idempotency-Key", "<idempotency-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://api.daya.co/v1/customers/{id}/tier1-verification/sessions")
.header("X-Api-Key", "<x-api-key>")
.header("Idempotency-Key", "<idempotency-key>")
.header("Content-Type", "application/json")
.body("{\n \"bvn\": \"<string>\",\n \"notice_version\": \"<string>\",\n \"phone_number\": \"<string>\",\n \"bank_account\": {}\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.daya.co/v1/customers/{id}/tier1-verification/sessions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-Api-Key"] = '<x-api-key>'
request["Idempotency-Key"] = '<idempotency-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"bvn\": \"<string>\",\n \"notice_version\": \"<string>\",\n \"phone_number\": \"<string>\",\n \"bank_account\": {}\n}"
response = http.request(request)
puts response.read_bodyStart a session for an existing customer. Access requires the liveness permission on a Business API key. Set up your API key, then follow the guide to send the customer to capture and read the result.
Authentication and parameters
A stable key for this Create request. If the result is uncertain, reuse the same key and request body.
Request body
Omit this field for new integrations. Daya selects the current notice, which the customer accepts on the hosted page. Existing callers can continue sending the current version.
Optional Nigerian bank account belonging to the customer. Include
account_number and bank_code together with phone_number.Response
202 Accepted returns a session, not an approval. Save id and follow next_action. When it is capture, the response includes capture.capture_url and capture.expires_at. Get the session status to check the result.
A 404 Not Found can mean the customer is not active or is not available to your merchant.
A 409 IDENTITY_CONFLICT means a different customer under the same merchant already owns the BVN. A plain 409 CONFLICT requires checking the customer’s existing verification or session before trying again.