{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"ff7e4c12-98cf-4dac-87a0-919c8eb29e8f","name":"PSB Xchange - Transaction API Suite","description":"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:\n\n| **Category** | **Details** |\n| --- | --- |\n| **Applicable Products for PSB Xchange Transaction API Suite** | Dealer Finance (DF) |\n| **Different Types of Lead Possible** | Program Lead (PGL)  <br>Channel Partner Lead (CPL) |\n| **What is a Program Lead ?** | For any **Anchor Led Financing** or **Non Anchor Financing** facility a Program needs to be setup on the Anchor/Corporate.  <br>In **Anchor Led Financing (Dealer Finance / Vendor Finance)**, the program governs broad criterias to onboard Channel Partners (associated with the Program).  <br>In **Non Anchor Led Financing** , the program created is actually the limit/facility setup on the Corporate |\n| **What is a Channel Partner Lead ?** | **Channel Partner Lead** is used to refer to Leads of Dealers / Distributors / Suppliers associated with a Program (Dealer Finance / Vendor Finance) |\n| **Applicable Products for Program Lead (PGL)** | Dealer Finance (DF)  <br>Vendor Finance (VF)  <br>Sales Invoice Discounting (SID)  <br>Purchase Invoice Discounting (PID)  <br>Factoring (FACT)  <br>Reverse Factoring (REVFACT) |\n| **Applicable Products for Channel Partner Lead (CPL)** | Dealer Finance (DF)  <br>Vendor Finance (VF) |\n\n**Pre-Requisites for PSB Xchange Sourcing Partner API Integrations:**\n\n1. The sourcing partner will need to share the the list of IP addresses which need to be whitelisted for both UAT / Production environments.\n    \n2. Sourcing partner to expose webhooks to consume the following details from PSB Xchange Platform: a) [Transaction Status API webhook](https://drive.google.com/file/d/1rU8IrM7fdoDaNjIxklB4eR3yY_9awBZQ/view?usp=drive_link)\n    \n\nb) [Repayment Details webhook](https://drive.google.com/file/d/19vDQO-4SZJSL09_UbCaFqzLWIUPxc_u3/view?usp=drive_link)\n\nc) [Multiple limit webhook](https://drive.google.com/file/d/1wkAylG2wobQwBBB33p1Rl3_JGK-agS4p/view?usp=drive_link)\n\nReach out to [anuj@psbxchange.com](https://mailto:anuj@psbxchange.com) / [parul@psbxchange.com](https://mailto: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.\n\nTransaction API Token can be accessed by the Sourcing Partner by visiting PSB Xchange Platform and navigating to Platform Configurations.\n\n**Standard Error Codes for PSB Xchange Transaction APIs:**\n\n| **Error Code** | **Error Message** |\n| --- | --- |\n| 6031 | ${data} |\n| 6032 | ${data} |\n| 6033 | Channel Partner Mapping not active in PSB Xchange Platform |\n| 6034 | Channel Partner Mapping not present in PSB Xchange Platform for the Program Provided |\n| 6035 | Sourcing Partner Not Active on PSB Xchange Platform |\n| 6036 | Duplicate Sourcing Partner PSB Platform ID found in PSB Xchange |\n| 6037 | Product Not Active for Souricng Partner on PSB Xchange Platform |\n| 6038 | Program not Active on PSB Xchange Platform |\n| 6039 | Technical Issue encountered. Please reach out to PSB Xchange Representative |\n| 6040 | Batch ID not found in PSB Xchange Platform |\n| 6041 | Channel Partner PSB Platform Identifier not provided as part of Request |\n| 6042 | Channel Partner or Program Identifier found missing as part of request |\n| 6043 | Invalid PSB Platform Program Identifier provided |\n| 6044 | Invalid PSB Platform Program Identifier provided |\n| 6045 | Program does not exist for the PSB Platform Program Identifier provided |\n| 6046 | Transactional API Configuration not present for the Sourcing Partner on PSB Xchange |\n| 6047 | Invalid Fintech code. Fintech Code not found on PSB Xchange |\n| 6048 | Invalid Payload Found. Please contact PSB Xchange Admin |\n| 6049 | Transaction Invoice date cannot be a future date or Zero Or Negative |\n| 6050 | Transaction Finance Request Amount Cannot be Zero Or Negative |\n| 6051 | Transaction Finance Request Amount Cannot Be Greater Than Transaction Invoice Amount |\n| 6052 | Transaction invoice Number is Invalid |\n| 6053 | Transaction Finance Request Id is Invalid |\n| 6054 | Finance Request Amount exceeds the sanctioned Limit for the Channel Partner |\n| 6055 | Finance Request Amount exceeds Limit Available for the Channel Partner |\n| 6056 | Finance Request Amount exceeds the sanctioned Limit for the Program |\n| 6057 | Finance Request Amount exceeds Limit Available for the Program |\n| 6058 | Lender Transaction API Token Not Found. Please contact PSB Xchange Admin |\n| 6059 | Data should be in correct format. |\n| 6060 | Data cannot be empty. |\n| 6061 | sptransactionbatchreferenceno is invalid |\n| 6062 | transactioninvoicenumber is invalid |\n| 6063 | transactioninvoicedate is invalid |\n| 6064 | transactioninvoiceamount is invalid |\n| 6065 | transactionfinancerequestamount is invalid |\n| 6066 | transactionfinancerequestdate is invalid |\n| 6067 | transactioninvoiceduedate is invalid |\n| 6068 | transactionfinancerequestid is invalid |\n| 6069 | Data cannot be empty. |\n| 6070 | sptransactionbatchreferenceno is invalid |\n| 6071 | transactioninvoicenumber is invalid |\n| 6072 | transactioninvoicedate is invalid |\n| 6073 | transactioninvoiceamount is invalid |\n| 6074 | transactionfinancerequestamount is invalid |\n| 6075 | transactionfinancerequestdate is invalid |\n| 6076 | transactioninvoiceduedate is invalid |\n| 6077 | transactionfinancerequestid is invalid |\n| 6079 | ${data} |\n| 6080 | ${data} |\n| 6081 | Required field Data is empty! |\n| 6082 | Transaction batch reference id is empty! |\n| 6083 | Batch_id not found |\n| 6084 | Invalid request, required fields are missing |\n| 6085 | ${data} |\n| 6086 | ${data} |\n| 6087 | API FAILED From Server Side |\n| 6088 | Invalid PSB Platform Program Identifier or PSB Platform Channel Partner Mapping Identifier received in Callback |\n| 6089 | Data is empty in request body |\n| 6090 | Duplicate Id(s) found: {0} |\n| 6091 | No channel data found in response |\n| 6092 | No Limit data found in response |\n| 6093 | ${data} |\n| 6094 | Date Validation Failed In Initiate Transaction With Transaction Finance Request Id: {0} |\n| 6095 | Initiate Transaction Validation Failed: {0} |\n| 6096 | Unable To Fetch Limit For :${data} |","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":true,"owner":"22805895","team":4148165,"collectionId":"ff7e4c12-98cf-4dac-87a0-919c8eb29e8f","publishedId":"2sAYQggTQk","public":true,"publicUrl":"https://documenter-api.postman.tech/view/22805895/2sAYQggTQk","privateUrl":"https://go.postman.co/documentation/22805895-ff7e4c12-98cf-4dac-87a0-919c8eb29e8f","customColor":{"top-bar":"F5f5f9","right-sidebar":"000000","highlight":"000000"},"documentationLayout":"classic-double-column","customisation":{"metaTags":[{"name":"description","value":""},{"name":"title","value":""}],"appearance":{"default":"light","themes":[{"name":"dark","logo":"https://content.pstmn.io/f7aa2ed3-5a3f-4d9e-856a-d7360cb30770/cHNibG9nb3YyLnBuZw==","colors":{"top-bar":"f5f5f9","right-sidebar":"000000","highlight":"000000"}},{"name":"light","logo":"https://content.pstmn.io/f7aa2ed3-5a3f-4d9e-856a-d7360cb30770/cHNibG9nb3YyLnBuZw==","colors":{"top-bar":"F5f5f9","right-sidebar":"000000","highlight":"000000"}}]}},"version":"8.11.4","publishDate":"2025-10-23T12:18:41.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"","description":""},"logos":{"logoLight":"https://content.pstmn.io/f7aa2ed3-5a3f-4d9e-856a-d7360cb30770/cHNibG9nb3YyLnBuZw==","logoDark":"https://content.pstmn.io/f7aa2ed3-5a3f-4d9e-856a-d7360cb30770/cHNibG9nb3YyLnBuZw=="}},"statusCode":200},"environments":[],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/4a20331349772507efc90cc5fdc782c7a74ca90c76aeca600e394aa989cfed45","favicon":"https://res.cloudinary.com/postman/image/upload/v1753071919/team/ba5712c0b105e56ba97804e5e0311e92.ico"},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"}],"canonicalUrl":"https://documenter.gw.postman.com/view/metadata/2sAYQggTQk"}