How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Zoho Inventory Customer Payments API

Customer-Payments Module

Zoho Inventory Customer Payments API is one of 37 APIs that Zoho Inventory publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 1 JSON Schema definition.

Tagged areas include Customer Payments. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 1 JSON Schema.

This API exposes 6 operations across 3 paths, and defines 47 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

Requests are made against a single base URL, https://www.zohoapis.com/inventory/v1.

6 operations 3 paths 47 schemas 1 DELETE2 GET1 POST2 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Base URL
https://www.zohoapis.com/inventory/v1
Authentication
OAuth 2.0
Resource Areas
1

Authentication & Security 1

Zoho Inventory Customer Payments API declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (Zoho_Auth) using the implicit flow, exposing 4 scopes.

Paths & Operations 6

Across 3 paths, the API surfaces 6 operations — 1 DELETE, 2 GET, 1 POST, 2 PUT. Each is listed below with its method, path, parameters, and response codes.

Customer Payments 6

Customer-Payments Module

POST
/customerpayments
Create a payment
create_customer_payment 1 param body → 201
GET
/customerpayments
List Customer Payments
list_customer_payments 12 params → 200
PUT
/customerpayment/{customer_payment_id}/customfields
Update custom field in existing customerpayments
update_custom_field_in_customer_payment 2 params body → 200
PUT
/customerpayments/{payment_id}
Update a payment
update_customer_payment 2 params body → 200
GET
/customerpayments/{payment_id}
Retrieve a payment
retrieve_customer_payment 2 params → 200
DELETE
/customerpayments/{payment_id}
Delete a payment
delete_customer_payment 2 params → 200

Schemas 47

The contract defines 47 schemas that model the data the API accepts and returns. The most detailed are payment-response (27 properties), create-a-payment-request (14 properties), update-a-payment-request (14 properties), list-customer-payments-response (3 properties). Each schema is shown below with its type and property counts.

update-a-payment-response
object
3 properties
update-an-customerpayment-customfield-response
object
2 properties
amount_refunded
number
Amount that is refunded. Refunds are applicable only for payments whose paymentmode is autotransaction . Refunds would be made to the respective card provided…
custom_fields_update
array
Custom fields for an payments.
account_name
string
Name of the cash/ bank account the payment has to be deposited.
invoice_amount
number
Total amount raised for the invoice.
exchange_rate
number
Exchange rate for the currency used in the invoices and customer's currency. The payment amount would be the multiplicative product of the original amount and…
account_id
string
ID of the cash/ bank account the payment has to be deposited.
create-a-payment-request
object
14 properties 4 required
amount_applied
number
Amount paid for the invoice.
value
string
Value of the custom field.
index
integer
Index of the custom field. It can hold any value from 1 to 10.
description
string
Description about the payment.
status
string
Status of the payment. It can either be success or failure .
payment-response
object
Payment details of the transaction
27 properties
bank_charges
number
Denotes any additional bank charges.
location_name
string
Name of the location.
customer_name
string
Name of the customer to whom the invoice is raised. Maximum length [100]
data_type
string
Data type of the custom field.
retrieve-a-payment-response
object
3 properties
amount
number
Amount paid in the respective payment.
currency_code
string
Currency code in which the payment is made.
payment_number
string
Number for the payment.
invoice_number
string
Unique ID (starts with INV) of an invoice.
customer_id
string
Customer ID of the customer involved in the payment.
last_four_digits
integer
Last four digits of the card.
currency_symbol
string
Customer's currency symbol.
invoice_id
string
Invoice ID of the required invoice.
update-a-payment-request
object
14 properties 4 required
payment_mode
string
Mode through which payment is made. This can be check , cash , creditcard , banktransfer , bankremittance , autotransaction or others . Maximum length [100]
create-a-payment-response
object
3 properties
balance_amount
number
Unpaid amount of the invoice.
tax_account_name
string
Name of the tax account, in case of withholding tax.
currency_id
string
ID of the currency used in the payment
list-customer-payments-response
object
3 properties
payment_form
string
Mode of Vendor Payment
payment_id
string
Unique ID of the payment generated by the server. Maximum length allowed [2000]
unused_amount
number
Amount which is not used for invoice payment yet.
reference_number
string
Reference number generated for the payment. A string of your choice can also be used as the reference number. Maximum length of the reference number [100]
location_id
string
Location ID
tax_amount_withheld
number
Amount withheld for tax.
email
string
Email address of the customer involved in the payment.
label
string
Label of the custom field.
date
string
Date on which payment is made. Date Format [yyyy-mm-dd]
delete-a-payment-response
object
2 properties
tax_account_id
string
ID of the tax account, in case of withholding tax.
bcy_amount
string

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

zoho-inventory-customer-payments-api-openapi.yml Raw ↑

Other APIs Zoho Inventory publishes across the network.

Zoho Inventory Batches API
Zoho Inventory Bills API
Zoho Inventory Compositeitems API
Zoho Inventory Contact Persons API
Zoho Inventory Contacts API
Zoho Inventory Credit Notes API
Zoho Inventory Currency API
Zoho Inventory Delivery Challans API
Zoho Inventory Inventoryadjustments API
Zoho Inventory Invoices API
Zoho Inventory Items API
Zoho Inventory Landedcosts API
Where this information came from

This is an independent, third-party profile of Zoho Inventory Customer Payments API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.