Customer Enrollment & KYC

Get Customer

Retrieve a customer's full profile and current KYC status by their customer id.

GET /v1/customer/{customer_id}

Request

Path Parameters

Parameter	Type	Required	Description
`customer_id`	string	✅	Customer ID returned from enrollment

Code Samples

const axios = require("axios");

const customer_id= "42feffe9-d625-412e-bfa5-2f3089a11735";

const response = await axios.get(
  `https://sandbox.hitchpay.ng/v1/customer/${customer_id}`,
  {
    headers: {
      Authorization: `Bearer ${process.env.ACCESS_TOKEN}`
    }
  }
);

console.log(response.data);

<?php

$uuid = "42feffe9-d625-412e-bfa5-2f3089a11735";

$ch = curl_init();

curl_setopt_array($ch, [
  CURLOPT_URL => "https://sandbox.hitchpay.ng/v1/customer/{$uuid}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer YOUR_ACCESS_TOKEN"
  ]
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;

import requests

uuid = "42feffe9-d625-412e-bfa5-2f3089a11735"

url = f"https://sandbox.hitchpay.ng/v1/customer/{uuid}"

headers = {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN"
}

response = requests.get(url, headers=headers)
print(response.json())

Response

200 — Success

{
  "status": "success",
  "message": "Customer retrieved successfully.",
  "data": {
    "customer_id": "337d8159-c684-4c44-b977-daa3d0c7f55c",
    "customerid": "CUST_001",
    "firstname": "Olajide",
    "lastname": "Olamide",
    "email": "[email protected]",
    "phone": "07068363556",
    "nationality": "NG",
    "dob": "12-04-1990",
    "kyc_status": "approved",
    "address": {
      "house_no": 2,
      "street": "12 Victoria Island Road",
      "city": "Lagos",
      "state": "Lagos",
      "postal_code": "100001",
      "country": "NG"
    }
  }
}

Questions? Email [email protected]. Also on GitBook.