Skip to main content
monei.business provides methods to manage business customers under a specific business ID. With this service, you can:
  • Create a business customer
  • Retrieve all business customers
  • Get customer details
  • Update a customer
  • Disable a customer
Note: All methods return response objects with attributes accessible via dot notation (e.g., customer.id, customers.data).

​
Create Business Customer

Create a new customer under a specific business. 
business_id = "your-business-id"

customer = monei.business.create_business_customer(
    business_id,
    first_name="John",
    last_name="Doe",
    email="john@example.com",
    phone_number="+2348012345678"
)

print(customer)

​
Get Business Customers

Retrieve all customers associated with a business. 
business_id = "your-business-id"

customers = monei.business.get_business_customers(
    business_id
)

print(customers)

​
Get Customer Details

Retrieve detailed information about a specific customer. 
business_id = "your-business-id"
customer_id = "customer-id"

customer = monei.business.get_customer_details(
    business_id,
    customer_id
)

print(customer)

​
Update Customer

Update an existing customer’s information. 
business_id = "your-business-id"
customer_id = "customer-id"

updated_customer = monei.business.update_customer(
    business_id,
    customer_id,
    first_name="Jane",
    last_name="Doe",
    email="jane@example.com"
)

print(updated_customer)

​
Disable Customer

Disable a customer under a business. 
business_id = "your-business-id"
customer_id = "customer-id"

response = monei.business.disable_customer(
    business_id,
    customer_id
)

print(response)

​
Working with Response Objects

All methods return objects with attribute access: 
# Create customer response
customer = monei.business.create_business_customer(
    business_id,
    first_name="John",
    last_name="Doe",
    email="john@example.com",
    phone_number="+2348012345678"
)
print(customer.id)           # Customer ID
print(customer.first_name)   # First name
print(customer.last_name)    # Last name
print(customer.email)        # Email address
print(customer.phone_number) # Phone number
print(customer.status)       # Customer status
print(customer.created_at)   # Creation date

# Get business customers response
customers = monei.business.get_business_customers(business_id)
for customer in customers.data:
    print(customer.id)           # Customer ID
    print(customer.first_name)   # First name
    print(customer.last_name)    # Last name
    print(customer.email)        # Email address
    print(customer.phone_number) # Phone number
    print(customer.status)       # Customer status
print(customers.pagination)      # Pagination info
print(customers.pagination.total)     # Total count
print(customers.pagination.page)      # Current page
print(customers.pagination.limit)     # Items per page

# Get customer details response
customer = monei.business.get_customer_details(business_id, customer_id)
print(customer.id)           # Customer ID
print(customer.first_name)   # First name
print(customer.last_name)    # Last name
print(customer.email)        # Email address
print(customer.phone_number) # Phone number
print(customer.status)       # Customer status
print(customer.created_at)   # Creation date
print(customer.updated_at)   # Last update date

# Update customer response
updated_customer = monei.business.update_customer(
    business_id,
    customer_id,
    first_name="Jane",
    last_name="Doe",
    email="jane@example.com"
)
print(updated_customer.id)         # Customer ID
print(updated_customer.first_name) # Updated first name
print(updated_customer.last_name)  # Updated last name
print(updated_customer.email)      # Updated email
print(updated_customer.updated_at) # Update timestamp

# Disable customer response
response = monei.business.disable_customer(business_id, customer_id)
print(response.message)      # Success message
print(response.customer_id)  # Disabled customer ID
print(response.status)       # New status

​
Response Types

​
BusinessCustomerDto

{
    "id": str,
    "first_name": str,
    "last_name": str,
    "email": str,
    "phone_number": str,
    "status": "active" | "disabled",
    "created_at": str,
    "updated_at": str
}

​
BusinessCustomersListDto

{
    "data": [BusinessCustomerDto],
    "pagination": {
        "total": int,
        "page": int,
        "limit": int,
        "total_pages": int
    }
}

​
DisableCustomerResponseDto

{
    "message": str,
    "customer_id": str,
    "status": "disabled"
}

​
Error Handling

All business service calls may raise an exception if the request fails. 
from monei import MoneiError

try:
    customer = monei.business.create_business_customer(
        business_id,
        first_name="John",
        last_name="Doe",
        email="john@example.com",
        phone_number="+2348012345678"
    )
    print(customer.id)
except MoneiError as err:
    print(err.status_code)  # HTTP status code
    print(err.message)      # Error message
    print(err.code)         # Error code

​
Service Overview

MethodDescription
create_business_customer(business_id, first_name, last_name, email, phone_number)Create a new business customer
get_business_customers(business_id)Retrieve all business customers
get_customer_details(business_id, customer_id)Get customer details
update_customer(business_id, customer_id, first_name, last_name, email)Update customer information
disable_customer(business_id, customer_id)Disable a customer

​
Notes

  • All methods require a valid business_id
  • A properly configured MoneiClient instance is required
  • Ensure authentication headers are set before making requests
  • All responses are strongly typed objects with attribute access
  • Disabled customers cannot perform transactions until re-enabled