Enkash Developer Portal
Home
Home
Login
  1. Financing
  • Back to home
  • Vendor Payment
  • APIs
    • Business Onboarding
      • Initiate Entity Check
      • Register Entity
      • Bharat Connect B2B ID Registration
      • Search Entity
    • Invoice
      • Create Invoice
      • Confirm Invoice
      • Change Invoice Status
      • Edit Invoice
    • Payment
      • Pay Invoice
      • Payment Confirmation
    • Purchase Order
      • Send Purchase Order Request
      • Confirm Purchase Order
      • Edit Purchase Order
      • Change Purchase Order Status
    • Credit Note
      • Send C/N Request
      • Confirm C/N Request
      • Status Change C/N Request
    • Financing
      • Request Financing
        POST
      • Share Bid
        POST
      • Respond To Bid
        POST
  • Webhook
    • Business Onboarding
      • Check Entity Webhook
      • Entity Registration Response Webhook
      • Search Entity Response Webhook
      • Registration ID Response Webhook
    • Invoice
      • Create Invoice Request Webhook
      • Create Invoice Response Webhook
      • Confirm Invoice Request Webhook
      • Confirm Invoice Response Webhook
      • Status Change Invoice Request
      • Status Change Invoice Response Webhook
      • Edit Invoice Request Webhook
      • Edit Invoice Response Webhook
    • Payment
      • Payment Response Webhook
      • Payment Confirmation Response Webhook
      • Payment Request Webhook
      • Payment Confirmation Request Webhook
    • Credit Note
      • Send C/N RequestWebhook
      • Send C/N Response Webhook
      • Confirm C/N Request Webhook
      • Confirm C/N Response Webhook
      • Status Change C/N Request Webhook
      • Status Change C/N Response Webhook
    • Purchase Order
      • Send Purchase Order Request Webhook
      • Send Purchase Order Response Webhook
      • Confirm Purchase Order Request Webhook
      • Confirm Purchase Order Response Webhook
      • Edit Purchase Order Request Webhook
      • Edit Purchase Order Response Webhook
      • Status Change Purchase Order Request Webhook
      • Status Change Purchase Order Response Webhook
    • Financing
      • Financing Response Webhook
      • Respond Bid Response Webhook
      • Share Bid Request Webhook
  1. Financing

Request Financing

POST
/api/v0/finance/req-financing
📌
Use this API to initiate a financing request from your EnKash account to the Bharat Connect platform.
This allows you to apply for short-term credit or working capital against your eligible invoices or purchase orders, helping you improve cash flow and manage your operational expenses more efficiently.

Request

Body Params application/json
initiatorEntity
string 
required
b2bIds
object 
required
buyerB2BId
string 
required
supplierB2BId
string 
required
device
object 
required
tag
object 
required
financeRequest
object 
required
initiatorB2BId
string 
required
financingRequestId
string 
required
financeId
array [object {2}] 
required
b2bPAN
object 
required
costOfFundBearer
string 
required
financingRequestAmount
integer 
required
financingType
string 
required
invoices
array [object {27}] 
required
Example
{
    "initiatorEntity": "string",
    "b2bIds": {
        "buyerB2BId": "string",
        "supplierB2BId": "string"
    },
    "device": {
        "tag": {
            "name": "GEOCODE",
            "value": "string"
        }
    },
    "financeRequest": {
        "initiatorB2BId": "string",
        "financingRequestId": "string",
        "financeId": [
            {
                "faId": "string",
                "financierId": [
                    "string"
                ]
            }
        ],
        "b2bPAN": {
            "buyerPAN": "string",
            "supplierPAN": "string"
        },
        "costOfFundBearer": "string",
        "financingRequestAmount": 0,
        "financingType": "string",
        "invoices": [
            {
                "objectId": "string",
                "supplierInvoiceNumber": "string",
                "objectVersion": {
                    "currentVersion": 0,
                    "newVersion": 0
                },
                "ts": "string",
                "statusTransition": {
                    "currentStatus": "CREATED",
                    "newStatus": "CREATED"
                },
                "transactionDetails": {
                    "taxScheme": "string",
                    "supplyType": "string",
                    "reverseChargeTax": "string",
                    "igstChargable": "string",
                    "ecommerceGstin": "string"
                },
                "supplierDetails": {
                    "b2bId": "string",
                    "gstin": "string",
                    "legalName": "string",
                    "tradeName": "string",
                    "stateCode": "string",
                    "address": {
                        "type": "string",
                        "addressLine1": "string",
                        "addressLine2": "string",
                        "city": "string",
                        "state": "string",
                        "country": "string",
                        "pincode": "string"
                    },
                    "contactNumber": {
                        "type": "string",
                        "countryCode": "string",
                        "phoneNumber": "string"
                    },
                    "email": "string"
                },
                "buyerDetails": {
                    "b2bId": "string",
                    "gstin": "string",
                    "legalName": "string",
                    "tradeName": "string",
                    "stateCode": "string",
                    "placeOfSupply": "string",
                    "address": {
                        "type": "string",
                        "addressLine1": "string",
                        "addressLine2": "string",
                        "city": "string",
                        "state": "string",
                        "country": "string",
                        "pincode": "string"
                    },
                    "contactNumber": {
                        "type": "string",
                        "countryCode": "string",
                        "phoneNumber": "string"
                    },
                    "email": "string"
                },
                "dispatchDetails": {
                    "gstin": "string",
                    "legalName": "string",
                    "tradeName": "string",
                    "stateCode": "string",
                    "address": {
                        "type": "string",
                        "addressLine1": "string",
                        "addressLine2": "string",
                        "city": "string",
                        "state": "string",
                        "country": "string",
                        "pincode": "string"
                    },
                    "contactNumber": {
                        "type": "string",
                        "countryCode": "string",
                        "phoneNumber": "string"
                    },
                    "email": "string"
                },
                "shippingDetails": {
                    "gstin": "string",
                    "lglNm": "string",
                    "trdNm": "string",
                    "stateCode": "string",
                    "address": {
                        "type": "string",
                        "addressLine1": "string",
                        "addressLine2": "string",
                        "city": "string",
                        "state": "string",
                        "country": "string",
                        "pincode": "string"
                    },
                    "contactNumber": {
                        "type": "string",
                        "countryCode": "string",
                        "phoneNumber": "string"
                    },
                    "email": "string"
                },
                "itemLists": [
                    {
                        "serialno": "string",
                        "productDescription": "string",
                        "isService": "string",
                        "hsnCode": "string",
                        "barCode": "string",
                        "quantity": 0,
                        "freeQuantity": 0,
                        "unit": "string",
                        "unitPrice": 0,
                        "totalAmt": 0,
                        "assessmentAmount": 0,
                        "gstRate": 0,
                        "totalItemValue": 0,
                        "orderLineReference": "string",
                        "originCountry": "string",
                        "productSerialNumber": "string",
                        "itemValueDetails": [
                            {
                                "type": "string",
                                "value": 0
                            }
                        ],
                        "rates": [
                            {
                                "type": "string",
                                "value": 0
                            }
                        ],
                        "batchDetails": {
                            "batchNumber": "string",
                            "expiryDate": "string",
                            "batchWarrantyDate": "string"
                        },
                        "attributeDetails": [
                            {
                                "name": "string",
                                "value": "string"
                            }
                        ],
                        "otherTaxes": [
                            {
                                "name": "string",
                                "rate": 0,
                                "amount": 0
                            }
                        ]
                    }
                ],
                "valueDetails": {
                    "assessmentValue": 0,
                    "totalInvoiceValue": 0,
                    "otherValues": [
                        {
                            "type": "string",
                            "value": 0
                        }
                    ]
                },
                "supplierBankAccountDetails": {
                    "maskedAccountNumber": "string",
                    "ifsc": "string",
                    "beneficiaryName": "string",
                    "businessVPA": "string"
                },
                "advancePaymentDetails": {
                    "payeeName": "string",
                    "mode": "string",
                    "paymentTerms": "string",
                    "paymentInstruction": "string",
                    "creditTransfer": "string",
                    "directDebit": "string",
                    "creditDays": 0,
                    "paidAmount": 0,
                    "pendingDueAmount": 0
                },
                "invoiceReferenceDetails": {
                    "invoiceRemarks": "string",
                    "invoiceStartDate": "string",
                    "invoiceEndDate": "string"
                },
                "precedingInvoiceDetails": [
                    {
                        "invoiceNumber": "string",
                        "date": "string",
                        "otherReferenceNo": "string"
                    }
                ],
                "poDetails": [
                    {
                        "poObjId": "string",
                        "buyerPoId": "string",
                        "poDate": "string"
                    }
                ],
                "contractReferenceDetails": [
                    {
                        "receiptAdviceNo": "string",
                        "receiptAdviceDate": "string",
                        "batchReferenceNo": "string",
                        "contractReferenceNo": "string",
                        "extraReferenceNo": "string",
                        "projectReferenceNo": "string"
                    }
                ],
                "additionalDocumentDetails": [
                    {
                        "url": "string",
                        "document": "string",
                        "info": "string"
                    }
                ],
                "exportDetails": {
                    "shipBillNo": "string",
                    "shipBillDate": "string",
                    "port": "string",
                    "refundClaim": "string",
                    "foreignCurrency": "string",
                    "countryCode": "string",
                    "exportDuty": 0
                },
                "ewayBillDetail": {
                    "transporterId": "string",
                    "transporterName": "string",
                    "transportMode": "string",
                    "distance": 0,
                    "transportDocumentNo": "string",
                    "transportDocumentDate": "string",
                    "vehicleNo": "string",
                    "vehicleType": "string"
                },
                "recurringPayments": {
                    "originalInvoiceId": "string",
                    "frequency": "string",
                    "startDate": "string",
                    "endDate": "string",
                    "mandateDetails": "string",
                    "mandateExecutionDate": "string",
                    "mandateAmount": 0
                },
                "paymentMilestones": [
                    {
                        "milestoneDate": "string",
                        "dueAmount": 0
                    }
                ],
                "shippingTermsDetails": {
                    "terms": "string",
                    "bearingParty": "string",
                    "charges": 0
                },
                "invoiceFinancingDetails": {
                    "dueAmount": 0,
                    "financingRequestAmount": 0
                },
                "einvoiceResponse": "string",
                "eInvoiceInfo": {
                    "schemaVersion": "string",
                    "irnNumber": "string",
                    "irnTs": "string"
                }
            }
        ]
    }
}

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 POST '/api/v0/finance/req-financing' \
--header 'Content-Type: application/json' \
--data-raw '{
    "initiatorEntity": "string",
    "b2bIds": {
        "buyerB2BId": "string",
        "supplierB2BId": "string"
    },
    "device": {
        "tag": {
            "name": "GEOCODE",
            "value": "string"
        }
    },
    "financeRequest": {
        "initiatorB2BId": "string",
        "financingRequestId": "string",
        "financeId": [
            {
                "faId": "string",
                "financierId": [
                    "string"
                ]
            }
        ],
        "b2bPAN": {
            "buyerPAN": "string",
            "supplierPAN": "string"
        },
        "costOfFundBearer": "string",
        "financingRequestAmount": 0,
        "financingType": "string",
        "invoices": [
            {
                "objectId": "string",
                "supplierInvoiceNumber": "string",
                "objectVersion": {
                    "currentVersion": 0,
                    "newVersion": 0
                },
                "ts": "string",
                "statusTransition": {
                    "currentStatus": "CREATED",
                    "newStatus": "CREATED"
                },
                "transactionDetails": {
                    "taxScheme": "string",
                    "supplyType": "string",
                    "reverseChargeTax": "string",
                    "igstChargable": "string",
                    "ecommerceGstin": "string"
                },
                "supplierDetails": {
                    "b2bId": "string",
                    "gstin": "string",
                    "legalName": "string",
                    "tradeName": "string",
                    "stateCode": "string",
                    "address": {
                        "type": "string",
                        "addressLine1": "string",
                        "addressLine2": "string",
                        "city": "string",
                        "state": "string",
                        "country": "string",
                        "pincode": "string"
                    },
                    "contactNumber": {
                        "type": "string",
                        "countryCode": "string",
                        "phoneNumber": "string"
                    },
                    "email": "string"
                },
                "buyerDetails": {
                    "b2bId": "string",
                    "gstin": "string",
                    "legalName": "string",
                    "tradeName": "string",
                    "stateCode": "string",
                    "placeOfSupply": "string",
                    "address": {
                        "type": "string",
                        "addressLine1": "string",
                        "addressLine2": "string",
                        "city": "string",
                        "state": "string",
                        "country": "string",
                        "pincode": "string"
                    },
                    "contactNumber": {
                        "type": "string",
                        "countryCode": "string",
                        "phoneNumber": "string"
                    },
                    "email": "string"
                },
                "dispatchDetails": {
                    "gstin": "string",
                    "legalName": "string",
                    "tradeName": "string",
                    "stateCode": "string",
                    "address": {
                        "type": "string",
                        "addressLine1": "string",
                        "addressLine2": "string",
                        "city": "string",
                        "state": "string",
                        "country": "string",
                        "pincode": "string"
                    },
                    "contactNumber": {
                        "type": "string",
                        "countryCode": "string",
                        "phoneNumber": "string"
                    },
                    "email": "string"
                },
                "shippingDetails": {
                    "gstin": "string",
                    "lglNm": "string",
                    "trdNm": "string",
                    "stateCode": "string",
                    "address": {
                        "type": "string",
                        "addressLine1": "string",
                        "addressLine2": "string",
                        "city": "string",
                        "state": "string",
                        "country": "string",
                        "pincode": "string"
                    },
                    "contactNumber": {
                        "type": "string",
                        "countryCode": "string",
                        "phoneNumber": "string"
                    },
                    "email": "string"
                },
                "itemLists": [
                    {
                        "serialno": "string",
                        "productDescription": "string",
                        "isService": "string",
                        "hsnCode": "string",
                        "barCode": "string",
                        "quantity": 0,
                        "freeQuantity": 0,
                        "unit": "string",
                        "unitPrice": 0,
                        "totalAmt": 0,
                        "assessmentAmount": 0,
                        "gstRate": 0,
                        "totalItemValue": 0,
                        "orderLineReference": "string",
                        "originCountry": "string",
                        "productSerialNumber": "string",
                        "itemValueDetails": [
                            {
                                "type": "string",
                                "value": 0
                            }
                        ],
                        "rates": [
                            {
                                "type": "string",
                                "value": 0
                            }
                        ],
                        "batchDetails": {
                            "batchNumber": "string",
                            "expiryDate": "string",
                            "batchWarrantyDate": "string"
                        },
                        "attributeDetails": [
                            {
                                "name": "string",
                                "value": "string"
                            }
                        ],
                        "otherTaxes": [
                            {
                                "name": "string",
                                "rate": 0,
                                "amount": 0
                            }
                        ]
                    }
                ],
                "valueDetails": {
                    "assessmentValue": 0,
                    "totalInvoiceValue": 0,
                    "otherValues": [
                        {
                            "type": "string",
                            "value": 0
                        }
                    ]
                },
                "supplierBankAccountDetails": {
                    "maskedAccountNumber": "string",
                    "ifsc": "string",
                    "beneficiaryName": "string",
                    "businessVPA": "string"
                },
                "advancePaymentDetails": {
                    "payeeName": "string",
                    "mode": "string",
                    "paymentTerms": "string",
                    "paymentInstruction": "string",
                    "creditTransfer": "string",
                    "directDebit": "string",
                    "creditDays": 0,
                    "paidAmount": 0,
                    "pendingDueAmount": 0
                },
                "invoiceReferenceDetails": {
                    "invoiceRemarks": "string",
                    "invoiceStartDate": "string",
                    "invoiceEndDate": "string"
                },
                "precedingInvoiceDetails": [
                    {
                        "invoiceNumber": "string",
                        "date": "string",
                        "otherReferenceNo": "string"
                    }
                ],
                "poDetails": [
                    {
                        "poObjId": "string",
                        "buyerPoId": "string",
                        "poDate": "string"
                    }
                ],
                "contractReferenceDetails": [
                    {
                        "receiptAdviceNo": "string",
                        "receiptAdviceDate": "string",
                        "batchReferenceNo": "string",
                        "contractReferenceNo": "string",
                        "extraReferenceNo": "string",
                        "projectReferenceNo": "string"
                    }
                ],
                "additionalDocumentDetails": [
                    {
                        "url": "string",
                        "document": "string",
                        "info": "string"
                    }
                ],
                "exportDetails": {
                    "shipBillNo": "string",
                    "shipBillDate": "string",
                    "port": "string",
                    "refundClaim": "string",
                    "foreignCurrency": "string",
                    "countryCode": "string",
                    "exportDuty": 0
                },
                "ewayBillDetail": {
                    "transporterId": "string",
                    "transporterName": "string",
                    "transportMode": "string",
                    "distance": 0,
                    "transportDocumentNo": "string",
                    "transportDocumentDate": "string",
                    "vehicleNo": "string",
                    "vehicleType": "string"
                },
                "recurringPayments": {
                    "originalInvoiceId": "string",
                    "frequency": "string",
                    "startDate": "string",
                    "endDate": "string",
                    "mandateDetails": "string",
                    "mandateExecutionDate": "string",
                    "mandateAmount": 0
                },
                "paymentMilestones": [
                    {
                        "milestoneDate": "string",
                        "dueAmount": 0
                    }
                ],
                "shippingTermsDetails": {
                    "terms": "string",
                    "bearingParty": "string",
                    "charges": 0
                },
                "invoiceFinancingDetails": {
                    "dueAmount": 0,
                    "financingRequestAmount": 0
                },
                "einvoiceResponse": "string",
                "eInvoiceInfo": {
                    "schemaVersion": "string",
                    "irnNumber": "string",
                    "irnTs": "string"
                }
            }
        ]
    }
}'

Responses

🟢200Success
application/json
Body
payload
string 
required
response_code
integer 
required
response_message
string 
required
Example
{
  "payload": "SUCCESS",
  "response_code": 0,
  "response_message": "SUCCESS"
}
Modified at 2025-07-08 19:45:48
Previous
Status Change C/N Request
Next
Share Bid
Built with