This document will provide will provide schemas for Transaction API suite exposed by PSB Xchange Platform for any Sourcing Partner Transaction integration. Please find the Key Terminologies before you proceed ahead with PSB Xchange API Integrations is mentioned below:
\nPre-Requisites for PSB Xchange Sourcing Partner API Integrations:
\nThe sourcing partner will need to share the the list of IP addresses which need to be whitelisted for both UAT / Production environments.
\nSourcing partner to expose webhooks to consume the following details from PSB Xchange Platform: a) Transaction Status API webhook
\nReach out to anuj@psbxchange.com / parul@psbxchange.com to get an API Key issued to get started with PSB Xchange Lender API Integrations. Team will also be issuing UAT credentials for PSB Xchange Platform to get started.
\nTransaction API Token can be accessed by the Sourcing Partner by visiting PSB Xchange Platform and navigating to Platform Configurations.
\nStandard Error Codes for PSB Xchange Transaction APIs:
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"22805895","collectionId":"ff7e4c12-98cf-4dac-87a0-919c8eb29e8f","publishedId":"2sAYQggTQk","public":true,"customColor":{"top-bar":"F5f5f9","right-sidebar":"000000","highlight":"000000"},"publishDate":"2025-10-23T12:18:41.000Z"},"item":[{"name":"Common APIs","item":[{"name":"Initiate Transaction API","id":"2124a1fc-58b1-4cbf-b32a-59598029e559","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"API-KEY","value":"{{fintechapikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"data\": [\n {\n \"transactioninvoicenumber\": \"INVTEST1210202501001\",\n \"transactioninvoicedate\": \"12-10-2025\",\n \"transactioninvoiceamount\": 500,\n \"transactionfinancerequestamount\": 500,\n \"transactionfinancerequestdate\": \"12-10-2025\",\n \"transactionfinancerequestid\": \"FINTEST1210202501001\",\n \"transactioninvoiceduedate\": \"10-01-2026\",\n //attchmentstype can be PDF/PNG/JPEG/JPG/GIF. Mandatory if lmsinvoiceattachmentrequired = Yes (as part of Get Program Details) \n \"attachmentstype\": \"PDF\",\n //attachments contains base64 encoded string of the attachment file. Please replace the value with the actual base64 encoded string.\n // Mandatory if lmsinvoiceattachmentrequired = Yes (as part of Get Program Details)\n \"attachments\": \"base64\",\n // For Product = DF if there are multiple mapped account nos as part Get Program Details (lmsprogramanchoraccountdetails list). This is used to pass appropriate Anchor Account No. for disbursement. This field is mandatory in case Product Code = DF & \"lmsdisbursementaccounttype\": \"Dynamic\" in Get Program Details API. \n // For Product = PID and allowonlypreapprovedsuppliers = \"Yes\" this is mandatory transactionaccountdetails = Account no of the Supplier for which the invoice is supposed to be discounted\n // For Product = VF , this is used to pass the supplier account details to which disbursement is required.\n \"transactionaccountdetails\": \"BDOPD2718A\",\n //The below mentioned keys are only required if Product = DF & lmsdisbursementaccounttype = Dynamic for the Program\n \"transactiondisbursementaccountbankname\": \"Internal/External\", //Pass Internal if Dynamic Account Bank Name is same as that of Program. Pass External if Dynamic Account Bank Name is different from that of Program.\n \"transactiondisbursementbeneficiaryname\": \"Sample name\",\n \"transactiondisbursementaccountifsccode\": \"HDFC0001231\",\n //This is applicable only for product = Purchase Invoice Discounting. This is mandatory where: allowonlypreapprovedsuppliers = \"No\" as part of Get Program Details API\n //These are vendor details for which the Invoice discounting is required.\n \"transactionvendorname\": \"Vendor Name\",\n \"transactionvendorcode\": \"Vendor Code\",\n \"transactionvendorbankaccountname\": \"Vendor Bank Account Name\",\n \"transactionvendoraccountnumber\": \"1234567890\",\n \"transactionvendorbankname\": \"Internal/External\",//Pass Internal if Vendor Bank Name is same as that of Program. Pass External if Vendor Bank Name is different from that of Program.\n \"transactionvendorbranch\": \"Vendor Branch Name\",\n \"transactionvendorifsccode\": \"Vendor IFSC Code\",\n //This is applicable only for product = Sales Invoice Discounting. Below fields are mandatory.\n \"transactionbuyername\": \"Buyer Name\",\n \"transactionbuyercode\": \"Buyer Code\",\n // These are only applicable for Product = VF . To be mandatorily sent in case lmsprogramduedatecalculatedfrom = GRN Date as part of Get Program Detaiils API\n \"transactiongrndate\": \"2025-10-12\",\n \"transactiongrnnumber\": \"GRN Number\"\n },\n {\n \"transactioninvoicenumber\": \"INVTEST1210202501002\",\n \"transactioninvoicedate\": \"12-10-2025\",\n \"transactioninvoiceamount\": 500,\n \"transactionfinancerequestamount\": 500,\n \"transactionfinancerequestdate\": \"12-10-2025\",\n \"transactionfinancerequestid\": \"FINTEST1210202501002\",\n \"transactioninvoiceduedate\": \"10-01-2026\",\n \"attachments\": \"PNG\",\n \"attachmentstype\": \"base64\",\n // For Product = DF if there are multiple mapped account nos as part Get Program Details (lmsprogramanchoraccountdetails list). This is used to pass appropriate Anchor Account No. for disbursement. This field is mandatory in case Product Code = DF & \"lmsdisbursementaccounttype\": \"Dynamic\" in Get Program Details API. \n // For Product = PID and allowonlypreapprovedsuppliers = \"Yes\" this is mandatory transactiondisbursementaccountno = Account no of the Supplier for which the invoice is supposed to be discounted\n // For Product = VF , this is used to pass the supplier account details to which disbursement is required. This is mandatory\n \"transactionaccountdetails\": \"BDOPD2718A\",\n \"transactiondisbursementaccountbankname\": \"Internal/External\", //Pass Internal if Dynamic Account Bank Name is same as that of Program. Pass External if Dynamic Account Bank Name is different from that of Program.\n \"transactiondisbursementbeneficiaryname\": \"Sample name\",\n \"transactiondisbursementaccountifsccode\": \"HDFC0001231\",\n //This is applicable only for product = Purchase Invoice Discounting. This is mandatory where: allowonlypreapprovedsuppliers = \"No\" as part of Get Program Details API\n //These are vendor details for which the Invoice discounting is required.\n \"transactionvendorname\": \"Vendor Name\",\n \"transactionvendorcode\": \"Vendor Code\",\n \"transactionvendorbankaccountname\": \"Vendor Bank Account Name\",\n \"transactionvendoraccountnumber\": \"1234567890\",\n \"transactionvendorbankname\": \"Internal/External\",//Pass Internal if Vendor Bank Name is same as that of Program. Pass External if Vendor Bank Name is different from that of Program.\n \"transactionvendorbranch\": \"Vendor Branch Name\",\n \"transactionvendorifsccode\": \"Vendor IFSC Code\",\n //This is applicable only for product = Sales Invoice Discounting\n \"transactionbuyername\": \"Buyer Name\",\n \"transactionbuyercode\": \"Buyer Code\",\n // These are only applicable for Product = VF . To be mandatorily sent in case lmsprogramduedatecalculatedfrom = GRN Date as part of Get Program Detaiils API\n \"transactiongrndate\": \"2025-10-12\",\n \"transactiongrnnumber\": \"GRN Number\"\n }\n ],\n // psbchannelpartneridentifier to be used in case of Product Code = DF or VF. This is the PSB Xchange Channel Partner Identifier.\n \"psbchannelpartneridentifier\": \"PSBCPL-DF-0093-0001\",\n // psbprogramidentifier to be mandatory in case of Product Code = PID or SID or FACT or REVFACT. This is the PSB Xchange Program Identifier.\n //\"psbprogramidentifier\": \"PSBPGL-PID-0093\",\n \"sptransactionbatchreferenceno\": \"10661\",\n //This is an Additional Channel Partner identifier required by the Lender to initiate a transaction. \n //This is only applicable for few Lenders where the Lender requires additional identifiers for the Channel Partner transactions.\n //Values of the same can be obtained using the Get Channel Partner Details API. Refer additionalidentifierdetails list\n \"psbadditionalchannelpartneridentifier\": \"10661\",\n \"psbadditionalaccountno\": \"10130458945\",\n \"psbadditionalifsccode\": \"SBIN0000999\"\n}","options":{"raw":{"language":"json"}}},"url":"{{psburl}}/v2/transactions/initiate","description":"This API allows the Sourcing Partners to provided transaction requests for any Corporate / Channel Partners onboarded on the PSB Platform.
\nSourcing Partner must be registered and onboarded onto the PSB Xchange Platform.
\nSourcing Partner must be partnered with Lenders for the Program / Channel Partner created on the PSB Xchange Platform.
\nA valid Channel Partner Mapping ID (for Dealer Finance/Vendor Finance) or valid Program ID (for Sales Invoice Discounting, Purchase Invoice Discounting, Factoring, Reverse Factoring) must be provided in the API request.
\nProgram / Channel Partner details provided in the API request must be active on the PSB Xchange Platform.
\nFor Dealer Financing Product (DF) (Push / Pull Model):
\nFor Vendor Financing (VF) Product:
\nFor Sales Invoice Discounting (SID) / Purchase Invoice Discounting (PID) / Factoring (FACT) / Reverse Factoring (REVFACT) Product:
\nPOST {{psburl}}/v2/transactions/initiate\n\ndata array){\n \"code\": 200,\n \"message\": \"Success\",\n \"data\": {\n \"psbtransactionbatchreferenceno\": \"37f02df8-d47a-4fe9-9fd5-da2458ea8e9c\"\n }\n}\n\n{\n \"code\": 101,\n \"message\": \"Date Validation Failed In Initiate Transaction With Transaction Finance Request Id: FINREQ16042025085: Transaction Invoice due date must be after the invoice date,Transaction Finance request date cannot be after the invoice due date,Transaction Invoice Due date Cannot be Older Than Current Date | FINREQ16042025082: ...\",\n \"data\": null\n}\n\nRequest:
\n{\n \"data\": [\n {\n \"transactioninvoicenumber\": \"INVTEST24092025001001\",\n \"transactioninvoicedate\": \"24-09-2025\",\n \"transactioninvoiceamount\": 50000,\n \"transactionfinancerequestamount\": 45000,\n \"transactionfinancerequestdate\": \"24-09-2025\",\n \"transactionfinancerequestid\": \"FINTEST24092025001001\",\n \"transactioninvoiceduedate\": \"23-12-2025\",\n \"attachments\": \"PDF\",\n \"attachmentstype\": \"PDF\"\n }\n ],\n \"psbchannelpartneridentifier\": \"PSBCPL-DF-0171-0001\",\n \"sptransactionbatchreferenceno\": \"BATCHTEST24092025001\",\n \"psbadditionalchannelpartneridentifier\": \"363800\",\n \"psbadditionalaccountno\": \"ESCEAMF999999\",\n \"psbadditionalifsccode\": \"UTIB0CCH274\"\n}\n\nResponse:
\n{\n \"code\": 200,\n \"message\": \"Success\",\n \"data\": {\n \"psbtransactionbatchreferenceno\": \"37f02df8-d47a-4fe9-9fd5-da2458ea8e9c\"\n }\n}\n\nRequest:
\n{\n \"data\": [\n {\n \"transactioninvoicenumber\": \"INVOICE16042025081\",\n \"transactioninvoicedate\": \"21-04-2025\",\n \"transactioninvoiceamount\": 5000,\n \"transactionfinancerequestamount\": 500,\n \"transactionfinancerequestdate\": \"21-04-2025\",\n \"transactionfinancerequestid\": \"FINREQ16042025081\",\n \"transactioninvoiceduedate\": \"23-03-2025\"\n }\n ],\n \"psbchannelpartneridentifier\": \"PSBCPL-DF-0003-0004\",\n \"sptransactionbatchreferenceno\": \"BATCHID1604202508\"\n}\n\nResponse:
\n{\n \"code\": 101,\n \"message\": \"Date Validation Failed In Initiate Transaction With Transaction Finance Request Id: FINREQ16042025081: Transaction Invoice due date must be after the invoice date,Transaction Finance request date cannot be after the invoice due date,Transaction Invoice Due date Cannot be Older Than Current Date\",\n \"data\": null\n}\n\nEnsure all identifiers and mapping IDs are accurate and active.
\nThe API supports batch transaction initiation (multiple transactions in a single request).
\nDate format must strictly follow DD-MM-YYYY pattern.
\nThe psbtransactionbatchreferenceno returned in success response should be stored for tracking and future reference.
This API is used by Sourcing Partners to fetch Limit Details (such as sanctioned, utilized, outstanding limits, and status) for a particular Program or Channel Partner on the PSB Xchange Platform.
\nSourcing Partner must be registered and onboarded onto the PSB Xchange Platform.
\nSourcing Partner must be partnered with Lenders for the Program or Channel Partner created on the PSB Xchange Platform.
\nA valid Channel Partner Mapping ID (to fetch limits for a Channel Partner) and/or a valid Program ID (to fetch limits for a Program) must be provided in the API request.
\nProgram / Channel Partner details provided in the API request must be active on the PSB Xchange Platform.
\nEither psbprogramidentifier (for Program limits) or psbchannelpartneridentifier (for Channel Partner limits) must be provided as per the requirement.
The API is accessible only to authorized Sourcing Partners with valid credentials.
\nDealer Finance (DF)
\nVendor Finance (VF)
\nSales Invoice Discounting (SID)
\nPurchase Invoice Discounting (PID)
\nFactoring (FACT)
\nReverse Factoring (REVFACT)
\nPOST {{psburl}}/v2/transactions/limit\n\n{\n \"psbprogramidentifier\": \"string\", // Program ID (e.g., PSBPGL-DF-0001)\n \"psbchannelpartneridentifier\": \"string\" // Channel Partner Mapping ID (e.g., PSBCPL-DF-0122-0001)\n}\n\nPOST {{psburl}}/v2/transactions/limit\nContent-Type: application/json\nAPI-KEY: {{fintechapikey}}\n{\n \"psbprogramidentifier\": \"PSBPGL-DF-0001\"\n}\n\nor
\nPOST {{psburl}}/v2/transactions/limit\nContent-Type: application/json\nAPI-KEY: {{fintechapikey}}\n{\n \"psbchannelpartneridentifier\": \"PSBCPL-DF-0122-0001\"\n}\n\nThis API is used by Sourcing Partners to fetch Limit Details (such as sanctioned, utilized, outstanding limits, and status) for multiple Programs or multiple Channel Partners in a single API call on the PSB Xchange Platform.
\nSourcing Partner must be registered and onboarded onto the PSB Xchange Platform.
\nSourcing Partner must be partnered with Lenders for the Program or Channel Partner created on the PSB Xchange Platform.
\nValid Channel Partner Mapping IDs (to fetch limits for Channel Partners) or valid Program IDs (to fetch limits for Programs) must be provided in the API request.
\nProgram / Channel Partner details provided in the API request must be active on the PSB Xchange Platform.
\nLimits of Programs & Channel Partners cannot be fetched together in a single request. The request should contain either details of only Channel Partners or only Programs.
\nThe API works in an asynchronous fashion. Sourcing Partners must configure a callback endpoint to receive the response.
\nThe API is accessible only to authorized Sourcing Partners with valid credentials.
\nDealer Finance (DF)
\nVendor Finance (VF)
\nSales Invoice Discounting (SID)
\nPurchase Invoice Discounting (PID)
\nFactoring (FACT)
\nReverse Factoring (REVFACT)
\nPOST {{psburl}}/v2/transactions/limit\n\n{\n \"data\": [\n {\n \"psbprogramidentifier\": \"string\", // Program ID (e.g., PSBPGL-DF-0001) [for Program limit fetch]\n \"psbchannelpartneridentifier\": \"string\" // Channel Partner Mapping ID (e.g., PSBCPL-DF-0122-0001) [for Channel Partner limit fetch]\n }\n ]\n}\n\nNote: All objects in the data array must be of the same type—either all with psbprogramidentifier or all with psbchannelpartneridentifier.
POST {{psburl}}/v2/transactions/limit\nContent-Type: application/json\nAPI-KEY: {{fintechapikey}}\n{\n \"data\": [\n { \"psbchannelpartneridentifier\": \"PSBCPL-DF-0154-0001\" },\n { \"psbchannelpartneridentifier\": \"PSBCPL-DF-0154-0002\" }\n ]\n}\n\nPOST {{psburl}}/v2/transactions/limit\nContent-Type: application/json\nAPI-KEY: {{fintechapikey}}\n{\n \"data\": [\n { \"psbprogramidentifier\": \"PSBPGL-DF-0001\" },\n { \"psbprogramidentifier\": \"PSBPGL-DF-0002\" }\n ]\n}\n\nThe Get Program Details API allows Sourcing Partners to fetch comprehensive details of a Program that is activated on the PSB Xchange Platform. This API provides information about program configuration, eligibility criteria, limits, interest rates, and operational status.
\nRetrieve program configuration before initiating transactions
\nVerify program limits and eligibility percentages
\nCheck program status and activation details
\nFetch interest rate structures and tenor information
\n{\n \"psbprogramidentifier\": \"string\"\n}\n\nPattern: PSBPGL-{PRODUCT_CODE}-{SEQUENCE}
Product Codes: DF (Dealer Finance), VF (Vendor Finance), SID(Sales Invoice Discounting), PID(Purchase Invoice Discounting) , FACT(Purchase Invoice Discounting), REVFACT(Reverse Factoring)
{\n \"code\": 200,\n \"message\": \"Success\",\n \"data\": { /* Program Details Object */ }\n}\n\ndata)lmsprograminterestrates) (only applicable for Dealer Financing Product)lmsprogramanchoraccountdetails)POST {{psburl}}/v2/transactions/program-details\nContent-Type: application/json\nAPI-KEY: {{fintechapikey}}\n{\n \"psbprogramidentifier\": \"PSBPGL-DF-0146\"\n}\n\n{\n \"code\": 200,\n \"message\": \"Success\",\n \"data\": {\n \"lmsresetfrequencydays\": null,\n \"programactivationdate\": \"07-10-2025\",\n \"lmslenderprogramidentifier\": \"df0570b0-a385-11f0-b77c-afb2501de909\",\n \"lmsprograminterestrates\": [\n {\n \"fromDays\": 1,\n \"toDays\": 3,\n \"interest\": 5.8,\n \"roi\": 15.3,\n \"dis_credit_spread\": 4.3,\n \"dis_business_spread\": 1.5,\n \"interest_bearing\": \"Dealer Bearing\"\n }\n ],\n \"lmsprogramduedatecalculatedfrom\": \"Disbursement Date\",\n \"lmslimitexitdate\": null,\n \"lmsprogramgraceperiodoninterest\": 0,\n \"lenderprogramprogramunutilizedlimit\": 899999975920,\n \"lmscurrentbaserate\": 9.5,\n \"lendername\": \"STATE BANK OF INDIA\",\n \"lenderprogramprogramname\": \"STATE BANK ZOHO PROGRAM DF\",\n \"lmscompanyid\": \"19f86560-a385-11f0-bded-0116b96e53e8\",\n \"lmsprogrameligibilitypercentage\": 100,\n \"lmslimitexpirydate\": \"19-10-2028\",\n \"lmssanctiondate\": \"07-10-2025\",\n \"programfldgpercentage\": 98,\n \"lenderprogramprogramoutstandinglimit\": 0,\n \"lmsprogramminfinancingdays\": 0,\n \"lmsprogramutrconsolidationapplicable\": \"No\",\n \"lenderprogramgraceperiodindays\": 0,\n \"lenderprogramprogramlimit\": 900000000000,\n \"programstatus\": \"Active\",\n \"lmsprogramgraceperiodapplicable\": \"Not Applicable\",\n \"lmscorporatename\": \"ZOHO CORPORATION PRIVATE LIMITED\",\n \"lmsdisbursementaccounttype\": \"Dynamic\",\n \"lenderprogramprogramtenor\": 1,\n \"lenderprogramcurrentbenchmarkrateforprogram\": 9.5,\n \"lmsprogrammaxfinancingdays\": 0,\n \"lmsprogramroibenchmarkcode\": \"Sanity Base Rate\",\n \"lmsproductcode\": \"DF\",\n \"lmsprogrammaturityhandling\": \"No Effect\",\n \"lenderprogramprogrampenalinterest\": 3,\n \"lmsprogramactivationdate\": \"07-10-2025\",\n \"lmsprogramautorequestfinance\": \"No\",\n \"lmsprogramanchoraccountdetails\": null,\n \"lmsprogramfldgapplicable\": \"Not Applicable\",\n \"lmsloanaccountno\": null,\n \"lmsprogrampenalinterestrate\": 3,\n \"lmsprogramstopsupplyapplicable\": \"Applicable\",\n \"lmsnpadate\": null,\n \"lenderprogramstaleinvoiceperiod\": 2,\n \"lenderprogrammaxcplimitforprogramininr\": 900000000000,\n \"lmsprograminteresttype\": \"Monthly\",\n \"programstopsupplydays\": 2,\n \"tmsprogramrequestid\": \"6ac1d0b3-5bca-4a02-89ac-fe1b9f0f0cc8\",\n \"lmsinvoiceattachmentrequired\": \"No\",\n \"lmsremarks\": null,\n \"lmsprogramcode\": \"PSBPGL-DF-0146\",\n \"lmsprogramstatus\": \"Approved\",\n \"lmsprograminterestonpostedinterest\": 0,\n \"lmsprogramgraceperioddays\": 0,\n \"lmsprogrammaxchannelpartnerlimit\": 900000000000,\n \"lmsnpastatus\": \"No\",\n \"lmsprogrampenalinterestoninterest\": 3,\n \"lmsprogrammargin\": 0,\n \"lenderprogramstopsupplydays\": 2,\n \"lmsprogramautoapprovefinancebybank\": \"Yes\",\n \"lmsstatus\": \"Active\"\n }\n}\n\n{\n \"code\": 200,\n \"message\": \"Success\",\n \"data\": {\n \"lmsresetfrequencydays\": 90,\n \"programactivationdate\": \"03-03-2025\",\n \"lmslenderprogramidentifier\": \"41d2a940-ded8-11ef-a5e4-9727cb7de555\",\n \"lmsprograminterestrates\": [\n {\n \"fromDays\": 1,\n \"toDays\": 10,\n \"interest\": 9.8,\n \"roi\": 10.8,\n \"dis_credit_spread\": 6.4,\n \"dis_business_spread\": 3.4,\n \"interest_bearing\": \"Dealer Bearing\"\n }\n ],\n \"lmsprogramduedatecalculatedfrom\": \"Invoice Due Date\",\n \"lenderprogramprogramunutilizedlimit\": 2099626955.14,\n \"lmscurrentbaserate\": 1,\n \"lendername\": \"CENTRAL BANK OF INDIA\",\n \"lenderprogramprogramname\": \"Mazgaon Dockyard\",\n \"lmsprogrameligibilitypercentage\": 100,\n \"lmslimitexpirydate\": \"31-01-2030\",\n \"programfldgpercentage\": 5,\n \"lenderprogramprogramlimit\": 2100000000,\n \"programstatus\": \"Active\",\n \"lmsprogramgraceperiodapplicable\": \"Applicable\",\n \"lmscorporatename\": \"Mazgaon & Dockyard\",\n \"lmsprogramanchoraccountdetails\": [\n {\n \"accountName\": \"HDFC Bank\",\n \"accountNo\": \"123456789123\",\n \"bankName\": \"HDFC\",\n \"branchName\": \"Productivity Road Branch\",\n \"branchCode\": \"IFSC0001241\",\n \"accountType\": \"Current Account\",\n \"activeStatus\": \"Active\"\n }\n ],\n \"lmsprogramfldgapplicable\": \"Applicable\",\n \"lmsproductcode\": \"DF\",\n \"lmsprogramstatus\": \"Approved\",\n \"lmsstatus\": \"Active\"\n }\n}\n\n{\n \"code\": 400,\n \"message\": \"Error message describing the issue\",\n \"data\": null\n}\n\nSourcing Partner must be registered and onboarded onto the PSB Xchange Platform
\nSourcing Partner must be partnered with Lenders for the Program or Channel Partner
\nA valid Program ID must be provided in the request
\nOnly details for active and valid Programs will be returned
\nThe API is accessible only to authorized Sourcing Partners with valid credentials
\nResponse fields may vary based on product type.
\nlmsprogramanchoraccountdetails can be null for Dynamic disbursement account types
Date format in responses is DD-MM-YYYY
This API allows Sourcing Partners to fetch Channel Partner mapping details for any Channel Partner onboarded onto the PSB Platform. It is primarily used in Dealer Financing (DF) and Vendor Financing (VF) product flows.
\nPOST {{psburl}}/v2/transactions/channel-partner-details\nHeaders:\n API-KEY: {{fintechapikey}}\n Content-Type: application/json\n\n{\n \"psbchannelpartneridentifier\": \"PSBCPL-DF-0146-0001\"\n}\n\nlmscpinterestrate Array)lmsmappingaccountdetails Array) - Mapped Anchor Account Detailsadditionalidentifierdetails Array) - OptionalExample 1: Dealer Financing - Standard Response
\n{\n \"code\": 200,\n \"message\": \"Success\",\n \"data\": {\n \"lmscpname\": \"V C GREEN ENERGY PRIVATE LIMITED\",\n \"psbprogramidentifier\": \"PSBPGL-DF-0003\",\n \"lmslenderprogramidentifier\": \"41d2a940-ded8-11ef-a5e4-9727cb7de555\",\n \"lendername\": \"CENTRAL BANK OF INDIA\",\n \"lenderprogramprogramname\": \"Mazgaon Dockyard\",\n \"lmsanchorname\": \"Mazgaon & Dockyard\",\n \"lmsproductcode\": \"DF\",\n \"lmscpstatus\": \"Approved\",\n \"lmsstatus\": \"Active\",\n \"lmsnpastatus\": \"No\",\n \"lendercpmappingchannelpartnerlimit\": 3500000,\n \"lendercpmappingunutilizedlimit\": 3491200,\n \"lendercpmappingoutstandinglimit\": 5000,\n \"lmsmappingeligibilitypercentage\": 100,\n \"lmssanctiondate\": \"05-02-2025\",\n \"lmscpactivationdate\": \"03-03-2025\",\n \"lmslimitexpirydate\": \"21-02-2030\",\n \"lmslimitreviewdate\": \"22-02-2029\",\n \"lendercpmappingcptenor\": 10,\n \"lmscpinteresttype\": \"Monthly\",\n \"lmsgraceperiodoninterest\": 10,\n \"lmsloanaccountno\": \"12345718911\",\n \"lmscpinterestrate\": [\n {\n \"fromDays\": 1,\n \"toDays\": 10,\n \"interest\": 9.8,\n \"roi\": 10.8,\n \"dis_credit_spread\": 6.4,\n \"dis_business_spread\": 3.4,\n \"interest_bearing\": \"Dealer Bearing\"\n }\n ],\n \"lmsmappingaccountdetails\": [\n {\n \"accountName\": \"VC Green Eneergy\",\n \"accountNo\": \"121251821928\",\n \"ifscCode\": \"HDFC0001241\",\n \"bankName\": \"Bank\",\n \"branchName\": \"Productivity Road Branch\",\n \"accountType\": \"Current Account\",\n \"activeStatus\": \"Active\"\n }\n ]\n }\n}\n\nExample 2: Dealer Financing - With Dynamic Account Validation
\n{\n \"code\": 200,\n \"message\": \"Success\",\n \"data\": {\n \"lmscpname\": \"F360 INTEGRATED OFFICE SERVICES (OPC) PRIVATE LIMITED\",\n \"psbprogramidentifier\": \"PSBPGL-DF-0146\",\n \"lmslenderprogramidentifier\": \"df0570b0-a385-11f0-b77c-afb2501de909\",\n \"lendername\": \"STATE BANK OF INDIA\",\n \"lenderprogramprogramname\": \"STATE BANK ZOHO PROGRAM DF\",\n \"lmsanchorname\": \"ZOHO CORPORATION PRIVATE LIMITED\",\n \"lmsproductcode\": \"DF\",\n \"lmscpstatus\": \"Approved\",\n \"lmsstatus\": \"Active\",\n \"lmsnpastatus\": \"No\",\n \"lendercpmappingchannelpartnerlimit\": 9000000000,\n \"lendercpmappingunutilizedlimit\": 8999930920,\n \"lendercpmappingoutstandinglimit\": 0,\n \"lmsmappingeligibilitypercentage\": 100,\n \"lmscpmargin\": 0,\n \"lmssanctiondate\": \"07-10-2025\",\n \"lmscpactivationdate\": \"07-10-2025\",\n \"lmslimitexpirydate\": \"04-01-2028\",\n \"lendercpmappingcptenor\": 2,\n \"lmscpinteresttype\": \"Monthly\",\n \"lmsgraceperiodoninterest\": 0,\n \"lmscpgraceperioddays\": 0,\n \"lmscpstopsupplydays\": 2,\n \"lmsloanaccountno\": \"5000849029\",\n \"lmsdisbursementaccountregex\": \"[\\\"^[A-Za-z]{5}\\\\\\\\d{4}[A-Za-z]{1}$\\\"]\",\n \"lmscpinterestrate\": [\n {\n \"fromDays\": 1,\n \"toDays\": 3,\n \"interest\": 5.8,\n \"roi\": 15.3,\n \"dis_credit_spread\": 4.3,\n \"dis_business_spread\": 1.5,\n \"interest_bearing\": \"Dealer Bearing\"\n }\n ],\n \"lmsmappingaccountdetails\": [\n {\n \"accountName\": \"aadesh pise\",\n \"accountNo\": \"50930994490\",\n \"ifscCode\": \"HDFC030399\",\n \"bankName\": \"HDFC\",\n \"branchName\": \"Nagpur\",\n \"accountType\": \"Current\",\n \"activeStatus\": \"Active\"\n }\n ],\n \"additionalidentifierdetails\": [\n {\n \"index\": 1,\n \"lenderadditionalidentifierforcp\": null,\n \"lenderadditionaccountno\": null,\n \"lenderadditionalifsccode\": null,\n \"lenderadditionalidentifierclassification\": null,\n \"lenderadditionalidentifierremarks\": null\n }\n ]\n }\n}\n\nThis API allows Sourcing Partners to get the status of any transaction request initiated through the Initiate Transaction API. Sourcing Partners can also get the status of transactions initiated for Programs / Channel Partners onboarded on the PSB Xchange Platform by configuring the Transaction API Callback.
\nApplicable Product: All Products
\nAccess to the PSB Xchange Platform as a Sourcing Partner.
\nAPI Key (API-KEY) provisioned for your organization.
The psbtransactionbatchreferenceno value from a previously initiated transaction.
Method: POST
\nURL: {{psburl}}/v2/transactions/status
Headers:
\nAPI-KEY: {{fintechapikey}} (string, required)
Content-Type: application/json
{\n \"psbtransactionbatchreferenceno\": \"string\"\n}\n\nPOST {{psburl}}/v2/transactions/status\nHeaders:\n API-KEY: {{fintechapikey}}\n Content-Type: application/json\nBody:\n{\n \"psbtransactionbatchreferenceno\": \"f79c7c66-d1eb-457d-9077-998f02da36ab\"\n}\n\nEnsure the API-KEY is valid and active for your organization.
The psbtransactionbatchreferenceno must correspond to a valid transaction initiated via the Initiate Transaction API.
For detailed request/response schemas, refer to the API Documentation Spreadsheet.
\nThis API is used to retrieve a detailed Statement of Account (SOA) for the Borrower across various PSB Xchange product types.
\nThis endpoint provides comprehensive loan account information including credit limits, utilization, and transaction history.
\n\n\nNote: Either
\npsbprogramidentifierorpsbchannelpartneridentifiermust be provided in each request — not both simultaneously.
{\n \"psbchannelpartneridentifier\": \"PSBCPL-DF-0003-0001\",\n \"soastartdate\": \"05-11-2025\",\n \"soaenddate\": \"26-12-2025\",\n \"soapageno\": 1,\n \"soapagesize\": 100\n}\n\ndata Object Fieldstransactions Array — Transaction Object Fieldserrors Array — Error Object FieldsAll monetary amounts are in INR (Indian Rupees) unless otherwise specified.
\nAll dates follow the DD-MM-YYYY format consistently across request and response fields.
The transactions array is ordered chronologically by lmstransactiondate.
If no transactions are found within the specified date range, the transactions array will be empty ([]) and an appropriate message will be returned.
These contain all APIs which are product agnostic. These set of APIs work across all Products.
\n","_postman_id":"f22d9252-5831-40c3-9d26-fc4d096e0078"},{"name":"SID Specific","item":[{"name":"Fetch Buyer Status","id":"006b4c26-a4bf-4327-9e49-46ce45e4cf81","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"API-KEY","value":"{{fintechapikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"psbprogramidentifier\": \"PSBPGL-SID-0008\",\n \"buyercode\" : \"TESTCODE0303202611\"\n}\n","options":{"raw":{"language":"json"}}},"url":"{{psburl}}/v2/transactions/fetch-buyer-status","description":"The Fetch Buyer Status API allows Sourcing Partners to retrieve the current onboarding/activation status of a specific Buyer (Channel Partner) mapped under a given SID Program on the PSB Xchange Platform. This is typically used to check whether a buyer has been successfully onboarded, is pending approval, or has been rejected/deactivated.
\nThe request body is a JSON object containing the program identifier and the buyer code whose status needs to be fetched.
\n{\n \"psbprogramidentifier\": \"PSBPGL-SID-0008\",\n \"buyercode\": \"TESTCODE0303202611\"\n}\n\nbuyercode (from known test data)On a successful request, the API returns the buyer's current mapping status, credit limit, tenor, and associated lender details.
\ndata Object — Field-Level Breakdowndata.buyermappingstatus{\n \"code\": 200,\n \"message\": \"Success\",\n \"data\": {\n \"buyermaxlimit\": 500000,\n \"buyermappingstatus\": \"Pending\",\n \"buyermaxtenor\": 90,\n \"psbprogramidentifier\": \"PSBPGL-SID-0008\",\n \"lendername\": \"CENTRAL BANK OF INDIA\",\n \"buyercode\": \"TESTCODE0303202604\",\n \"lenderpsbplatformid\": \"LENDER0004\",\n \"buyername\": \"SICAL LOGISTICS LIMITED\"\n }\n}\n\n{\n \"code\": 404,\n \"message\": \"Buyer not found for the given program identifier and buyer code\",\n \"data\": null\n}\n\nThe Get Buyer Details API enables Sourcing Partners to retrieve the complete list of all Buyers (Channel Partners) mapped under a specific SID Program on the PSB Xchange Platform. This API returns detailed information about each buyer including their credit limits, tenor, mapping status, PAN, and the associated lender details. It is typically used for:
\nViewing all onboarded buyers under a program at a glance
\nReconciling buyer records between the Sourcing Partner's system and PSB Xchange
\nMonitoring buyer activation/mapping statuses in bulk
\nThe request body is a JSON object containing the program identifier for which all buyer details need to be fetched.
\n{\n \"psbprogramidentifier\": \"PSBPGL-SID-0008\"\n}\n\nOn a successful request, the API returns the lender details, total buyer count, and an array of all buyer records mapped under the specified program.
\ndata Object — Field-Level Breakdowndata.buyerdetails[] — Individual Buyer Object Fieldsbuyermappingstatus{\n \"code\": 200,\n \"message\": \"Success\",\n \"data\": {\n \"psbprogramidentifier\": \"PSBPGL-SID-0008\",\n \"lendername\": \"CENTRAL BANK OF INDIA\",\n \"buyercount\": 5,\n \"buyerdetails\": [\n {\n \"buyername\": \"AEOLUS TYRE INDIA OPC PRIVATE LIMITED\",\n \"buyermaxlimit\": 500000,\n \"buyermaxtenor\": 90,\n \"buyercode\": \"TESTCODE0303202603\",\n \"buyermappingstatus\": \"Active\",\n \"buyerpan\": \"AANCA5471H\"\n },\n {\n \"buyername\": \"ZETWERK MANUFACTURING BUSINESSES PRIVATE LIMITED\",\n \"buyermaxlimit\": 500000,\n \"buyermaxtenor\": 90,\n \"buyercode\": \"TESTCODE0303202602\",\n \"buyermappingstatus\": \"Active\",\n \"buyerpan\": \"AABCZ1506C\"\n },\n {\n \"buyername\": \"Godrej Properties Limited\",\n \"buyermaxlimit\": 500000,\n \"buyermaxtenor\": 90,\n \"buyercode\": \"TESTCODE0303202601\",\n \"buyermappingstatus\": \"Active\",\n \"buyerpan\": \"AAECI2933D\"\n },\n {\n \"buyername\": \"V C GREEN ENERGY PRIVATE LIMITED\",\n \"buyermaxlimit\": 100000000,\n \"buyermaxtenor\": 90,\n \"buyercode\": \"INDELSIDCODE02\",\n \"buyermappingstatus\": \"Active\"\n },\n {\n \"buyername\": \"INDIAN HUME PIPE COMPANY LIMITED\",\n \"buyermaxlimit\": 50000000,\n \"buyermaxtenor\": 90,\n \"buyercode\": \"INDELSIDCODE01\",\n \"buyermappingstatus\": \"Active\"\n }\n ],\n \"lenderpsbplatformid\": \"LENDER0004\"\n }\n}\n\n\n\nNote: The
\nbuyerpanfield is optional and may not be present in all buyer objects. In the sample above, the last two buyer records do not includebuyerpan.
{\n \"code\": 404,\n \"message\": \"No buyers found for the given program identifier\",\n \"data\": null\n}\n\nThis folder contains APIs which are specific to SID Product
\n","_postman_id":"6716b3d0-b24c-44ad-a234-c4cd6933e30d"},{"name":"PID Specific","item":[{"name":"Get Supplier Details API","id":"00243f4c-209f-477e-8c85-8d408ffc1907","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"API-KEY","value":"{{fintechapikey}}"}],"body":{"mode":"raw","raw":"{\n \"psbprogramidentifier\": \"PSBPGL-PID-0008\"\n}","options":{"raw":{"language":"json"}}},"url":"{{psburl}}/v2/transactions/fintech/get-all-supplier-details","description":"The Get Supplier Details API allows retrieval of supplier master details associated with a PSB Xchange PID Program.
\nThis API returns supplier information including supplier identity, bank account details, mapping status, and associated lender information for a specific Program Identifier (PID).
\nThe API is specifically designed for PSB Xchange onboarded PID programs, where suppliers are mapped to lenders under supply chain or program-based financing arrangements.
\nThe response returns a list of all suppliers associated with the provided psbprogramidentifier.
\nImportant Note
\nThis API is only applicable for PID programs onboarded on the PSB Xchange platform.
If the provided psbprogramidentifier does not belong to a PSB Xchange PID program, the API will not return supplier data.
{\n \"psbprogramidentifier\": \"PSBPGL-PID-0008\"\n}\n\nThe API returns a structured response containing:
\nResponse status code
\nResponse message
\nData object containing supplier details
\nEach object within the supplierdetails array contains the following attributes:
\n{\n \"code\": 200,\n \"message\": \"Success\",\n \"data\": {\n \"supplierdetails\": [\n {\n \"suppliername\": \"VISION INFRA EQUIPMENTS PRIVATE LIMITED\",\n \"suppliercode\": \"HLLVENDORS01\",\n \"supplieraccountname\": \"Vision Infra Equipments\",\n \"supplieraccountno\": \"792909792225\",\n \"supplierbankaccountname\": \"HDFC\",\n \"supplierbankaccountbranchname\": \"Productivity Road\",\n \"supplierbankaccountifsccode\": \"HDFC0001241\",\n \"supplierbankaccounttype\": \"Current\",\n \"suppliermappingstatus\": \"Approved\",\n \"psbprogramidentifier\": \"PSBPGL-PID-0008\",\n \"lenderpsbplatformid\": \"LENDER0004\",\n \"lendername\": \"CENTRAL BANK OF INDIA\"\n }\n ]\n }\n}\n\n{\n \"code\": 404,\n \"message\": \"No supplier records found\",\n \"data\": {}\n}\n\nClient sends a request with psbprogramidentifier.
\nSystem validates the API authentication credentials.
\nSystem verifies that the program belongs to a PSB Xchange PID program.
\nPlatform retrieves suppliers mapped to the program.
\nAPI returns supplier details along with lender mapping information.
\nThe Get Supplier Status API is used to fetch the current status and mapped details of a supplier under a specific PID program on PSB Xchange.
\nApplicability: This API is only applicable for PID Programs active on PSB Xchange.
\nThis API enables the fintech/client system to retrieve supplier-level onboarding and mapping status details for a given PID program and supplier code. It helps identify whether the supplier is mapped, pending, approved, or in another status state, along with the associated bank and lender details.
\n{\n \"psbprogramidentifier\": \"PSBPGL-PID-0008\",\n \"suppliercode\": \"TESTSUPPLIERCODE0303202605\"\n}\n\n{\n \"code\": 200,\n \"message\": \"Success\",\n \"data\": {\n \"supplierbankaccountname\": \"Bank\",\n \"supplierpan\": \"AANCA5471H\",\n \"supplierbankaccountifsccode\": \"HDFC0001241\",\n \"supplierbankaccounttype\": \"Current\",\n \"supplierbankaccountbranchname\": \"Productivity Road Branch\",\n \"supplieraccountno\": \"452677829926\",\n \"suppliername\": \"AEOLUS TYRE INDIA OPC PRIVATE LIMITED\",\n \"supplieraccountname\": \"Test Aeolus Tyre\",\n \"lendername\": \"CENTRAL BANK OF INDIA\",\n \"suppliercode\": \"TESTSUPPLIERCODE0303202605\",\n \"supplierleicode\": \"\",\n \"suppliermappingstatus\": \"Pending\",\n \"lenderpsbplatformid\": \"LENDER0004\"\n }\n}\n\ndata Object Field DefinitionsThis folder contains APIs which are specific to PID Product
\n","_postman_id":"85f8f38e-2d53-442c-b658-a233cb6ef8a8"},{"name":"Transaction Status Callback","id":"13521a1e-42c6-4d3f-a19f-edd8dd9793d5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"accept","value":"application/json, application/xml, text/xml, application/*+json, application/*+xml"},{"key":"accept-encoding","value":"gzip"},{"key":"api-key","value":"BdW9J0sxrim78v9qhVcgsEa5K89ksHRSpVb-_"},{"key":"content-length","value":"372"},{"key":"content-type","value":"application/json"},{"key":"testfintech","value":"testvalue12345"},{"key":"testfintech2","value":"testvalues123445"},{"key":"user-agent","value":"Java/21.0.8"}],"body":{"mode":"raw","raw":"{\n \"code\": 9999,\n \"message\": \"Rejected\",\n \"data\": {\n \"psbtransactionbatchreferenceno\": \"2c9465d2-c466-4c03-ad5f-5efa8779c0de\",\n \"transactionfinancerequestid\": \"FINTEST1602202602\",\n \"sptransactionbatchreferenceno\": \"BATCHTEST16FEB002\",\n \"transactioninvoicenumber\": \"INVTEST1602202602\",\n \"status\": \"Rejected\",\n \"errorresponse\": [\n {\n \"statuscode\": 1209,\n \"remark\": \"Invoice Date should not be future date\"\n }\n ]\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://psbxchange.free.beeceptor.com/transactionstatuscallback","description":"This callback endpoint is used to receive transaction status notifications from the PSB Xchange platform. When a transaction's status changes (e.g., approved, rejected, or processed), the system sends a POST request to this callback URL to notify the integrated fintech or sourcing partner about the transaction outcome. This enables real-time status synchronization between PSB Xchange and partner systems.
\nMethod: POST
URL: https://psbxchange.free.beeceptor.com/transactionstatuscallback
Each object in the errorresponse array contains:
{\n \"code\": 9999,\n \"message\": \"Rejected\",\n \"data\": {\n \"psbtransactionbatchreferenceno\": \"2c9465d2-c466-4c03-ad5f-5efa8779c0de\",\n \"transactionfinancerequestid\": \"FINTEST1602202602\",\n \"sptransactionbatchreferenceno\": \"BATCHTEST16FEB002\",\n \"transactioninvoicenumber\": \"INVTEST1602202602\",\n \"status\": \"Rejected\",\n \"errorresponse\": [\n {\n \"statuscode\": 1209,\n \"remark\": \"Invoice Date should not be future date\"\n }\n ]\n }\n}\n\nThe receiving system should validate the api-key header before processing the callback
Multiple errors can be returned in the errorresponse array if multiple validation failures occur
The callback should return an appropriate HTTP status code (e.g., 200 OK) to acknowledge receipt
This callback receives repayment transaction details and limit updates from the LMS system.
\nEach object in the transactionDetails array contains:
Each object in the remark array represents an individual invoice setoff:
{\n \"outstandinglimit\": 2465.95,\n \"utilizedlimit\": 2420.87,\n \"availablelimit\": 3497379.13,\n \"lmsloanaccountno\": \"12345718911\",\n \"psbidentifier\": \"PSBCPL-DF-0003-0003\",\n \"transactionDetails\": [\n {\n \"transactionreferencenumber\": \"TESTTRANSACTIONREFERENCENO123\",\n \"transactionamount\": \"10000.0\",\n \"remark\": [\n {\n \"date\": \"2026-02-16\",\n \"Setoff\": \"0.6\",\n \"invoiceId\": \"14540\",\n \"invoiceNumber\": \"INVTEST12092025021\",\n \"Balance\": \"0.0\",\n \"particulars\": \"Interest Posting for invoice INVTEST12092025021 of ₹0.60\"\n },\n {\n \"date\": \"2026-02-16\",\n \"Setoff\": \"3.21\",\n \"invoiceId\": \"12593\",\n \"invoiceNumber\": \"INVTEST03062025027\",\n \"Balance\": \"0.0\",\n \"particulars\": \"Interest Posting for invoice INVTEST03062025027 of ₹3.21\"\n }\n ]\n }\n ]\n}\n\nRepayment Processing: This callback is triggered when a repayment is processed against a channel partner's loan account.
\nInvoice Setoff: Each remark entry represents how the repayment amount is distributed across individual invoices (interest postings, principal adjustments, etc.).
\nLimit Updates: The outstandinglimit, utilizedlimit, and availablelimit fields reflect the updated limit status after the repayment is processed.
Multiple Invoices: A single transaction can set off amounts against multiple invoices, as shown in the remark array.
Generated from cURL: curl --request POST
--url 'https://psbxchange.free.beeceptor.com/transactionstatuscallback'
--header 'accept: application/json, application/xml, text/xml, application/+json, application/+xml'
--header 'accept-encoding: gzip'
--header 'api-key: BdW9J0sxrim78v9qhVcgsEa5K89ksHRSpVb-_'
--header 'content-length: 470'
--header 'content-type: application/json'
--header 'testfintech: testvalue12345'
--header 'testfintech2: testvalues123445'
--header 'user-agent: Java/21.0.8'
--data-raw '{\"data\":[{\"sanctionedlimit\":3500000,\"utilizedlimit\":2420.87,\"availablelimit\":3497379.13,\"sanctiondate\":\"05-02-2025\",\"pipelinelimit\":200.0,\"limitexpirydate\":\"21-02-2030\",\"psbprogramname\":\"Mazgaon Dockyard\",\"psbchannelpartnername\":\"V C GREEN ENERGY PRIVATE LIMITED\",\"psbanchorname\":\"MAZAGON DOCK SHIPBUILDERS LIMITED\",\"psbchannelpartneridentifier\":\"PSBCPL-DF-0003-0003\",\"lmsstatus\":\"Active\",\"lmslimitstatus\":\"Approved\",\"lmsnpastatus\":\"No\"}],\"code\":200,\"message\":\"success\"}'
This callback receives program details updates. The request body structure is identical to the Get Program Details API response.
\n\n\n","urlObject":{"protocol":"https","path":["transactionstatuscallback"],"host":["psbxchange","free","beeceptor","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"0a20b90d-b1f9-4062-952a-ea956cf7e536"},{"name":"Channel Partner Update Callback","id":"d87fc6f7-0d59-47c5-888f-b2b36597c099","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"accept","value":"application/json, application/xml, text/xml, application/*+json, application/*+xml"},{"key":"accept-encoding","value":"gzip"},{"key":"content-length","value":"2125"},{"key":"content-type","value":"application/json"},{"key":"testfintech","value":"testvalue12345"},{"key":"testfintech2","value":"testvalues123445"},{"key":"user-agent","value":"Java/21.0.8"}],"body":{"mode":"raw","raw":"{\n \"lendername\": \"CENTRAL BANK OF INDIA\",\n \"lmscpgraceperioddays\": 10,\n \"lmscpmargin\": 0.0,\n \"lmscppenaloptionalinterestrate\": 2.0,\n \"lmscpstopsupplydays\": 7,\n \"tmscprequestid\": \"7df56b53-6967-492a-8914-38628c69183c\",\n \"lmscpactivationdate\": \"07-02-2025\",\n \"psbprogramidentifier\": \"PSBPGL-DF-0003\",\n \"psbchannelpartneridentifier\": \"PSBCPL-DF-0003-0004\",\n \"lmsanchorname\": \"Mazgaon & Dockyard\",\n \"lmsproductcode\": \"\",\n \"lenderprogramprogramname\": \"Mazgaon Dockyard\",\n \"lmscpname\": \"THE INDIAN HUME PIPE COMPANY LIMITED\",\n \"lmscproibenchmarkcode\": \"Sanity Base Rate\",\n \"lmscpinteresttype\": \"Monthly\",\n \"lendercpmappinggraceperiodindays\": 10,\n \"lendercpmappingstopsupplydays\": 7,\n \"lendercpmappingpenalcharges\": 2.0,\n \"lmscompanystatus\": \"Approved\",\n \"lendercpmappingchannelpartnerlimit\": 7000000,\n \"lendercpmappingoutstandinglimit\": 5695.46,\n \"lendercpmappingunutilizedlimit\": 6782304.54,\n \"lmssanctiondate\": \"07-02-2025\",\n \"lmsstatus\": \"Active\",\n \"lmsnpastatus\": \"No\",\n \"lmslimitreviewdate\": \"21-02-2030\",\n \"lmsloanaccountno\": \"843434423\",\n \"lmsautoapprovebybankconfig\": \"No\",\n \"lmslimitexpirydate\": \"21-02-2030\",\n \"lendercpmappingcptenor\": 10,\n \"lmsgraceperiodoninterest\": 10,\n \"lmsmappingpenalinterestoninterest\": 2.0,\n \"lmsmappingoverduespread\": 1.0,\n \"lmsmappingeligibilitypercentage\": 100.0,\n \"lendercpmappingmargin\": 0.0,\n \"lendercpmappingcurrentbenchmarkrate\": 1.0,\n \"lmsmappingmaturityhandling\": \"Prepone To Previous Working Day\",\n \"lmsmappingidentifier\": \"8fd3e0c0-e541-11ef-9d21-d58a4a5b90a4\",\n \"lmslenderprogramidentifier\": \"41d2a940-ded8-11ef-a5e4-9727cb7de555\",\n \"lmsmappingautorequestfinance\": \"Yes\",\n \"lmsmappingconfigasperprogram\": \"Yes\",\n \"lmsmappingresetfrequencydays\": 90,\n \"lmsmappinggraceperiodinterestrate\": 1.0,\n \"lmsmappinginterestonpostedinterest\": 0.0,\n \"lmsmappingaccountdetails\": [\n {\n \"accountName\": \"Indian Hume HDFC Bank\",\n \"accountNo\": \"6342348685\",\n \"ifscCode\": \"HDFC0001241\",\n \"bankName\": \"HDFC\",\n \"branchName\": \"Productivity House Branch \",\n \"accountType\": \"Current Account\",\n \"activeStatus\": \"Active\"\n }\n ],\n \"lmscpstatus\": \"Approved\",\n \"lmscpinterestrate\": [\n {\n \"fromDays\": 1,\n \"toDays\": 90,\n \"interest\": 9.8,\n \"roi\": 10.8,\n \"dis_credit_spread\": 6.4,\n \"dis_business_spread\": 3.4,\n \"interest_bearing\": \"Dealer Bearing\"\n }\n ],\n \"lmsmappinganchoraccountno\": [\n {\n \"anchorAcc\": \"123456789123\"\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"https://psbxchange.free.beeceptor.com/transactionstatuscallback","description":"Note: This request body structure is aligned with the Get Program Details API response for consistency across the platform.
\n
This callback receives channel partner (CP) mapping details updates from the LMS system.
\nField: lmscpinterestrate
Type: Array of Objects
Description: Interest rate slabs based on financing duration
Example:
\n\"lmscpinterestrate\": [\n {\n \"fromDays\": 1,\n \"toDays\": 90,\n \"interest\": 9.8,\n \"roi\": 10.8,\n \"dis_credit_spread\": 6.4,\n \"dis_business_spread\": 3.4,\n \"interest_bearing\": \"Dealer Bearing\"\n }\n]\n\nField: lmsmappingaccountdetails
Type: Array of Objects
Description: Bank account details of the channel partner for disbursement
Example:
\n\"lmsmappingaccountdetails\": [\n {\n \"accountName\": \"Indian Hume HDFC Bank\",\n \"accountNo\": \"6342348685\",\n \"ifscCode\": \"HDFC0001241\",\n \"bankName\": \"HDFC\",\n \"branchName\": \"Productivity House Branch\",\n \"accountType\": \"Current Account\",\n \"activeStatus\": \"Active\"\n }\n]\n\nField: lmsmappinganchoraccountno
Type: Array of Objects
Description: Anchor's account number(s) linked to this CP mapping
Example:
\n\"lmsmappinganchoraccountno\": [\n {\n \"anchorAcc\": \"123456789123\"\n }\n]\n\n{\n \"lendername\": \"CENTRAL BANK OF INDIA\",\n \"lmscpgraceperioddays\": 10,\n \"lmscpmargin\": 0,\n \"lmscppenaloptionalinterestrate\": 2,\n \"lmscpstopsupplydays\": 7,\n \"tmscprequestid\": \"7df56b53-6967-492a-8914-38628c69183c\",\n \"lmscpactivationdate\": \"07-02-2025\",\n \"psbprogramidentifier\": \"PSBPGL-DF-0003\",\n \"psbchannelpartneridentifier\": \"PSBCPL-DF-0003-0004\",\n \"lmsanchorname\": \"Mazgaon & Dockyard\",\n \"lmsproductcode\": \"\",\n \"lenderprogramprogramname\": \"Mazgaon Dockyard\",\n \"lmscpname\": \"THE INDIAN HUME PIPE COMPANY LIMITED\",\n \"lmscproibenchmarkcode\": \"Sanity Base Rate\",\n \"lmscpinteresttype\": \"Monthly\",\n \"lendercpmappinggraceperiodindays\": 10,\n \"lendercpmappingstopsupplydays\": 7,\n \"lendercpmappingpenalcharges\": 2,\n \"lmscompanystatus\": \"Approved\",\n \"lendercpmappingchannelpartnerlimit\": 7000000,\n \"lendercpmappingoutstandinglimit\": 5695.46,\n \"lendercpmappingunutilizedlimit\": 6782304.54,\n \"lmssanctiondate\": \"07-02-2025\",\n \"lmsstatus\": \"Active\",\n \"lmsnpastatus\": \"No\",\n \"lmslimitreviewdate\": \"21-02-2030\",\n \"lmsloanaccountno\": \"843434423\",\n \"lmsautoapprovebybankconfig\": \"No\",\n \"lmslimitexpirydate\": \"21-02-2030\",\n \"lendercpmappingcptenor\": 10,\n \"lmsgraceperiodoninterest\": 10,\n \"lmsmappingpenalinterestoninterest\": 2,\n \"lmsmappingoverduespread\": 1,\n \"lmsmappingeligibilitypercentage\": 100,\n \"lendercpmappingmargin\": 0,\n \"lendercpmappingcurrentbenchmarkrate\": 1,\n \"lmsmappingmaturityhandling\": \"Prepone To Previous Working Day\",\n \"lmsmappingidentifier\": \"8fd3e0c0-e541-11ef-9d21-d58a4a5b90a4\",\n \"lmslenderprogramidentifier\": \"41d2a940-ded8-11ef-a5e4-9727cb7de555\",\n \"lmsmappingautorequestfinance\": \"Yes\",\n \"lmsmappingconfigasperprogram\": \"Yes\",\n \"lmsmappingresetfrequencydays\": 90,\n \"lmsmappinggraceperiodinterestrate\": 1,\n \"lmsmappinginterestonpostedinterest\": 0,\n \"lmsmappingaccountdetails\": [...],\n \"lmscpstatus\": \"Approved\",\n \"lmscpinterestrate\": [...],\n \"lmsmappinganchoraccountno\": [...]\n}\n\nThis is a POST callback API used by the PSB Xchange platform to notify integrated fintech/lender systems about supplier (vendor) status updates. When a supplier's onboarding or mapping status changes on the PSB Xchange platform (e.g., approved, rejected, or pending), this callback is triggered to push the updated status details to the registered callback endpoint.
\nThis is only applicable for PID Programs active on PSB Xchange
\nPOST https://psbxchange.free.beeceptor.com/transactionstatuscallback\n\nThe request body is a JSON object containing supplier details, bank account information, lender details, and the status update.
\nerrorResponse Object Fields{\n \"suppliername\": \"JAYPORE ECOMMERCE PRIVATE LIMITED\",\n \"suppliercode\": \"TESTSUPPLIERCODE1003202602\",\n \"supplierleicode\": \"\",\n \"supplieraccountname\": \"Test JAYPORE ECOMMERCE\",\n \"supplieraccountno\": \"6629980887\",\n \"supplierbankaccountname\": \"External\",\n \"supplierbankaccountbranchname\": \"Productivity Road Branch\",\n \"supplierbankaccountifsccode\": \"HDFC0001241\",\n \"supplierbankaccounttype\": \"Current\",\n \"suppliermappingstatus\": \"Active\",\n \"statusmessage\": \"Approved\",\n \"lenderpsbplatformid\": \"LENDER0004\",\n \"lendername\": \"CENTRAL BANK OF INDIA\",\n \"errorResponse\": [\n {\n \"statusCode\": 2000,\n \"remark\": \"PID Vendor approved successfully.\"\n }\n ]\n}\n\nThis is a POST callback API used to notify fintech/lender systems about buyer status updates on the PSB Xchange platform. This callback is triggered and sent from PSB Xchange to the fintech/lender system whenever a buyer's mapping status is created or updated. It carries key details about the buyer, their credit parameters, and the associated lender and program information.
\nThis is only applicable for SID Programs active on PSB Xchange
\nPOST https://webhook.site/162a9232-f97b-4229-999d-5232b1bdcf81\n\n{\n \"buyername\": \"THE INDIAN HUME PIPE COMPANY LIMITED\",\n \"buyermaxlimit\": 1000000.0,\n \"buyermaxtenor\": 30,\n \"buyercode\": \"THEIND10032026\",\n \"buyermappingstatus\": \"Active\",\n \"psbprogramidentifier\": \"PSBPGL-SID-0007\",\n \"lenderpsbplatformid\": \"LENDER0004\",\n \"lendername\": \"CENTRAL BANK OF INDIA\"\n}\n\nbuyermaxlimit: Must be a positive numeric value representing the credit limit in INR. Decimal values are accepted.
buyermaxtenor: Must be a positive integer representing the number of days.
buyermappingstatus: Accepted values — Active, Inactive, Pending
psbprogramidentifier: Follows the format PSBPGL-- (e.g., PSBPGL-SID-0007)
buyercode: Typically a combination of buyer name abbreviation and date (e.g., THEIND10032026)