Customers

The Customers API allows you create and manage customers on your integration.

Create customer

Create a customer on your integration. Below is an example using cURL:

Request payload

Name

Type

Description

first_name

string

The first name of the customer. Must be a valid name and cannot contain special characters.

last_name

string

The last name of the customer. This field must not be empty and should only contain letters.

mobile_number

string

The mobile number of the customer. Should be in international format, e.g., +2348123456789.

string

The email address of the customer. Must be a valid email format (e.g., user@example.com).

address

string

The physical address of the customer. This helps in verification processes.

nin

string

The National Identification Number (NIN) of the customer. This is used for government identity verification.

bvn

string

The Bank Verification Number (BVN) of the customer. Required for financial transactions.

channel

string

The transaction channel for the customer (e.g., fiat). Defines the payment method or currency system.

currency

string

The currency type the customer operates with. Supported currencies: {ngn,usd,kes,cad}.


const myHeaders = new Headers();
myHeaders.append("Bearer token",
 "lGIZjxxn0j6o664sC7trToMaiTUIz6kFzf633f68i4hkyjFsl1U4WGHWsgNXdxMg");
myHeaders.append("Content-Type", "application/json");

const raw = JSON.stringify({
  "first_name": "abdul",
  "last_name": "qudus",
  "mobile_number": "08185348318",
  "email": "kola@gmail.com",
  "address": "lekki phase 2",
  "nin": "8647382948",
  "bvn": "7345267287",
  "channel": "fiat",
  "currency": "ngn"
});

const requestOptions = {
  method: "POST",
  headers: myHeaders,
  body: raw,
  redirect: "follow"
};

fetch("https://api.switch.tulupay.com/customer", requestOptions)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.error(error));

All the informations above are required

Request details

Endpoint:`https://api.switch.tulupay.com/v1/customer/add`

Method:`POST`

Headers:

Content-Type:`application/json`

Authorization:`Bearer token`

Response details

A successful response will contain a JSON array with user details. Here's a simplified example:


  {
    "statusCode": "00",
    "status": "successful",
    "message": "User created successful",
    "data": {
        "account": {
            "user_id": "ce463f4d-2dfc-4bfd-a67a-386762350a7d",
            "channel": "fiat",
            "currency": "ngn",
            "bankname": "WEMA",
            "full_name": "abdul qudus",
            "voucher_id": "8924481652",
            "last_balance": 0,
            "current_balance": 0,
            "status": "3"
        },
        "wallet": {
            "statusCode": "00",
            "AccountId": "0xb8be05e791e931f8f4a27bc641f80f427b1b065f"
        }
    }
}

Error

All customers.

On this page

Create customer Request details Response details

Contact our dedicated developer support team for assistance, guidance, or any questions you have regarding Tuluswitch API integration. We're here to ensure your development experience is smooth and successful.

Read Our Developer FAQ for Insights

Master the Tuluswitch API with our Developer Blog! Get expert insights, advanced tips, and industry trends beyond the documentation. Stay connected with the developer community to build exceptional payment platforms. Visit the blog now and unlock your full potential!