Post KYC Data Endpoint

This is used by merchants to submit their user's KYC data.

Use the endpoint below if you have already done KYC for your users. This endpoint to post their data to register them on Axis. Kindly note that, KYC is a one-time event.

POST https://exchanger-api.fuspay.finance/api/v1/no-auth/Axis/B2cUpdateUserKyc

Headers

Name	Type	Description
Authorization*	String	"Bearer ${partner_secret_key}"
x-partner-id*	String	"pxxxxxx"

Basic KYC Request Body

Name	Type	Description
kyc_type*	String	basic
email*	String	email of the user
phone*	String	phone number of the user
user_data*	Object	This is an object containing more data on the user
first_name	String	The users first name
last_name*	String	The user's last name
address*	String	The user's house address
phone	String	The user's phone number
email	String	The user's email
bvn	String	The user's BVN (Bank Verification Number). Only required for Nigeria
country_of_residence		The country of residence for there user
govt_id_no	String	The Number on a government approved ID like NIN
govt_id_photo	String	the url of the users government approved ID card
user_facial_images	Obejct	An object represeting the users series of facial images
image_1	String	url of the users image
image_1	String	URL of the users image

Sample Request

{
	"kyc_type": "basic",
	"email": "[e-mail]",
	"phone": "0900000000",
	"user_data": {
		
		"first_name": "John",
		"last_name": "Doe",
		"address": "John address",
		"phone": "0900000000",
		"email": "[e-mail]",
		"bvn": "123",
		"country_of_residence": "Nigeria",
		"govt_id_no": "A123",
		"govt_id_photo": "D-123",
		"user_facial_images": {
			"image_1": "url.png",
			"image_2": "url.png"
		}

		
	}
}

200: OK successful response

{
	"success": true,
	"message": "User Kyc data updated successfully",
	"data": {
		"kyc_token": "N2E1NzZiOTdhMzk0NjY4MTg5MjgyYzk3MjM3NmY1OWNhMWYyMTM5Nzk1YjE3YjYzZDU1YmY1YjUxMTRmMDU4Mw=="
	}
}

400: Bad Request failed responses

Extended KYC Request Body

Name	Type	Description
kyc_type*	String	extended
email*	String	email of the user
phone*	String	phone number of the user
extended_kyc_data*	Object	This is an object containing more data on the user for extended KYC
proof_of_address*	String	Utility bills & Lease agreement
bank_statement*	String	Recent Bank statement generated in the last 6 months
user_indemnity*	String	Duly signed Indemnity form. See below link to download Indemnity form
guarantors_form	String	Duly Filled & signed guarantor's form. See below link to download form
id_of_guarantor	String	Gov't issued ID (Passport, Driver's License or national ID)

Sample of Request Body

user_data = {
    "kyc_type":"extended",
    "phone": "",
    "email": "",
    "extended_kyc_data": {
        "proof_of_address": "",
        "bank_statement": "",
        "user_indemnity": "",
        "guarantors_form": "",
        "id_of_guarantor": "",
        "guarantors_proof_of_address": ""
    }

}

            

200: Ok Successful Response

Response {

}