{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"3affb4aa-ac9f-40fe-8311-a18000d55f49","name":"Seedflex Partner APIs","description":"# Seedflex Partner API Collection\n\nThis collection has the APIs that allow Seedflex Partners to integrate with the Seedflex Platform to authenticate, share merchant transaction data, and get credit decisions.\n\n## 🚀 Purpose\n\nEnable seamless and secure embedded credit flows into partner ecosystems using a reliable API facade.\n\n## 🧰 Key Capabilities\n\n- Secure authentication with JWT-based token issuance\n    \n- Settlement and Sales Transactions data upload\n    \n- Credit limit fetch\n    \n- Repayment Postings\n    \n- Get Outstanding Details\n    \n\n## 📦 Environments\n\nUse the **`Seedflex Partner API Sandbox`** environment in Postman with the appropriate `partner_base` URL and token variables configured.\n\n## 🔐 Authentication\n\nAuthenticate using:\n\n- `POST /v1/partner/login` to get `access_token` & `refresh_token`\n    \n- Use `Authorization: Bearer` header for all secured APIs\n    \n\n## 📃 Versioning\n\nCurrent Version: `v1`  \nAll endpoints are prefixed with `/v1/`\n\n## 🧪 How to Test\n\nEach folder contains functional APIs.  \nStart with `1. Auth APIs`, then proceed to `2. Origination APIs.`\n\n## 📞 For Support and 🔐 Sandbox Access\n\nPlease reach out to the Seedflex Partner team\n\n---\n\n### Sandbox Usage Guidelines & Limitations\n\nThe Seedflex sandbox environment is intended for controlled partner integration and testing. The following guidelines ensure optimal use and service continuity:\n\n#### ✅ Allowed Usage\n\n- Simulating credit origination flows via `settlement, sales` and `repayment` endpoints\n    \n- Validating JWT-based authentication and token refresh flows\n    \n- Retrieving credit limit decisions based on merchant identifiers\n    \n\n#### ⛔ Not Permitted\n\n- Load testing or stress testing endpoints\n    \n- Sharing sandbox credentials with third parties\n    \n- Storing or transmitting any real user PII or financial data\n    \n\n#### Logging & Traceability\n\n- All API calls are logged with `requestId` and `partnerId`\n    \n- Logs are retained for audit but not exposed\n    \n- Replay of requests can be requested via support channels\n    \n\n#### Environment Refresh\n\n- Sandbox data is non-persistent and may be cleared without notice\n    \n- Partner environments may be reset weekly or during major updates\n    \n\n## 📥 How to Use Seedflex Partner APIs\n\nThis section will help you get started with authentication, environment setup, and calling your first API using the Seedflex Partner API collection.\n\n✅ 1. Environment Setup\n\nUse the predefined environment: `Seedflex Partner API Sandbox`\n\nIt includes key variables:\n\n| Variable Name | Description |\n| --- | --- |\n| `partner_base` | Base URL of the Seedflex API (e.g., sandbox endpoint) |\n| `PARTNER_ID` | Unique Partner ID assigned during onboarding |\n| `CLIENT_SECRET` | Secret key associated with your account |\n| `JWT_ACCESS_TOKEN` | Issued upon login |\n| `JWT_REFRESH_TOKEN` | Used to renew access without re-login |\n\n---\n\n🔐 2. Authentication Workflow\n\n1. Call `POST /partner/auth/login`  \n    → Send `PARTNER_ID` and `CLIENT_SECRET` in body\n    \n2. Receive:\n    \n    - `access_token`\n        \n    - `refresh_token`\n        \n3. Use this header for all secured APIs:  \n    **Authorization: Bearer** **`{{JWT_ACCESS_TOKEN}}`**\n    \n4. Token expires after `3600s` (1 hour).  \n    Use `/refresh-token` to rotate without logging in again.\n    \n\n---\n\n🔄 3. Testing the API Flow\n\nOnce authenticated:\n\n- Upload transaction data → `settlement OR sales`\n    \n- Upload merchant PII → `merchant-pii-data-upload`\n    \n- Fetch available credit limit → `fetch-limit-by-sme-masked-id`\n    \n\nUse **Postman environment variables** like `{{PARTNER_ID}}` to avoid exposing secrets in the documentation.\n\n---\n\n🛡 4. Security Best Practices\n\n- Use Postman **environments** to manage secrets.\n    \n- Do not hardcode `client_secret` or `access_token`.\n    \n- ✅ Use environment-level variables like `{{JWT_ACCESS_TOKEN}}`\n    \n- 🔁 Rotate tokens securely (can use Pre-request Scripts or Postman Vault)\n    \n- Revoke unused tokens when no longer needed.\n    \n\n---\n\nNOTE: All API keys are case sensitive","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"31622721","team":5921231,"collectionId":"3affb4aa-ac9f-40fe-8311-a18000d55f49","publishedId":"2sB2cd3dLh","public":true,"publicUrl":"https://apidocs.seedflex.tech","privateUrl":"https://go.postman.co/documentation/31622721-3affb4aa-ac9f-40fe-8311-a18000d55f49","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"documentationLayout":"classic-double-column","customisation":{"metaTags":[{"name":"description","value":"Seedflex Partner APIs allow Seedflex Partners to integrate/share their merchant data for Credit decisions."},{"name":"title","value":"Seedflex Partner API Documentation"}],"appearance":{"default":"dark","themes":[{"name":"dark","logo":"https://content.pstmn.io/a3f969eb-4494-4d1c-99e5-c43cb1504a9e/U2VlZGZsZXggU2hvcGlmeSBMb2dvIDEyMDBweC5wbmc=","colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"FF6C37"}},{"name":"light","logo":"https://content.pstmn.io/a3f969eb-4494-4d1c-99e5-c43cb1504a9e/U2VlZGZsZXggU2hvcGlmeSBMb2dvIDEyMDBweC5wbmc=","colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"}}]}},"version":"8.10.1","publishDate":"2025-10-14T17:36:37.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"Seedflex Partner API Documentation","description":"Seedflex Partner APIs allow Seedflex Partners to integrate/share their merchant data for Credit decisions."},"logos":{"logoLight":"https://content.pstmn.io/a3f969eb-4494-4d1c-99e5-c43cb1504a9e/U2VlZGZsZXggU2hvcGlmeSBMb2dvIDEyMDBweC5wbmc=","logoDark":"https://content.pstmn.io/a3f969eb-4494-4d1c-99e5-c43cb1504a9e/U2VlZGZsZXggU2hvcGlmeSBMb2dvIDEyMDBweC5wbmc="}},"statusCode":200},"environments":[{"name":"Seedflex Partner API Sandbox","id":"54df2a25-c8e7-4bae-9e26-9b3c4bfd7675","owner":"31622721","values":[{"key":"partner_base","value":"https://<sandboxenv>/v1","enabled":true,"type":"default"},{"key":"PARTNER_ID","value":"{{PARTNER_ID_FROM_ONBOARDING}}","enabled":true,"type":"default"},{"key":"CLIENT_SECRET","value":"{{SECRET_FROM_PARTNER_ONBOARDING}}","enabled":true,"type":"secret"},{"key":"JWT_REFRESH_TOKEN","value":"{{REFRESH_TOKEN_FROM_LOGIN}}","enabled":true,"type":"secret"},{"key":"JWT_ACCESS_TOKEN","value":"{{ACCESS_TOKEN_FROM_LOGIN}}","enabled":true,"type":"secret"}],"published":true}],"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/739e14b8326261fd2886fcc34a0a7d9ea61a61a47add8ceb2198a53bb7930db4","favicon":"https://seedflex.tech/favicon.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"},{"label":"Seedflex Partner API Sandbox","value":"31622721-54df2a25-c8e7-4bae-9e26-9b3c4bfd7675"}],"canonicalUrl":"https://apidocs.seedflex.tech/view/metadata/2sB2cd3dLh"}