Create Or Update A Customer
curl --request POST \
--url https://api.payaza.africa/live/payaza-account/api/v1/mainaccounts/merchant/customer \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <api-key>' \
--header 'X-TenantID: <api-key>' \
--data '
{
"customer_reference": "account_001",
"type": "individual",
"email": "johndoe@company.com",
"phone": "+2348012345679",
"country_code": "NG",
"address": {
"street": "123 Main Street",
"city": "Lagos",
"subdivision": "Lagos",
"postal_code": "100001",
"country_code": "NG"
},
"individual": {
"first_name": "John",
"last_name": "Doe",
"date_of_birth": "1990-01-15"
},
"identifications": [
{
"type": "PASSPORT",
"number": "A12345678",
"issuing_country": "NG",
"issued_on": "2020-01-15",
"expires_on": "2030-01-15"
},
{
"type": "TIN",
"number": "12345678-0001",
"issuing_country": "NG"
}
],
"documents": [
{
"type": "IDENTITY_DOCUMENT",
"side": "FRONT",
"url": "https://your-bucket.s3.amazonaws.com/kyc/john-doe-passport.png"
}
],
"account": [
"USD"
]
}
'import requests
url = "https://api.payaza.africa/live/payaza-account/api/v1/mainaccounts/merchant/customer"
payload = {
"customer_reference": "account_001",
"type": "individual",
"email": "johndoe@company.com",
"phone": "+2348012345679",
"country_code": "NG",
"address": {
"street": "123 Main Street",
"city": "Lagos",
"subdivision": "Lagos",
"postal_code": "100001",
"country_code": "NG"
},
"individual": {
"first_name": "John",
"last_name": "Doe",
"date_of_birth": "1990-01-15"
},
"identifications": [
{
"type": "PASSPORT",
"number": "A12345678",
"issuing_country": "NG",
"issued_on": "2020-01-15",
"expires_on": "2030-01-15"
},
{
"type": "TIN",
"number": "12345678-0001",
"issuing_country": "NG"
}
],
"documents": [
{
"type": "IDENTITY_DOCUMENT",
"side": "FRONT",
"url": "https://your-bucket.s3.amazonaws.com/kyc/john-doe-passport.png"
}
],
"account": ["USD"]
}
headers = {
"Authorization": "<api-key>",
"X-TenantID": "<api-key>",
"Idempotency-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
Authorization: '<api-key>',
'X-TenantID': '<api-key>',
'Idempotency-Key': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
customer_reference: 'account_001',
type: 'individual',
email: 'johndoe@company.com',
phone: '+2348012345679',
country_code: 'NG',
address: {
street: '123 Main Street',
city: 'Lagos',
subdivision: 'Lagos',
postal_code: '100001',
country_code: 'NG'
},
individual: {first_name: 'John', last_name: 'Doe', date_of_birth: '1990-01-15'},
identifications: [
{
type: 'PASSPORT',
number: 'A12345678',
issuing_country: 'NG',
issued_on: '2020-01-15',
expires_on: '2030-01-15'
},
{type: 'TIN', number: '12345678-0001', issuing_country: 'NG'}
],
documents: [
{
type: 'IDENTITY_DOCUMENT',
side: 'FRONT',
url: 'https://your-bucket.s3.amazonaws.com/kyc/john-doe-passport.png'
}
],
account: ['USD']
})
};
fetch('https://api.payaza.africa/live/payaza-account/api/v1/mainaccounts/merchant/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://api.payaza.africa/live/payaza-account/api/v1/mainaccounts/merchant/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([
'customer_reference' => 'account_001',
'type' => 'individual',
'email' => 'johndoe@company.com',
'phone' => '+2348012345679',
'country_code' => 'NG',
'address' => [
'street' => '123 Main Street',
'city' => 'Lagos',
'subdivision' => 'Lagos',
'postal_code' => '100001',
'country_code' => 'NG'
],
'individual' => [
'first_name' => 'John',
'last_name' => 'Doe',
'date_of_birth' => '1990-01-15'
],
'identifications' => [
[
'type' => 'PASSPORT',
'number' => 'A12345678',
'issuing_country' => 'NG',
'issued_on' => '2020-01-15',
'expires_on' => '2030-01-15'
],
[
'type' => 'TIN',
'number' => '12345678-0001',
'issuing_country' => 'NG'
]
],
'documents' => [
[
'type' => 'IDENTITY_DOCUMENT',
'side' => 'FRONT',
'url' => 'https://your-bucket.s3.amazonaws.com/kyc/john-doe-passport.png'
]
],
'account' => [
'USD'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>",
"Content-Type: application/json",
"Idempotency-Key: <api-key>",
"X-TenantID: <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.payaza.africa/live/payaza-account/api/v1/mainaccounts/merchant/customer"
payload := strings.NewReader("{\n \"customer_reference\": \"account_001\",\n \"type\": \"individual\",\n \"email\": \"johndoe@company.com\",\n \"phone\": \"+2348012345679\",\n \"country_code\": \"NG\",\n \"address\": {\n \"street\": \"123 Main Street\",\n \"city\": \"Lagos\",\n \"subdivision\": \"Lagos\",\n \"postal_code\": \"100001\",\n \"country_code\": \"NG\"\n },\n \"individual\": {\n \"first_name\": \"John\",\n \"last_name\": \"Doe\",\n \"date_of_birth\": \"1990-01-15\"\n },\n \"identifications\": [\n {\n \"type\": \"PASSPORT\",\n \"number\": \"A12345678\",\n \"issuing_country\": \"NG\",\n \"issued_on\": \"2020-01-15\",\n \"expires_on\": \"2030-01-15\"\n },\n {\n \"type\": \"TIN\",\n \"number\": \"12345678-0001\",\n \"issuing_country\": \"NG\"\n }\n ],\n \"documents\": [\n {\n \"type\": \"IDENTITY_DOCUMENT\",\n \"side\": \"FRONT\",\n \"url\": \"https://your-bucket.s3.amazonaws.com/kyc/john-doe-passport.png\"\n }\n ],\n \"account\": [\n \"USD\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "<api-key>")
req.Header.Add("X-TenantID", "<api-key>")
req.Header.Add("Idempotency-Key", "<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://api.payaza.africa/live/payaza-account/api/v1/mainaccounts/merchant/customer")
.header("Authorization", "<api-key>")
.header("X-TenantID", "<api-key>")
.header("Idempotency-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"customer_reference\": \"account_001\",\n \"type\": \"individual\",\n \"email\": \"johndoe@company.com\",\n \"phone\": \"+2348012345679\",\n \"country_code\": \"NG\",\n \"address\": {\n \"street\": \"123 Main Street\",\n \"city\": \"Lagos\",\n \"subdivision\": \"Lagos\",\n \"postal_code\": \"100001\",\n \"country_code\": \"NG\"\n },\n \"individual\": {\n \"first_name\": \"John\",\n \"last_name\": \"Doe\",\n \"date_of_birth\": \"1990-01-15\"\n },\n \"identifications\": [\n {\n \"type\": \"PASSPORT\",\n \"number\": \"A12345678\",\n \"issuing_country\": \"NG\",\n \"issued_on\": \"2020-01-15\",\n \"expires_on\": \"2030-01-15\"\n },\n {\n \"type\": \"TIN\",\n \"number\": \"12345678-0001\",\n \"issuing_country\": \"NG\"\n }\n ],\n \"documents\": [\n {\n \"type\": \"IDENTITY_DOCUMENT\",\n \"side\": \"FRONT\",\n \"url\": \"https://your-bucket.s3.amazonaws.com/kyc/john-doe-passport.png\"\n }\n ],\n \"account\": [\n \"USD\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.payaza.africa/live/payaza-account/api/v1/mainaccounts/merchant/customer")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["X-TenantID"] = '<api-key>'
request["Idempotency-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"customer_reference\": \"account_001\",\n \"type\": \"individual\",\n \"email\": \"johndoe@company.com\",\n \"phone\": \"+2348012345679\",\n \"country_code\": \"NG\",\n \"address\": {\n \"street\": \"123 Main Street\",\n \"city\": \"Lagos\",\n \"subdivision\": \"Lagos\",\n \"postal_code\": \"100001\",\n \"country_code\": \"NG\"\n },\n \"individual\": {\n \"first_name\": \"John\",\n \"last_name\": \"Doe\",\n \"date_of_birth\": \"1990-01-15\"\n },\n \"identifications\": [\n {\n \"type\": \"PASSPORT\",\n \"number\": \"A12345678\",\n \"issuing_country\": \"NG\",\n \"issued_on\": \"2020-01-15\",\n \"expires_on\": \"2030-01-15\"\n },\n {\n \"type\": \"TIN\",\n \"number\": \"12345678-0001\",\n \"issuing_country\": \"NG\"\n }\n ],\n \"documents\": [\n {\n \"type\": \"IDENTITY_DOCUMENT\",\n \"side\": \"FRONT\",\n \"url\": \"https://your-bucket.s3.amazonaws.com/kyc/john-doe-passport.png\"\n }\n ],\n \"account\": [\n \"USD\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"message": "Customer processed",
"status": true,
"retry_count": 0,
"data": {
"id": 15,
"customer_reference": "account_001",
"type": "individual",
"name": "John Doe",
"status": "UNDER_REVIEW",
"requirements": [],
"registrations": [
{
"provider_reference": "01a1e843-b041-7384-8649-430c0e7abc30",
"provisioning": "ON_REQUEST",
"status": "UNDER_REVIEW",
"programs": [
{
"currencies": [
"USD"
],
"status": "UNDER_REVIEW",
"provider_status": "PENDING",
"requirements": []
}
],
"documents": [
{
"type": "IDENTITY_DOCUMENT",
"side": "FRONT",
"status": "UPLOADED",
"file_name": "1774864420319-pocketapp.png"
}
]
}
],
"accounts": [
{
"id": 8,
"account_reference": "primary",
"currency": "USD",
"status": "PENDING",
"payment_instructions": [],
"message": "Waiting for the customer to become ACTIVE"
}
],
"identifications": [
{
"type": "PASSPORT",
"issuing_country": "NG",
"last4": "1511",
"expires_on": "2030-01-15"
}
]
}
}{
"code": "VALIDATION_ERROR",
"message": "customer_reference is required",
"status": false,
"retry_count": 0
}{
"code": "IDEMPOTENCY_CONFLICT",
"message": "Idempotency-Key was already used for a different request",
"status": false,
"retry_count": 0
}vIBANS
Create Or Update A Customer
This endpoint registers a new customer and requests virtual accounts in a single API call. The customer can be an individual or a business.
Notes:
- Kindly note that IP whitelisting is required for your requests.
- Sending the same
customer_referenceagain updates the existing customer rather than creating a new customer record. This can be used, for example, to submit additional information or provide a missing document during the verification process. - Store
data.idandcustomer_referenceagainst the merchant’s customer record. - If the customer status is
ACTION_REQUIRED, retrieve the outstanding items inrequirements[]and submit the missing information using the samecustomer_reference. - If the customer status is
UNDER_REVIEW, wait for the verification process to complete and periodically retrieve the customer’s status using the Get Customer endpoint. date_of_birth, identificationnumber, andissued_onare accepted in the request but are not echoed back in the response.
POST
/
payaza-account
/
api
/
v1
/
mainaccounts
/
merchant
/
customer
Create Or Update A Customer
curl --request POST \
--url https://api.payaza.africa/live/payaza-account/api/v1/mainaccounts/merchant/customer \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <api-key>' \
--header 'X-TenantID: <api-key>' \
--data '
{
"customer_reference": "account_001",
"type": "individual",
"email": "johndoe@company.com",
"phone": "+2348012345679",
"country_code": "NG",
"address": {
"street": "123 Main Street",
"city": "Lagos",
"subdivision": "Lagos",
"postal_code": "100001",
"country_code": "NG"
},
"individual": {
"first_name": "John",
"last_name": "Doe",
"date_of_birth": "1990-01-15"
},
"identifications": [
{
"type": "PASSPORT",
"number": "A12345678",
"issuing_country": "NG",
"issued_on": "2020-01-15",
"expires_on": "2030-01-15"
},
{
"type": "TIN",
"number": "12345678-0001",
"issuing_country": "NG"
}
],
"documents": [
{
"type": "IDENTITY_DOCUMENT",
"side": "FRONT",
"url": "https://your-bucket.s3.amazonaws.com/kyc/john-doe-passport.png"
}
],
"account": [
"USD"
]
}
'import requests
url = "https://api.payaza.africa/live/payaza-account/api/v1/mainaccounts/merchant/customer"
payload = {
"customer_reference": "account_001",
"type": "individual",
"email": "johndoe@company.com",
"phone": "+2348012345679",
"country_code": "NG",
"address": {
"street": "123 Main Street",
"city": "Lagos",
"subdivision": "Lagos",
"postal_code": "100001",
"country_code": "NG"
},
"individual": {
"first_name": "John",
"last_name": "Doe",
"date_of_birth": "1990-01-15"
},
"identifications": [
{
"type": "PASSPORT",
"number": "A12345678",
"issuing_country": "NG",
"issued_on": "2020-01-15",
"expires_on": "2030-01-15"
},
{
"type": "TIN",
"number": "12345678-0001",
"issuing_country": "NG"
}
],
"documents": [
{
"type": "IDENTITY_DOCUMENT",
"side": "FRONT",
"url": "https://your-bucket.s3.amazonaws.com/kyc/john-doe-passport.png"
}
],
"account": ["USD"]
}
headers = {
"Authorization": "<api-key>",
"X-TenantID": "<api-key>",
"Idempotency-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
Authorization: '<api-key>',
'X-TenantID': '<api-key>',
'Idempotency-Key': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
customer_reference: 'account_001',
type: 'individual',
email: 'johndoe@company.com',
phone: '+2348012345679',
country_code: 'NG',
address: {
street: '123 Main Street',
city: 'Lagos',
subdivision: 'Lagos',
postal_code: '100001',
country_code: 'NG'
},
individual: {first_name: 'John', last_name: 'Doe', date_of_birth: '1990-01-15'},
identifications: [
{
type: 'PASSPORT',
number: 'A12345678',
issuing_country: 'NG',
issued_on: '2020-01-15',
expires_on: '2030-01-15'
},
{type: 'TIN', number: '12345678-0001', issuing_country: 'NG'}
],
documents: [
{
type: 'IDENTITY_DOCUMENT',
side: 'FRONT',
url: 'https://your-bucket.s3.amazonaws.com/kyc/john-doe-passport.png'
}
],
account: ['USD']
})
};
fetch('https://api.payaza.africa/live/payaza-account/api/v1/mainaccounts/merchant/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://api.payaza.africa/live/payaza-account/api/v1/mainaccounts/merchant/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([
'customer_reference' => 'account_001',
'type' => 'individual',
'email' => 'johndoe@company.com',
'phone' => '+2348012345679',
'country_code' => 'NG',
'address' => [
'street' => '123 Main Street',
'city' => 'Lagos',
'subdivision' => 'Lagos',
'postal_code' => '100001',
'country_code' => 'NG'
],
'individual' => [
'first_name' => 'John',
'last_name' => 'Doe',
'date_of_birth' => '1990-01-15'
],
'identifications' => [
[
'type' => 'PASSPORT',
'number' => 'A12345678',
'issuing_country' => 'NG',
'issued_on' => '2020-01-15',
'expires_on' => '2030-01-15'
],
[
'type' => 'TIN',
'number' => '12345678-0001',
'issuing_country' => 'NG'
]
],
'documents' => [
[
'type' => 'IDENTITY_DOCUMENT',
'side' => 'FRONT',
'url' => 'https://your-bucket.s3.amazonaws.com/kyc/john-doe-passport.png'
]
],
'account' => [
'USD'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>",
"Content-Type: application/json",
"Idempotency-Key: <api-key>",
"X-TenantID: <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.payaza.africa/live/payaza-account/api/v1/mainaccounts/merchant/customer"
payload := strings.NewReader("{\n \"customer_reference\": \"account_001\",\n \"type\": \"individual\",\n \"email\": \"johndoe@company.com\",\n \"phone\": \"+2348012345679\",\n \"country_code\": \"NG\",\n \"address\": {\n \"street\": \"123 Main Street\",\n \"city\": \"Lagos\",\n \"subdivision\": \"Lagos\",\n \"postal_code\": \"100001\",\n \"country_code\": \"NG\"\n },\n \"individual\": {\n \"first_name\": \"John\",\n \"last_name\": \"Doe\",\n \"date_of_birth\": \"1990-01-15\"\n },\n \"identifications\": [\n {\n \"type\": \"PASSPORT\",\n \"number\": \"A12345678\",\n \"issuing_country\": \"NG\",\n \"issued_on\": \"2020-01-15\",\n \"expires_on\": \"2030-01-15\"\n },\n {\n \"type\": \"TIN\",\n \"number\": \"12345678-0001\",\n \"issuing_country\": \"NG\"\n }\n ],\n \"documents\": [\n {\n \"type\": \"IDENTITY_DOCUMENT\",\n \"side\": \"FRONT\",\n \"url\": \"https://your-bucket.s3.amazonaws.com/kyc/john-doe-passport.png\"\n }\n ],\n \"account\": [\n \"USD\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "<api-key>")
req.Header.Add("X-TenantID", "<api-key>")
req.Header.Add("Idempotency-Key", "<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://api.payaza.africa/live/payaza-account/api/v1/mainaccounts/merchant/customer")
.header("Authorization", "<api-key>")
.header("X-TenantID", "<api-key>")
.header("Idempotency-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"customer_reference\": \"account_001\",\n \"type\": \"individual\",\n \"email\": \"johndoe@company.com\",\n \"phone\": \"+2348012345679\",\n \"country_code\": \"NG\",\n \"address\": {\n \"street\": \"123 Main Street\",\n \"city\": \"Lagos\",\n \"subdivision\": \"Lagos\",\n \"postal_code\": \"100001\",\n \"country_code\": \"NG\"\n },\n \"individual\": {\n \"first_name\": \"John\",\n \"last_name\": \"Doe\",\n \"date_of_birth\": \"1990-01-15\"\n },\n \"identifications\": [\n {\n \"type\": \"PASSPORT\",\n \"number\": \"A12345678\",\n \"issuing_country\": \"NG\",\n \"issued_on\": \"2020-01-15\",\n \"expires_on\": \"2030-01-15\"\n },\n {\n \"type\": \"TIN\",\n \"number\": \"12345678-0001\",\n \"issuing_country\": \"NG\"\n }\n ],\n \"documents\": [\n {\n \"type\": \"IDENTITY_DOCUMENT\",\n \"side\": \"FRONT\",\n \"url\": \"https://your-bucket.s3.amazonaws.com/kyc/john-doe-passport.png\"\n }\n ],\n \"account\": [\n \"USD\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.payaza.africa/live/payaza-account/api/v1/mainaccounts/merchant/customer")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["X-TenantID"] = '<api-key>'
request["Idempotency-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"customer_reference\": \"account_001\",\n \"type\": \"individual\",\n \"email\": \"johndoe@company.com\",\n \"phone\": \"+2348012345679\",\n \"country_code\": \"NG\",\n \"address\": {\n \"street\": \"123 Main Street\",\n \"city\": \"Lagos\",\n \"subdivision\": \"Lagos\",\n \"postal_code\": \"100001\",\n \"country_code\": \"NG\"\n },\n \"individual\": {\n \"first_name\": \"John\",\n \"last_name\": \"Doe\",\n \"date_of_birth\": \"1990-01-15\"\n },\n \"identifications\": [\n {\n \"type\": \"PASSPORT\",\n \"number\": \"A12345678\",\n \"issuing_country\": \"NG\",\n \"issued_on\": \"2020-01-15\",\n \"expires_on\": \"2030-01-15\"\n },\n {\n \"type\": \"TIN\",\n \"number\": \"12345678-0001\",\n \"issuing_country\": \"NG\"\n }\n ],\n \"documents\": [\n {\n \"type\": \"IDENTITY_DOCUMENT\",\n \"side\": \"FRONT\",\n \"url\": \"https://your-bucket.s3.amazonaws.com/kyc/john-doe-passport.png\"\n }\n ],\n \"account\": [\n \"USD\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"message": "Customer processed",
"status": true,
"retry_count": 0,
"data": {
"id": 15,
"customer_reference": "account_001",
"type": "individual",
"name": "John Doe",
"status": "UNDER_REVIEW",
"requirements": [],
"registrations": [
{
"provider_reference": "01a1e843-b041-7384-8649-430c0e7abc30",
"provisioning": "ON_REQUEST",
"status": "UNDER_REVIEW",
"programs": [
{
"currencies": [
"USD"
],
"status": "UNDER_REVIEW",
"provider_status": "PENDING",
"requirements": []
}
],
"documents": [
{
"type": "IDENTITY_DOCUMENT",
"side": "FRONT",
"status": "UPLOADED",
"file_name": "1774864420319-pocketapp.png"
}
]
}
],
"accounts": [
{
"id": 8,
"account_reference": "primary",
"currency": "USD",
"status": "PENDING",
"payment_instructions": [],
"message": "Waiting for the customer to become ACTIVE"
}
],
"identifications": [
{
"type": "PASSPORT",
"issuing_country": "NG",
"last4": "1511",
"expires_on": "2030-01-15"
}
]
}
}{
"code": "VALIDATION_ERROR",
"message": "customer_reference is required",
"status": false,
"retry_count": 0
}{
"code": "IDEMPOTENCY_CONFLICT",
"message": "Idempotency-Key was already used for a different request",
"status": false,
"retry_count": 0
}Authorizations
Scopes
Body
application/json
Response
Initiate Payment Successful Response
The response is of type any.