- EnKash Developer Portal Overview
- Payment Gateway
- Payment Gateway Overview
- Payment Gateway Sign Up
- Payment Methods
- Supported Integrations
- Payment Gateway APIs
- Web Integration
- Server to Server Integration
- Test Card Details
- Authorization
- Orders
- Payments
- Refunds
- Settlements
- Split Settlements
- E-Commerce Plugins
- Payment Links
- Payment Button
- Qr Code
- UPI Mandate
- Payment Links
- Bharat Connect (BBPS)
- About Bharat Connect
- B2B Invoicing
- Invoice
- Payment
- Financing
- Onboarding
- cdNote
- Purchase Order
- webhook-invoice
- webhook-payments
- webhook-business-onboarding
- webhook-financing
- webhook-cdNote
- Webhook Purchase Order
- Webhook Send Purchase Order RequestPOST
- Webhook Send Purchase Order ResponsePOST
- Webhook Confirm Purchase Order RequestPOST
- Webhook Confirm Purchase Order ResponsePOST
- Webhook Edit Purchase Order RequestPOST
- Webhook Edit Purchase Order ResponsePOST
- Webhook Status Change Purchase Order RequestPOST
- Webhook Status Change Purchase Order ResponsePOST
- Bill Payments
- Bill Payments Overview
- Get Authentication TokenPOST
- Get BillerTypesGET
- Get BillersGET
- Fetch BillPOST
- Create Bill APIPOST
- Create Bill Without Bill FetchPOST
- Bill PaymentPOST
- Utility Bill Approval APIPUT
- Get Utility Bill StatusGET
- Get Utility Bill by Reference IdGET
- Get Utility Bills DetailPOST
- Bill Payment WebhookPOST
- Payouts
- Payouts Overview
- Payouts Sign Up
- Payout Methods
- Payout API Response Codes
- Payouts Integration Steps
- Encrypting and Decrypting Payload
- Payouts Status Codes
- Get Authentication Token
- Beneficiary Apis
- Transfer Apis
- Payout Account Apis
- Webhook Data Apis
- Accounts Payable Management Tool
- About AP Management Tool
- Vendor Management
- Invoice Management
- Bharat Connect 2.0 AP
- Update BeneficiaryPUT
- Account Receivable
- Accounts Receivable Overview
- Get Authentication Token Copy
- Customer Management
- Customer Contacts Management
- Customer Apis
- Invoice Management
- Payment Reminders
- Bharat Connect 2.0 AR
- Expense Management
- Loyalty
- Card Management
- EnKash Card Management Systems Overview
- Cards We Issue
- API Reference
- VKYC
- Developer Guide
- Cards Integration Steps
- Encryption / Decryption of API requests / Response
- Encryption & Decryption Guide
- Token Api
- Gift Card
- Meal Cards
- Prepaid Cards
- Fuel_cards
- Advance Card Feature
- Verification Suite
- Verification Suite Overview
- Bank Account Verification
- GSTN Verification
- PAN Verification
- UPI(VPA) Verification
Update Bulk Vendors
PUT
/api/v0/beneficiary/bulk
Beneficiary Apis
Request
Query Params
companyOnBoardType
enum<string>Â
optional
Allowed values:
CUSTOMERBENEFICIARY
Body Params application/json
array of:
emails
array[string]
optional
beneficiaryFailureReason
stringÂ
optional
remarks
stringÂ
optional
userGroupIds
array[string]
optional
recurringInvoiceDate
integer <int32>
optional
>= 1<= 31
recurringInvoice
booleanÂ
optional
recurringInvoiceAmount
numberÂ
optional
>= 0.01<= 450000000
panId
integer <int64>
optional
gstinId
integer <int64>
optional
cinId
integer <int64>
optional
enterpriseType
stringÂ
optional
enterpriseSubType
stringÂ
optional
externalUniqueId
stringÂ
optional
>= 0 characters<= 255 characters
pricingPlanId
stringÂ
optional
msmeRegistrationDate
string <date>
optional
acquiringBank
enum<string>Â
optional
Allowed values:
AXIS_BANKCITI_BANKHSBC_BANKHDFC_BANKSBIINDUSIND_BANKKOTAK_MAHINDRA_BANKRBL_BANKRAZORPAYICICI_BANKYES_BANKENKASHSBM_BANKPOS_MACHINE
acquiredBy
stringÂ
optional
typeOfCustomer
enum<string>Â
optional
Allowed values:
ON_USOFF_USCAPOS_MACHINE
utilityReferenceId
stringÂ
optional
companySize
enum<string>Â
optional
Allowed values:
TEN_PLUSTWENTY_FIVE_PLUSFIFTY_PLUSHUNDRED_PLUSTWO_HUNDRED_PLUSFIVE_HUNDRED_PLUSONE_THOUSAND_PLUS
additionalData
objectÂ
optional
Additional properties
stringÂ
optional
extRefCompanyId
stringÂ
optional
whatsappOtp
booleanÂ
optional
msme
booleanÂ
optional
parent_id
stringÂ
optional
company_id
stringÂ
optional
legal_name
stringÂ
optional
business_type
enum<string>Â
optional
Allowed values:
ENTERPRISECREDIT_PROVIDERVENDORSOCIETYAGENCY
company_type
stringÂ
optional
tax_id_one
stringÂ
optional
tax_id_two
stringÂ
optional
website
stringÂ
optional
cin
stringÂ
optional
din
stringÂ
optional
external_ref_no
stringÂ
optional
address_line_one
stringÂ
optional
address_line_two
stringÂ
optional
city
stringÂ
optional
state
stringÂ
optional
country
stringÂ
optional
pin
stringÂ
optional
phone
stringÂ
optional
bank_account_number
stringÂ
optional
ifsc
stringÂ
optional
bank_name
stringÂ
optional
branch_name
stringÂ
optional
account_type
enum<string>Â
optional
Allowed values:
CURRENTSAVINGSNONE
logo
stringÂ
optional
category
enum<string>Â
optional
Allowed values:
ABCDTAUTILITYFUELIATAOTHERSRENTALKASHFLOQUICK_RENT_PAY
din2
stringÂ
optional
checksum
stringÂ
optional
communication_switch
booleanÂ
optional
risk_approval_status
enum<string>Â
optional
Allowed values:
APPROVEDPENDINGIN_PROGRESSBULK_UPLOADNEW
penny_verification_amount
numberÂ
optional
pg
array[object (PgModel) {10}]Â
optional
pg_name
stringÂ
optional
pg_code
stringÂ
optional
pg_display_name
stringÂ
optional
pg_priority
integer <int32>
optional
surcharge
numberÂ
optional
surcharge_gst
numberÂ
optional
mdr
numberÂ
optional
mdr_gst
numberÂ
optional
category
stringÂ
optional
payout_cycle
enum<string>Â
optional
Allowed values:
T0T1T2T3
bt_surcharge
numberÂ
optional
source_region
stringÂ
optional
source_person
stringÂ
optional
source_city
stringÂ
optional
override_rate
booleanÂ
optional
program_admin_name
stringÂ
optional
bankrate
numberÂ
optional
cc_limit
numberÂ
optional
billing_cycle
integer <int32>
optional
payout_cycle
enum<string>Â
optional
Allowed values:
T0T1T2T3
status
enum<string>Â
optional
Allowed values:
ACTIVEINACTIVEBLOCKEDLOCKED
branch_codes
array[string]
optional
Example
Request samples
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PUT 'https://test.your-api-server.com/api/v0/beneficiary/bulk?companyOnBoardType' \
--header 'Content-Type: application/json' \
--data-raw ''
Responses
🟢200OK
application/json
Body
response_code
integer <int32>
optional
response_message
stringÂ
optional
payload
objectÂ
optional
Additional properties
object (CompanyModel)Â
optional
Example
{
"response_code": 0,
"response_message": "string",
"payload": {
"property1": {
"kycDetailsSubmitted": true,
"bankDetailVerified": true,
"city": "string",
"state": "string",
"country": "string",
"pin": "string",
"emails": [
"string"
],
"phone": "string",
"status": "ACTIVE",
"ifsc": "string",
"logo": "string",
"parentPhone": "string",
"parentCompanyId": "string",
"category": "A",
"bankRate": 0,
"kycDocumentData": {
"panModel": {
"pan": "string",
"status": "UNVERIFIED",
"name": "string",
"firstName": "string",
"middleName": "string",
"lastName": "string",
"failureReason": "string",
"id": 0,
"dob": "string"
},
"gstinModel": {
"gstin": "string",
"status": "UNVERIFIED",
"legalNameOfBusiness": "string",
"tradeName": "string",
"companyName": "string",
"centreJurisdiction": "string",
"stateJurisdiction": "string",
"dateOfRegistration": "2019-08-24",
"constitutionOfBusiness": "string",
"taxPayerType": "string",
"gstinStatus": "string",
"dateOfCancellation": "2019-08-24",
"dateOfLastUpdated": "2019-08-24",
"natureOfBusinessActivities": [
"string"
],
"natureOfBusinessActivitiesString": "string",
"proprietors": [
"string"
],
"division": "string",
"segment": "string",
"subSegment": "string",
"fieldVisitConducted": "string",
"address": "string",
"email": "string",
"mobile": "string",
"id": 0,
"aggregateTurnovers": [
{
"turnover": "string",
"financialYear": "string"
}
],
"aggregateTurnover": "string",
"aggregateTurnoverFinancialYear": "string",
"aadhaarAuthenticated": true,
"transactionDelays": [
{
"returnYearMonth": "string",
"revisedDueDateOfFiling": "string",
"dateOfFiling": "string",
"noOfDaysOfDelay": 0,
"returnType": "string",
"arn": "string"
}
],
"parsedName": "string",
"pinCode": "string",
"pan": "string",
"vintageInYears": 0,
"vintageInMonths": 0
},
"cinModel": {
"cin": "string",
"status": "UNVERIFIED",
"companyName": "string",
"listed": "string",
"companyStatus": "string",
"rocId": "string",
"rocCode": "string",
"registrationNumber": "string",
"companyCategory": "string",
"companySubCategory": "string",
"classOfCompany": "string",
"authorisedCapital": 0,
"paidUpCapital": 0,
"numberOfMembers": "string",
"dateOfIncorporation": "2019-08-24",
"registeredAddress": "string",
"email": "string",
"suspendedAtStockExchange": "string",
"dateOfBalanceSheet": "2019-08-24",
"dateOfLastAgm": "2019-08-24",
"directors": [
{
"din": "string",
"name": "string",
"designation": "string",
"dateOfAppointment": "2019-08-24T14:15:22Z",
"dscRegistered": "string",
"dscExpiryDate": "string",
"address": "string",
"dateOfBirth": "2019-08-24T14:15:22Z",
"fatherName": "string"
}
]
}
},
"documents": [
"INVOICE"
],
"branchCodes": "string",
"approvals": "string",
"payableVirtualAccount": "string",
"payableVirtualIfsc": "string",
"bankDetails": [
{
"id": 0,
"bankDetailId": "string",
"beneficiaryCode": "string",
"accountNumber": "string",
"ifsc": "string",
"bankName": "string",
"beneficiaryName": "string",
"nodalAddition": true,
"primaryBankDetail": true,
"approved": true,
"whitelisted": true,
"whitelistDeleted": true,
"createdOn": "2019-08-24T14:15:22Z",
"modifiedOn": "2019-08-24T14:15:22Z"
}
],
"beneficiaryCode": "string",
"pgNameOfCP": "string",
"address": "string",
"bankDetailId": "string",
"userGroups": [
{
"userGroupId": "string",
"company": {},
"userGroupName": "string",
"users": [
"string"
],
"createdBy": "string",
"modifiedBy": "string"
}
],
"billPayAgency": "MK",
"recurringInvoiceDate": 0,
"recurringInvoiceNextDate": "2019-08-24",
"recurringInvoice": true,
"recurringInvoiceAmount": 0,
"utmSource": "string",
"enterpriseType": "string",
"enterpriseSubType": "string",
"pricingPlan": {
"pricingPlanId": "string",
"planName": "string"
},
"warnings": [
"string"
],
"externalUniqueId": "string",
"msmeRegistrationDate": "2019-08-24",
"failureReason": "string",
"partnerId": "string",
"acquiringBank": {
"name": {},
"label": "string",
"description": "string",
"subModels": [
{}
],
"minValue": 0,
"maxValue": 0
},
"acquiredBy": "string",
"typeOfCustomer": {
"name": {},
"label": "string",
"description": "string",
"subModels": [
{}
],
"minValue": 0,
"maxValue": 0
},
"utilityReferenceId": "string",
"sendPaymentAdvice": true,
"dealId": "string",
"primaryChannel": "string",
"primaryProductCategory": "string",
"primaryProduct": "string",
"companySize": {
"name": {},
"label": "string",
"description": "string",
"subModels": [
{}
],
"minValue": 0,
"maxValue": 0
},
"bankApprovalStatus": "APPROVED",
"kycFailureReason": [
"string"
],
"additionalData": {
"property1": "string",
"property2": "string"
},
"extRefCompanyId": "string",
"outstandingAmount": 0,
"msme": true,
"parent_id": "string",
"company_id": "string",
"legal_name": "string",
"business_type": "ENTERPRISE",
"company_type": "string",
"tax_id_one": "string",
"tax_id_two": "string",
"website": "string",
"cin": "string",
"din": "string",
"external_ref_no": "string",
"source_region": "string",
"source_person": "string",
"source_city": "string",
"risk_approval_status": "APPROVED",
"created_date": "string",
"approved_date": "string",
"approved_by": "string",
"modified_by": "string",
"modified_date": "string",
"address_line_one": "string",
"address_line_two": "string",
"bank_account_number": "string",
"bank_name": "string",
"branch_name": "string",
"account_type": "CURRENT",
"payout_cycle": "T0",
"pg": [
{
"pg_name": "string",
"pg_code": "string",
"pg_display_name": "string",
"pg_priority": 0,
"surcharge": 0,
"surcharge_gst": 0,
"mdr": 0,
"mdr_gst": 0,
"category": "string",
"payout_cycle": "T0"
}
],
"prepaid_balance": 0,
"company_logo": "string",
"parent_email": "string",
"parent_legal_name": "string",
"bt_surcharge": 0,
"override_rate": true,
"program_admin_name": "string",
"cc_limit": 0,
"billing_cycle": 0,
"communication_switch": true,
"penny_drop_data": {
"amount": 0,
"remarks": "string",
"rrn": "string",
"status": "string",
"bankName": "string",
"id": 0,
"transaction_id": "string",
"request_type": "string",
"beneficiary_account_number": "string",
"beneficiary_ifsc": "string",
"beneficiary_name": "string",
"response_code": "string",
"response_reason": "string"
},
"penny_flag": true,
"state_code": "string",
"name_matching_score": 0,
"proprietor_name_matching_type": "NONE",
"proprietor_name_match_count": 0,
"auto_approved": true,
"available_category_limit": 0,
"nbbl_b2b_id": "string"
},
"property2": {
"kycDetailsSubmitted": true,
"bankDetailVerified": true,
"city": "string",
"state": "string",
"country": "string",
"pin": "string",
"emails": [
"string"
],
"phone": "string",
"status": "ACTIVE",
"ifsc": "string",
"logo": "string",
"parentPhone": "string",
"parentCompanyId": "string",
"category": "A",
"bankRate": 0,
"kycDocumentData": {
"panModel": {
"pan": "string",
"status": "UNVERIFIED",
"name": "string",
"firstName": "string",
"middleName": "string",
"lastName": "string",
"failureReason": "string",
"id": 0,
"dob": "string"
},
"gstinModel": {
"gstin": "string",
"status": "UNVERIFIED",
"legalNameOfBusiness": "string",
"tradeName": "string",
"companyName": "string",
"centreJurisdiction": "string",
"stateJurisdiction": "string",
"dateOfRegistration": "2019-08-24",
"constitutionOfBusiness": "string",
"taxPayerType": "string",
"gstinStatus": "string",
"dateOfCancellation": "2019-08-24",
"dateOfLastUpdated": "2019-08-24",
"natureOfBusinessActivities": [
"string"
],
"natureOfBusinessActivitiesString": "string",
"proprietors": [
"string"
],
"division": "string",
"segment": "string",
"subSegment": "string",
"fieldVisitConducted": "string",
"address": "string",
"email": "string",
"mobile": "string",
"id": 0,
"aggregateTurnovers": [
{
"turnover": "string",
"financialYear": "string"
}
],
"aggregateTurnover": "string",
"aggregateTurnoverFinancialYear": "string",
"aadhaarAuthenticated": true,
"transactionDelays": [
{
"returnYearMonth": "string",
"revisedDueDateOfFiling": "string",
"dateOfFiling": "string",
"noOfDaysOfDelay": 0,
"returnType": "string",
"arn": "string"
}
],
"parsedName": "string",
"pinCode": "string",
"pan": "string",
"vintageInYears": 0,
"vintageInMonths": 0
},
"cinModel": {
"cin": "string",
"status": "UNVERIFIED",
"companyName": "string",
"listed": "string",
"companyStatus": "string",
"rocId": "string",
"rocCode": "string",
"registrationNumber": "string",
"companyCategory": "string",
"companySubCategory": "string",
"classOfCompany": "string",
"authorisedCapital": 0,
"paidUpCapital": 0,
"numberOfMembers": "string",
"dateOfIncorporation": "2019-08-24",
"registeredAddress": "string",
"email": "string",
"suspendedAtStockExchange": "string",
"dateOfBalanceSheet": "2019-08-24",
"dateOfLastAgm": "2019-08-24",
"directors": [
{
"din": "string",
"name": "string",
"designation": "string",
"dateOfAppointment": "2019-08-24T14:15:22Z",
"dscRegistered": "string",
"dscExpiryDate": "string",
"address": "string",
"dateOfBirth": "2019-08-24T14:15:22Z",
"fatherName": "string"
}
]
}
},
"documents": [
"INVOICE"
],
"branchCodes": "string",
"approvals": "string",
"payableVirtualAccount": "string",
"payableVirtualIfsc": "string",
"bankDetails": [
{
"id": 0,
"bankDetailId": "string",
"beneficiaryCode": "string",
"accountNumber": "string",
"ifsc": "string",
"bankName": "string",
"beneficiaryName": "string",
"nodalAddition": true,
"primaryBankDetail": true,
"approved": true,
"whitelisted": true,
"whitelistDeleted": true,
"createdOn": "2019-08-24T14:15:22Z",
"modifiedOn": "2019-08-24T14:15:22Z"
}
],
"beneficiaryCode": "string",
"pgNameOfCP": "string",
"address": "string",
"bankDetailId": "string",
"userGroups": [
{
"userGroupId": "string",
"company": {},
"userGroupName": "string",
"users": [
"string"
],
"createdBy": "string",
"modifiedBy": "string"
}
],
"billPayAgency": "MK",
"recurringInvoiceDate": 0,
"recurringInvoiceNextDate": "2019-08-24",
"recurringInvoice": true,
"recurringInvoiceAmount": 0,
"utmSource": "string",
"enterpriseType": "string",
"enterpriseSubType": "string",
"pricingPlan": {
"pricingPlanId": "string",
"planName": "string"
},
"warnings": [
"string"
],
"externalUniqueId": "string",
"msmeRegistrationDate": "2019-08-24",
"failureReason": "string",
"partnerId": "string",
"acquiringBank": {
"name": {},
"label": "string",
"description": "string",
"subModels": [
{}
],
"minValue": 0,
"maxValue": 0
},
"acquiredBy": "string",
"typeOfCustomer": {
"name": {},
"label": "string",
"description": "string",
"subModels": [
{}
],
"minValue": 0,
"maxValue": 0
},
"utilityReferenceId": "string",
"sendPaymentAdvice": true,
"dealId": "string",
"primaryChannel": "string",
"primaryProductCategory": "string",
"primaryProduct": "string",
"companySize": {
"name": {},
"label": "string",
"description": "string",
"subModels": [
{}
],
"minValue": 0,
"maxValue": 0
},
"bankApprovalStatus": "APPROVED",
"kycFailureReason": [
"string"
],
"additionalData": {
"property1": "string",
"property2": "string"
},
"extRefCompanyId": "string",
"outstandingAmount": 0,
"msme": true,
"parent_id": "string",
"company_id": "string",
"legal_name": "string",
"business_type": "ENTERPRISE",
"company_type": "string",
"tax_id_one": "string",
"tax_id_two": "string",
"website": "string",
"cin": "string",
"din": "string",
"external_ref_no": "string",
"source_region": "string",
"source_person": "string",
"source_city": "string",
"risk_approval_status": "APPROVED",
"created_date": "string",
"approved_date": "string",
"approved_by": "string",
"modified_by": "string",
"modified_date": "string",
"address_line_one": "string",
"address_line_two": "string",
"bank_account_number": "string",
"bank_name": "string",
"branch_name": "string",
"account_type": "CURRENT",
"payout_cycle": "T0",
"pg": [
{
"pg_name": "string",
"pg_code": "string",
"pg_display_name": "string",
"pg_priority": 0,
"surcharge": 0,
"surcharge_gst": 0,
"mdr": 0,
"mdr_gst": 0,
"category": "string",
"payout_cycle": "T0"
}
],
"prepaid_balance": 0,
"company_logo": "string",
"parent_email": "string",
"parent_legal_name": "string",
"bt_surcharge": 0,
"override_rate": true,
"program_admin_name": "string",
"cc_limit": 0,
"billing_cycle": 0,
"communication_switch": true,
"penny_drop_data": {
"amount": 0,
"remarks": "string",
"rrn": "string",
"status": "string",
"bankName": "string",
"id": 0,
"transaction_id": "string",
"request_type": "string",
"beneficiary_account_number": "string",
"beneficiary_ifsc": "string",
"beneficiary_name": "string",
"response_code": "string",
"response_reason": "string"
},
"penny_flag": true,
"state_code": "string",
"name_matching_score": 0,
"proprietor_name_matching_type": "NONE",
"proprietor_name_match_count": 0,
"auto_approved": true,
"available_category_limit": 0,
"nbbl_b2b_id": "string"
}
}
}
Modified at 2025-03-05 05:38:32