{ "info": { "_postman_id": "b7fb3c3c-dfc8-43d9-b56c-9cb012ecce65", "name": "N3XT API Documentation Approvals Payments API", "description": "A holistic banking API for businesses.\n\nFind the swagger definition file at /docs/swagger.json.\n\nContact Support:\n Name: N3XT Support", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "createdAt": "2026-07-28T02:15:37.000Z", "updatedAt": "2026-07-28T02:15:37.000Z", "lastUpdatedBy": "35240", "uid": "35240-b7fb3c3c-dfc8-43d9-b56c-9cb012ecce65" }, "item": [ { "name": "payments", "item": [ { "name": "instant", "item": [ { "name": "Instant Payment", "id": "0b846ff3-eb7f-4471-8b7b-955a24eff5bc", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"amount\": \"\",\n \"senderWalletId\": \"\",\n \"recipientBusinessId\": \"\",\n \"description\": \"\",\n \"recipientWalletAddress\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/payments/instant", "host": [ "{{baseUrl}}" ], "path": [ "payments", "instant" ] }, "description": "Allows the authenticated user to create an instant payment to a business.\nOptionally provide recipientWalletAddress to send to a specific wallet of that business (address must belong to the business)." }, "response": [ { "id": "2229afe2-36f7-4c93-8e2c-2084790ad259", "name": "The payment was created successfully.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"amount\": \"\",\n \"senderWalletId\": \"\",\n \"recipientBusinessId\": \"\",\n \"description\": \"\",\n \"recipientWalletAddress\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/payments/instant", "host": [ "{{baseUrl}}" ], "path": [ "payments", "instant" ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"id\": \"\"\n}", "createdAt": "2026-07-28T02:15:37.000Z", "updatedAt": "2026-07-28T02:15:37.000Z", "uid": "35240-2229afe2-36f7-4c93-8e2c-2084790ad259" }, { "id": "748acc71-5d93-4a84-a56a-9abd84fca13c", "name": "Bad Request - Invalid request parameters.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"amount\": \"\",\n \"senderWalletId\": \"\",\n \"recipientBusinessId\": \"\",\n \"description\": \"\",\n \"recipientWalletAddress\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/payments/instant", "host": [ "{{baseUrl}}" ], "path": [ "payments", "instant" ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": \"\"\n}", "createdAt": "2026-07-28T02:15:37.000Z", "updatedAt": "2026-07-28T02:15:37.000Z", "uid": "35240-748acc71-5d93-4a84-a56a-9abd84fca13c" }, { "id": "73ab25a3-a3d9-42b3-af95-bc8b2900d408", "name": "Unauthorized - Invalid or missing authentication token.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"amount\": \"\",\n \"senderWalletId\": \"\",\n \"recipientBusinessId\": \"\",\n \"description\": \"\",\n \"recipientWalletAddress\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/payments/instant", "host": [ "{{baseUrl}}" ], "path": [ "payments", "instant" ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": \"\"\n}", "createdAt": "2026-07-28T02:15:37.000Z", "updatedAt": "2026-07-28T02:15:37.000Z", "uid": "35240-73ab25a3-a3d9-42b3-af95-bc8b2900d408" }, { "id": "f5c02510-686f-443f-b0a5-e4ca2a21efe0", "name": "Forbidden - Insufficient permissions to perform this action.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"amount\": \"\",\n \"senderWalletId\": \"\",\n \"recipientBusinessId\": \"\",\n \"description\": \"\",\n \"recipientWalletAddress\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/payments/instant", "host": [ "{{baseUrl}}" ], "path": [ "payments", "instant" ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": \"\"\n}", "createdAt": "2026-07-28T02:15:37.000Z", "updatedAt": "2026-07-28T02:15:37.000Z", "uid": "35240-f5c02510-686f-443f-b0a5-e4ca2a21efe0" }, { "id": "3e5d2fa5-9268-4352-9787-ab42ee0c7752", "name": "Not Found - Requested resource was not found.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"amount\": \"\",\n \"senderWalletId\": \"\",\n \"recipientBusinessId\": \"\",\n \"description\": \"\",\n \"recipientWalletAddress\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/payments/instant", "host": [ "{{baseUrl}}" ], "path": [ "payments", "instant" ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": \"\"\n}", "createdAt": "2026-07-28T02:15:37.000Z", "updatedAt": "2026-07-28T02:15:37.000Z", "uid": "35240-3e5d2fa5-9268-4352-9787-ab42ee0c7752" }, { "id": "d024c43c-d1b2-490f-9e74-a2c4b8c8417b", "name": "Unprocessable Entity - Validation failed for the request body.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"amount\": \"\",\n \"senderWalletId\": \"\",\n \"recipientBusinessId\": \"\",\n \"description\": \"\",\n \"recipientWalletAddress\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/payments/instant", "host": [ "{{baseUrl}}" ], "path": [ "payments", "instant" ] } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": \"\"\n}", "createdAt": "2026-07-28T02:15:37.000Z", "updatedAt": "2026-07-28T02:15:37.000Z", "uid": "35240-d024c43c-d1b2-490f-9e74-a2c4b8c8417b" }, { "id": "ef594f07-92ae-4133-91ce-bf22b0ac98ea", "name": "Internal Server Error - An unexpected error occurred while processing the request.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"amount\": \"\",\n \"senderWalletId\": \"\",\n \"recipientBusinessId\": \"\",\n \"description\": \"\",\n \"recipientWalletAddress\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/payments/instant", "host": [ "{{baseUrl}}" ], "path": [ "payments", "instant" ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": \"\"\n}", "createdAt": "2026-07-28T02:15:37.000Z", "updatedAt": "2026-07-28T02:15:37.000Z", "uid": "35240-ef594f07-92ae-4133-91ce-bf22b0ac98ea" } ], "createdAt": "2026-07-28T02:15:37.000Z", "updatedAt": "2026-07-28T02:15:37.000Z", "uid": "35240-0b846ff3-eb7f-4471-8b7b-955a24eff5bc" } ], "id": "57a7ae99-5966-48a7-a0c4-2047db1750db", "createdAt": "2026-07-28T02:15:37.000Z", "updatedAt": "2026-07-28T02:15:37.000Z", "uid": "35240-57a7ae99-5966-48a7-a0c4-2047db1750db" }, { "name": "request", "item": [ { "name": "{id}", "item": [ { "name": "Update Payment Request Status", "id": "5a45d8a9-c7f0-4e09-aaa2-23931c7e559a", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}", "type": "string" } ] }, "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"status\": \"cancelled\",\n \"recipientWalletId\": \"\",\n \"senderWalletId\": \"\",\n \"reason\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/payments/request/:id", "host": [ "{{baseUrl}}" ], "path": [ "payments", "request", ":id" ], "variable": [ { "id": "28e6a545-4212-461b-868d-1ac0292910bc", "key": "id", "value": "", "description": "(Required) The ID of the payment request to update." } ] }, "description": "Update the status of a payment request." }, "response": [ { "id": "d17ad79c-2b4c-404e-b350-5b3f41f0e44f", "name": "The payment request status was updated successfully.", "originalRequest": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"status\": \"cancelled\",\n \"recipientWalletId\": \"\",\n \"senderWalletId\": \"\",\n \"reason\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/payments/request/:id", "host": [ "{{baseUrl}}" ], "path": [ "payments", "request", ":id" ], "variable": [ { "key": "id" } ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{}", "createdAt": "2026-07-28T02:15:37.000Z", "updatedAt": "2026-07-28T02:15:37.000Z", "uid": "35240-d17ad79c-2b4c-404e-b350-5b3f41f0e44f" }, { "id": "860de69f-d314-4fbb-b2ea-89f899b495c5", "name": "Bad Request - Invalid request body.", "originalRequest": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"status\": \"cancelled\",\n \"recipientWalletId\": \"\",\n \"senderWalletId\": \"\",\n \"reason\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/payments/request/:id", "host": [ "{{baseUrl}}" ], "path": [ "payments", "request", ":id" ], "variable": [ { "key": "id" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": \"\"\n}", "createdAt": "2026-07-28T02:15:37.000Z", "updatedAt": "2026-07-28T02:15:37.000Z", "uid": "35240-860de69f-d314-4fbb-b2ea-89f899b495c5" }, { "id": "2feaf25e-702a-42be-a481-ba472b865199", "name": "Unauthorized - Invalid or missing authentication token.", "originalRequest": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"status\": \"cancelled\",\n \"recipientWalletId\": \"\",\n \"senderWalletId\": \"\",\n \"reason\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/payments/request/:id", "host": [ "{{baseUrl}}" ], "path": [ "payments", "request", ":id" ], "variable": [ { "key": "id" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": \"\"\n}", "createdAt": "2026-07-28T02:15:37.000Z", "updatedAt": "2026-07-28T02:15:37.000Z", "uid": "35240-2feaf25e-702a-42be-a481-ba472b865199" }, { "id": "690b951d-f482-4f18-b7b3-59bc9b0555b6", "name": "Forbidden - User does not have permission to update this payment request.", "originalRequest": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"status\": \"cancelled\",\n \"recipientWalletId\": \"\",\n \"senderWalletId\": \"\",\n \"reason\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/payments/request/:id", "host": [ "{{baseUrl}}" ], "path": [ "payments", "request", ":id" ], "variable": [ { "key": "id" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": \"\"\n}", "createdAt": "2026-07-28T02:15:37.000Z", "updatedAt": "2026-07-28T02:15:37.000Z", "uid": "35240-690b951d-f482-4f18-b7b3-59bc9b0555b6" }, { "id": "b33ba78e-aacb-4c85-893e-03d07f844f40", "name": "Not Found - The specified payment request was not found.", "originalRequest": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"status\": \"cancelled\",\n \"recipientWalletId\": \"\",\n \"senderWalletId\": \"\",\n \"reason\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/payments/request/:id", "host": [ "{{baseUrl}}" ], "path": [ "payments", "request", ":id" ], "variable": [ { "key": "id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": \"\"\n}", "createdAt": "2026-07-28T02:15:37.000Z", "updatedAt": "2026-07-28T02:15:37.000Z", "uid": "35240-b33ba78e-aacb-4c85-893e-03d07f844f40" }, { "id": "5223a471-5fef-4cad-aa37-4ae02ebfeb56", "name": "An unexpected server error occurred while updating the payment request.", "originalRequest": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"status\": \"cancelled\",\n \"recipientWalletId\": \"\",\n \"senderWalletId\": \"\",\n \"reason\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/payments/request/:id", "host": [ "{{baseUrl}}" ], "path": [ "payments", "request", ":id" ], "variable": [ { "key": "id" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": \"\"\n}", "createdAt": "2026-07-28T02:15:37.000Z", "updatedAt": "2026-07-28T02:15:37.000Z", "uid": "35240-5223a471-5fef-4cad-aa37-4ae02ebfeb56" } ], "createdAt": "2026-07-28T02:15:37.000Z", "updatedAt": "2026-07-28T02:15:37.000Z", "uid": "35240-5a45d8a9-c7f0-4e09-aaa2-23931c7e559a" }, { "name": "Get Payment Request by ID", "id": "0be01bb6-0634-4beb-b71c-016b5275eaf9", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}", "type": "string" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/payments/request/:id", "host": [ "{{baseUrl}}" ], "path": [ "payments", "request", ":id" ], "variable": [ { "id": "e143ee0e-2eb1-4e00-839e-199ed3b7d710", "key": "id", "value": "", "description": "(Required) The ID of the payment request to retrieve." } ] }, "description": "Retrieve a specific payment request by its ID." }, "response": [ { "id": "5b6a4ee7-ef6b-4253-9f92-2dacfe657a43", "name": "The payment request details were retrieved successfully.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/payments/request/:id", "host": [ "{{baseUrl}}" ], "path": [ "payments", "request", ":id" ], "variable": [ { "key": "id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{}", "createdAt": "2026-07-28T02:15:37.000Z", "updatedAt": "2026-07-28T02:15:37.000Z", "uid": "35240-5b6a4ee7-ef6b-4253-9f92-2dacfe657a43" }, { "id": "26ba5608-9492-4636-9486-552b913370bb", "name": "Bad Request - Invalid request parameters.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/payments/request/:id", "host": [ "{{baseUrl}}" ], "path": [ "payments", "request", ":id" ], "variable": [ { "key": "id" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": \"\"\n}", "createdAt": "2026-07-28T02:15:37.000Z", "updatedAt": "2026-07-28T02:15:37.000Z", "uid": "35240-26ba5608-9492-4636-9486-552b913370bb" }, { "id": "7ad0fc5b-c4c1-46df-b504-c6b6e276ad18", "name": "Unauthorized - Invalid or missing authentication token.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/payments/request/:id", "host": [ "{{baseUrl}}" ], "path": [ "payments", "request", ":id" ], "variable": [ { "key": "id" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": \"\"\n}", "createdAt": "2026-07-28T02:15:37.000Z", "updatedAt": "2026-07-28T02:15:37.000Z", "uid": "35240-7ad0fc5b-c4c1-46df-b504-c6b6e276ad18" }, { "id": "eb8c8503-01de-4800-8a00-be8c1b46d3e5", "name": "Forbidden - Insufficient permissions to perform this action.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/payments/request/:id", "host": [ "{{baseUrl}}" ], "path": [ "payments", "request", ":id" ], "variable": [ { "key": "id" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": \"\"\n}", "createdAt": "2026-07-28T02:15:37.000Z", "updatedAt": "2026-07-28T02:15:37.000Z", "uid": "35240-eb8c8503-01de-4800-8a00-be8c1b46d3e5" }, { "id": "7973373b-c126-42c7-9b24-36287c7d7307", "name": "Not Found - Requested resource was not found.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/payments/request/:id", "host": [ "{{baseUrl}}" ], "path": [ "payments", "request", ":id" ], "variable": [ { "key": "id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": \"\"\n}", "createdAt": "2026-07-28T02:15:37.000Z", "updatedAt": "2026-07-28T02:15:37.000Z", "uid": "35240-7973373b-c126-42c7-9b24-36287c7d7307" }, { "id": "9df4da19-e37a-48c2-8a32-36812cf7d291", "name": "Unprocessable Entity - Validation failed for the request body.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/payments/request/:id", "host": [ "{{baseUrl}}" ], "path": [ "payments", "request", ":id" ], "variable": [ { "key": "id" } ] } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": \"\"\n}", "createdAt": "2026-07-28T02:15:37.000Z", "updatedAt": "2026-07-28T02:15:37.000Z", "uid": "35240-9df4da19-e37a-48c2-8a32-36812cf7d291" }, { "id": "dfa4b7fa-185a-4c58-a444-abe84bfd7547", "name": "Internal Server Error - An unexpected error occurred while processing the request.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/payments/request/:id", "host": [ "{{baseUrl}}" ], "path": [ "payments", "request", ":id" ], "variable": [ { "key": "id" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": \"\"\n}", "createdAt": "2026-07-28T02:15:37.000Z", "updatedAt": "2026-07-28T02:15:37.000Z", "uid": "35240-dfa4b7fa-185a-4c58-a444-abe84bfd7547" } ], "createdAt": "2026-07-28T02:15:37.000Z", "updatedAt": "2026-07-28T02:15:37.000Z", "uid": "35240-0be01bb6-0634-4beb-b71c-016b5275eaf9" } ], "id": "3edd9ae0-9faf-4f64-b3dd-403fe02a3791", "createdAt": "2026-07-28T02:15:37.000Z", "updatedAt": "2026-07-28T02:15:37.000Z", "uid": "35240-3edd9ae0-9faf-4f64-b3dd-403fe02a3791" }, { "name": "Request Payment", "id": "97ba3502-174d-4f74-aa73-1d0ecf50dbbe", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"amount\": \"\",\n \"senderBusinessId\": \"\",\n \"recipientWalletId\": \"\",\n \"description\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/payments/request", "host": [ "{{baseUrl}}" ], "path": [ "payments", "request" ] }, "description": "Allows the authenticated user to request a payment from another business." }, "response": [ { "id": "18bc3cc7-eb4d-4a52-9681-9db35ce44779", "name": "The payment request was created successfully.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"amount\": \"\",\n \"senderBusinessId\": \"\",\n \"recipientWalletId\": \"\",\n \"description\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/payments/request", "host": [ "{{baseUrl}}" ], "path": [ "payments", "request" ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{}", "createdAt": "2026-07-28T02:15:37.000Z", "updatedAt": "2026-07-28T02:15:37.000Z", "uid": "35240-18bc3cc7-eb4d-4a52-9681-9db35ce44779" }, { "id": "f0db278f-5bdb-4247-9962-8ef5a0128bd8", "name": "Bad Request - Invalid request body.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"amount\": \"\",\n \"senderBusinessId\": \"\",\n \"recipientWalletId\": \"\",\n \"description\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/payments/request", "host": [ "{{baseUrl}}" ], "path": [ "payments", "request" ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": \"\"\n}", "createdAt": "2026-07-28T02:15:37.000Z", "updatedAt": "2026-07-28T02:15:37.000Z", "uid": "35240-f0db278f-5bdb-4247-9962-8ef5a0128bd8" }, { "id": "840d979a-feeb-41d9-bc86-e51e01169b60", "name": "Unauthorized - Invalid or missing authentication token.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"amount\": \"\",\n \"senderBusinessId\": \"\",\n \"recipientWalletId\": \"\",\n \"description\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/payments/request", "host": [ "{{baseUrl}}" ], "path": [ "payments", "request" ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": \"\"\n}", "createdAt": "2026-07-28T02:15:37.000Z", "updatedAt": "2026-07-28T02:15:37.000Z", "uid": "35240-840d979a-feeb-41d9-bc86-e51e01169b60" }, { "id": "2b9b75e8-d8f6-4536-a49e-244e48e2813a", "name": "Forbidden - User does not have permission to request a payment.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"amount\": \"\",\n \"senderBusinessId\": \"\",\n \"recipientWalletId\": \"\",\n \"description\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/payments/request", "host": [ "{{baseUrl}}" ], "path": [ "payments", "request" ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": \"\"\n}", "createdAt": "2026-07-28T02:15:37.000Z", "updatedAt": "2026-07-28T02:15:37.000Z", "uid": "35240-2b9b75e8-d8f6-4536-a49e-244e48e2813a" }, { "id": "a8c30f4f-cf68-4b43-a22a-ad81d7f6d89c", "name": "Not Found - The specified wallet or business was not found.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"amount\": \"\",\n \"senderBusinessId\": \"\",\n \"recipientWalletId\": \"\",\n \"description\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/payments/request", "host": [ "{{baseUrl}}" ], "path": [ "payments", "request" ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": \"\"\n}", "createdAt": "2026-07-28T02:15:37.000Z", "updatedAt": "2026-07-28T02:15:37.000Z", "uid": "35240-a8c30f4f-cf68-4b43-a22a-ad81d7f6d89c" }, { "id": "bbcf63bc-fb5c-4046-b9cc-b960a2b36b81", "name": "An unexpected server error occurred while trying to create the payment request.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"amount\": \"\",\n \"senderBusinessId\": \"\",\n \"recipientWalletId\": \"\",\n \"description\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/payments/request", "host": [ "{{baseUrl}}" ], "path": [ "payments", "request" ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": \"\"\n}", "createdAt": "2026-07-28T02:15:37.000Z", "updatedAt": "2026-07-28T02:15:37.000Z", "uid": "35240-bbcf63bc-fb5c-4046-b9cc-b960a2b36b81" } ], "createdAt": "2026-07-28T02:15:37.000Z", "updatedAt": "2026-07-28T02:15:37.000Z", "uid": "35240-97ba3502-174d-4f74-aa73-1d0ecf50dbbe" }, { "name": "List Payment Requests", "id": "120535cb-2509-491c-a1ad-7b3ec237284e", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}", "type": "string" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/payments/request?direction=&limit=&offset=&status=", "host": [ "{{baseUrl}}" ], "path": [ "payments", "request" ], "query": [ { "description": "Filter requests by direction ('incoming' for requests to you, 'outgoing' for requests from you).", "key": "direction", "value": "" }, { "description": "The maximum number of payment requests to return (optional).", "key": "limit", "value": "" }, { "description": "The offset for pagination (optional).", "key": "offset", "value": "" }, { "description": "The status of the payment requests to filter (optional).", "key": "status", "value": "" } ] }, "description": "Get a list of payment requests filtered by direction (incoming or outgoing)." }, "response": [ { "id": "1c6319e0-17d1-4193-9670-8e7a4ba039a9", "name": "The list of payment requests was retrieved successfully.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/payments/request?direction=&limit=&offset=&status=", "host": [ "{{baseUrl}}" ], "path": [ "payments", "request" ], "query": [ { "description": "Filter requests by direction ('incoming' for requests to you, 'outgoing' for requests from you).", "key": "direction", "value": "" }, { "description": "The maximum number of payment requests to return (optional).", "key": "limit", "value": "" }, { "description": "The offset for pagination (optional).", "key": "offset", "value": "" }, { "description": "The status of the payment requests to filter (optional).", "key": "status", "value": "" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{}", "createdAt": "2026-07-28T02:15:37.000Z", "updatedAt": "2026-07-28T02:15:37.000Z", "uid": "35240-1c6319e0-17d1-4193-9670-8e7a4ba039a9" }, { "id": "9530bf42-2926-45bd-acbf-aa099428ebce", "name": "Bad Request - Invalid request parameters.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/payments/request?direction=&limit=&offset=&status=", "host": [ "{{baseUrl}}" ], "path": [ "payments", "request" ], "query": [ { "description": "Filter requests by direction ('incoming' for requests to you, 'outgoing' for requests from you).", "key": "direction", "value": "" }, { "description": "The maximum number of payment requests to return (optional).", "key": "limit", "value": "" }, { "description": "The offset for pagination (optional).", "key": "offset", "value": "" }, { "description": "The status of the payment requests to filter (optional).", "key": "status", "value": "" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": \"\"\n}", "createdAt": "2026-07-28T02:15:37.000Z", "updatedAt": "2026-07-28T02:15:37.000Z", "uid": "35240-9530bf42-2926-45bd-acbf-aa099428ebce" }, { "id": "867d9c38-b5bc-4e8b-a6ca-de8c2bad0f98", "name": "Unauthorized - Invalid or missing authentication token.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/payments/request?direction=&limit=&offset=&status=", "host": [ "{{baseUrl}}" ], "path": [ "payments", "request" ], "query": [ { "description": "Filter requests by direction ('incoming' for requests to you, 'outgoing' for requests from you).", "key": "direction", "value": "" }, { "description": "The maximum number of payment requests to return (optional).", "key": "limit", "value": "" }, { "description": "The offset for pagination (optional).", "key": "offset", "value": "" }, { "description": "The status of the payment requests to filter (optional).", "key": "status", "value": "" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": \"\"\n}", "createdAt": "2026-07-28T02:15:37.000Z", "updatedAt": "2026-07-28T02:15:37.000Z", "uid": "35240-867d9c38-b5bc-4e8b-a6ca-de8c2bad0f98" }, { "id": "f8ef5c53-22fb-4213-a727-19848482a027", "name": "Forbidden - User does not have permission to access payment requests.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/payments/request?direction=&limit=&offset=&status=", "host": [ "{{baseUrl}}" ], "path": [ "payments", "request" ], "query": [ { "description": "Filter requests by direction ('incoming' for requests to you, 'outgoing' for requests from you).", "key": "direction", "value": "" }, { "description": "The maximum number of payment requests to return (optional).", "key": "limit", "value": "" }, { "description": "The offset for pagination (optional).", "key": "offset", "value": "" }, { "description": "The status of the payment requests to filter (optional).", "key": "status", "value": "" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": \"\"\n}", "createdAt": "2026-07-28T02:15:37.000Z", "updatedAt": "2026-07-28T02:15:37.000Z", "uid": "35240-f8ef5c53-22fb-4213-a727-19848482a027" }, { "id": "2b8b1cd1-345c-489b-b6a1-06b664b78316", "name": "Not Found - No payment requests associated with this user were found.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/payments/request?direction=&limit=&offset=&status=", "host": [ "{{baseUrl}}" ], "path": [ "payments", "request" ], "query": [ { "description": "Filter requests by direction ('incoming' for requests to you, 'outgoing' for requests from you).", "key": "direction", "value": "" }, { "description": "The maximum number of payment requests to return (optional).", "key": "limit", "value": "" }, { "description": "The offset for pagination (optional).", "key": "offset", "value": "" }, { "description": "The status of the payment requests to filter (optional).", "key": "status", "value": "" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": \"\"\n}", "createdAt": "2026-07-28T02:15:37.000Z", "updatedAt": "2026-07-28T02:15:37.000Z", "uid": "35240-2b8b1cd1-345c-489b-b6a1-06b664b78316" }, { "id": "94bc28ae-f9fa-455a-b42d-d10281d645d4", "name": "An unexpected server error occurred while trying to retrieve the payment requests.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/payments/request?direction=&limit=&offset=&status=", "host": [ "{{baseUrl}}" ], "path": [ "payments", "request" ], "query": [ { "description": "Filter requests by direction ('incoming' for requests to you, 'outgoing' for requests from you).", "key": "direction", "value": "" }, { "description": "The maximum number of payment requests to return (optional).", "key": "limit", "value": "" }, { "description": "The offset for pagination (optional).", "key": "offset", "value": "" }, { "description": "The status of the payment requests to filter (optional).", "key": "status", "value": "" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": \"\"\n}", "createdAt": "2026-07-28T02:15:37.000Z", "updatedAt": "2026-07-28T02:15:37.000Z", "uid": "35240-94bc28ae-f9fa-455a-b42d-d10281d645d4" } ], "createdAt": "2026-07-28T02:15:37.000Z", "updatedAt": "2026-07-28T02:15:37.000Z", "uid": "35240-120535cb-2509-491c-a1ad-7b3ec237284e" } ], "id": "0343c3f2-0be8-457a-afff-8bd9faecd098", "createdAt": "2026-07-28T02:15:37.000Z", "updatedAt": "2026-07-28T02:15:37.000Z", "uid": "35240-0343c3f2-0be8-457a-afff-8bd9faecd098" }, { "name": "{id}", "item": [ { "name": "Get Payment by ID", "id": "47dad1c5-da85-48ee-9ca3-19a83d3f5c45", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}", "type": "string" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/payments/:id", "host": [ "{{baseUrl}}" ], "path": [ "payments", ":id" ], "variable": [ { "id": "3c37e37b-73a6-430e-843e-198113e105c1", "key": "id", "value": "", "description": "(Required) The ID of the payment to retrieve." } ] }, "description": "Retrieve the details of a specific payment by its ID." }, "response": [ { "id": "912ce61b-2f46-454a-9d72-afa0f997b48f", "name": "The payment details were retrieved successfully.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/payments/:id", "host": [ "{{baseUrl}}" ], "path": [ "payments", ":id" ], "variable": [ { "key": "id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"id\": \"\",\n \"amount\": \"\",\n \"status\": \"cancelled\",\n \"createdAt\": \"\",\n \"updatedAt\": \"\",\n \"sender\": \"\",\n \"senderBusinessId\": \"\",\n \"senderBusinessName\": \"\",\n \"senderWalletAddress\": \"\",\n \"recipient\": \"\",\n \"recipientBusinessId\": \"\",\n \"recipientBusinessName\": \"\",\n \"recipientWalletAddress\": \"\",\n \"description\": \"\",\n \"totalCount\": \"\",\n \"rowNum\": \"\"\n}", "createdAt": "2026-07-28T02:15:37.000Z", "updatedAt": "2026-07-28T02:15:37.000Z", "uid": "35240-912ce61b-2f46-454a-9d72-afa0f997b48f" }, { "id": "90cbb669-abe6-4195-8f97-0885e87893d4", "name": "Bad Request - Invalid request parameters.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/payments/:id", "host": [ "{{baseUrl}}" ], "path": [ "payments", ":id" ], "variable": [ { "key": "id" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": \"\"\n}", "createdAt": "2026-07-28T02:15:37.000Z", "updatedAt": "2026-07-28T02:15:37.000Z", "uid": "35240-90cbb669-abe6-4195-8f97-0885e87893d4" }, { "id": "f73e70bd-c7bc-47dc-81ae-da4d53c9bf55", "name": "Unauthorized - Invalid or missing authentication token.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/payments/:id", "host": [ "{{baseUrl}}" ], "path": [ "payments", ":id" ], "variable": [ { "key": "id" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": \"\"\n}", "createdAt": "2026-07-28T02:15:37.000Z", "updatedAt": "2026-07-28T02:15:37.000Z", "uid": "35240-f73e70bd-c7bc-47dc-81ae-da4d53c9bf55" }, { "id": "e69c8d3f-16eb-4a1a-b8e5-6d06d913f11f", "name": "Forbidden - Insufficient permissions to perform this action.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/payments/:id", "host": [ "{{baseUrl}}" ], "path": [ "payments", ":id" ], "variable": [ { "key": "id" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": \"\"\n}", "createdAt": "2026-07-28T02:15:37.000Z", "updatedAt": "2026-07-28T02:15:37.000Z", "uid": "35240-e69c8d3f-16eb-4a1a-b8e5-6d06d913f11f" }, { "id": "1da0740e-8976-412d-87e5-a0ec970a6e45", "name": "Not Found - Requested resource was not found.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/payments/:id", "host": [ "{{baseUrl}}" ], "path": [ "payments", ":id" ], "variable": [ { "key": "id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": \"\"\n}", "createdAt": "2026-07-28T02:15:37.000Z", "updatedAt": "2026-07-28T02:15:37.000Z", "uid": "35240-1da0740e-8976-412d-87e5-a0ec970a6e45" }, { "id": "37f2bcbc-77df-4e63-821c-1f38a7a26cab", "name": "Unprocessable Entity - Validation failed for the request body.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/payments/:id", "host": [ "{{baseUrl}}" ], "path": [ "payments", ":id" ], "variable": [ { "key": "id" } ] } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": \"\"\n}", "createdAt": "2026-07-28T02:15:37.000Z", "updatedAt": "2026-07-28T02:15:37.000Z", "uid": "35240-37f2bcbc-77df-4e63-821c-1f38a7a26cab" }, { "id": "135a4853-b0a3-448a-851c-53bd31223d01", "name": "Internal Server Error - An unexpected error occurred while processing the request.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/payments/:id", "host": [ "{{baseUrl}}" ], "path": [ "payments", ":id" ], "variable": [ { "key": "id" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": \"\"\n}", "createdAt": "2026-07-28T02:15:37.000Z", "updatedAt": "2026-07-28T02:15:37.000Z", "uid": "35240-135a4853-b0a3-448a-851c-53bd31223d01" } ], "createdAt": "2026-07-28T02:15:37.000Z", "updatedAt": "2026-07-28T02:15:37.000Z", "uid": "35240-47dad1c5-da85-48ee-9ca3-19a83d3f5c45" } ], "id": "0fd11d94-f067-4bb1-b071-bf935cf37bfc", "createdAt": "2026-07-28T02:15:37.000Z", "updatedAt": "2026-07-28T02:15:37.000Z", "uid": "35240-0fd11d94-f067-4bb1-b071-bf935cf37bfc" }, { "name": "List Payments", "id": "30ee6462-5075-4004-9f89-4810a6ea6d01", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}", "type": "string" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/payments?status=&walletId=&startDate=&endDate=&amountGreaterThan=&amountLessThan=&senderBusinessId=&recipientBusinessId=&businessId=&description=&orderBy=updatedAt&order=desc&limit=&offset=", "host": [ "{{baseUrl}}" ], "path": [ "payments" ], "query": [ { "description": "Comma-separated list of payment statuses to filter by. Available statuses: queued, requested, initiated, lockbox, released, partial, cancelled, declined, completed, failed. Example: \"completed,lockbox\" (optional).", "key": "status", "value": "" }, { "description": "Filter payments by specific wallet ID. Must be a valid UUID format (optional).", "key": "walletId", "value": "" }, { "description": "Filter payments created after this date (ISO 8601 format) (optional).", "key": "startDate", "value": "" }, { "description": "Filter payments created before this date (ISO 8601 format) (optional).", "key": "endDate", "value": "" }, { "description": "Filter payments with transaction amount greater than or equal to this value (optional).", "key": "amountGreaterThan", "value": "" }, { "description": "Filter payments with transaction amount less than or equal to this value (optional).", "key": "amountLessThan", "value": "" }, { "description": "Filter payments with sender business ID (optional).", "key": "senderBusinessId", "value": "" }, { "description": "Filter payments with recipient business ID (optional).", "key": "recipientBusinessId", "value": "" }, { "description": "Filter payments where sender or recipient matches business ID (optional).. This is a legacy filter that is no longer supported.", "key": "businessId", "value": "" }, { "description": "Filter payments by description (case-insensitive partial match) (optional).", "key": "description", "value": "" }, { "description": "Sort payments by a field. Available fields: createdAt, updatedAt. (optional).", "key": "orderBy", "value": "updatedAt" }, { "description": "Sort direction. Available values: asc, desc. Example: \"asc\" (optional).", "key": "order", "value": "desc" }, { "description": "the maximum number of payments returned. Default: 100. Max: 200.(optional).", "key": "limit", "value": "" }, { "description": "page offset to start from (based on the limit). Default: 0.(optional).", "key": "offset", "value": "" } ] }, "description": "Retrieve a list of all payments made by the authenticated user." }, "response": [ { "id": "acfc6c43-ccf0-4633-9928-fb3fd6127708", "name": "The list of payments was retrieved successfully.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/payments?status=&walletId=&startDate=&endDate=&amountGreaterThan=&amountLessThan=&senderBusinessId=&recipientBusinessId=&businessId=&description=&orderBy=updatedAt&order=desc&limit=&offset=", "host": [ "{{baseUrl}}" ], "path": [ "payments" ], "query": [ { "description": "Comma-separated list of payment statuses to filter by. Available statuses: queued, requested, initiated, lockbox, released, partial, cancelled, declined, completed, failed. Example: \"completed,lockbox\" (optional).", "key": "status", "value": "" }, { "description": "Filter payments by specific wallet ID. Must be a valid UUID format (optional).", "key": "walletId", "value": "" }, { "description": "Filter payments created after this date (ISO 8601 format) (optional).", "key": "startDate", "value": "" }, { "description": "Filter payments created before this date (ISO 8601 format) (optional).", "key": "endDate", "value": "" }, { "description": "Filter payments with transaction amount greater than or equal to this value (optional).", "key": "amountGreaterThan", "value": "" }, { "description": "Filter payments with transaction amount less than or equal to this value (optional).", "key": "amountLessThan", "value": "" }, { "description": "Filter payments with sender business ID (optional).", "key": "senderBusinessId", "value": "" }, { "description": "Filter payments with recipient business ID (optional).", "key": "recipientBusinessId", "value": "" }, { "description": "Filter payments where sender or recipient matches business ID (optional).. This is a legacy filter that is no longer supported.", "key": "businessId", "value": "" }, { "description": "Filter payments by description (case-insensitive partial match) (optional).", "key": "description", "value": "" }, { "description": "Sort payments by a field. Available fields: createdAt, updatedAt. (optional).", "key": "orderBy", "value": "updatedAt" }, { "description": "Sort direction. Available values: asc, desc. Example: \"asc\" (optional).", "key": "order", "value": "desc" }, { "description": "the maximum number of payments returned. Default: 100. Max: 200.(optional).", "key": "limit", "value": "" }, { "description": "page offset to start from (based on the limit). Default: 0.(optional).", "key": "offset", "value": "" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "[\n {\n \"id\": \"\",\n \"amount\": \"\",\n \"status\": \"requested\",\n \"createdAt\": \"\",\n \"updatedAt\": \"\",\n \"sender\": \"\",\n \"senderBusinessId\": \"\",\n \"senderBusinessName\": \"\",\n \"senderWalletAddress\": \"\",\n \"recipient\": \"\",\n \"recipientBusinessId\": \"\",\n \"recipientBusinessName\": \"\",\n \"recipientWalletAddress\": \"\",\n \"description\": \"\",\n \"totalCount\": \"\",\n \"rowNum\": \"\"\n },\n {\n \"id\": \"\",\n \"amount\": \"\",\n \"status\": \"completed\",\n \"createdAt\": \"\",\n \"updatedAt\": \"\",\n \"sender\": \"\",\n \"senderBusinessId\": \"\",\n \"senderBusinessName\": \"\",\n \"senderWalletAddress\": \"\",\n \"recipient\": \"\",\n \"recipientBusinessId\": \"\",\n \"recipientBusinessName\": \"\",\n \"recipientWalletAddress\": \"\",\n \"description\": \"\",\n \"totalCount\": \"\",\n \"rowNum\": \"\"\n }\n]", "createdAt": "2026-07-28T02:15:37.000Z", "updatedAt": "2026-07-28T02:15:37.000Z", "uid": "35240-acfc6c43-ccf0-4633-9928-fb3fd6127708" }, { "id": "33b9c802-23c8-4609-b828-0ce2f9950d17", "name": "Bad Request - Invalid request parameters.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/payments?status=&walletId=&startDate=&endDate=&amountGreaterThan=&amountLessThan=&senderBusinessId=&recipientBusinessId=&businessId=&description=&orderBy=updatedAt&order=desc&limit=&offset=", "host": [ "{{baseUrl}}" ], "path": [ "payments" ], "query": [ { "description": "Comma-separated list of payment statuses to filter by. Available statuses: queued, requested, initiated, lockbox, released, partial, cancelled, declined, completed, failed. Example: \"completed,lockbox\" (optional).", "key": "status", "value": "" }, { "description": "Filter payments by specific wallet ID. Must be a valid UUID format (optional).", "key": "walletId", "value": "" }, { "description": "Filter payments created after this date (ISO 8601 format) (optional).", "key": "startDate", "value": "" }, { "description": "Filter payments created before this date (ISO 8601 format) (optional).", "key": "endDate", "value": "" }, { "description": "Filter payments with transaction amount greater than or equal to this value (optional).", "key": "amountGreaterThan", "value": "" }, { "description": "Filter payments with transaction amount less than or equal to this value (optional).", "key": "amountLessThan", "value": "" }, { "description": "Filter payments with sender business ID (optional).", "key": "senderBusinessId", "value": "" }, { "description": "Filter payments with recipient business ID (optional).", "key": "recipientBusinessId", "value": "" }, { "description": "Filter payments where sender or recipient matches business ID (optional).. This is a legacy filter that is no longer supported.", "key": "businessId", "value": "" }, { "description": "Filter payments by description (case-insensitive partial match) (optional).", "key": "description", "value": "" }, { "description": "Sort payments by a field. Available fields: createdAt, updatedAt. (optional).", "key": "orderBy", "value": "updatedAt" }, { "description": "Sort direction. Available values: asc, desc. Example: \"asc\" (optional).", "key": "order", "value": "desc" }, { "description": "the maximum number of payments returned. Default: 100. Max: 200.(optional).", "key": "limit", "value": "" }, { "description": "page offset to start from (based on the limit). Default: 0.(optional).", "key": "offset", "value": "" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": \"\"\n}", "createdAt": "2026-07-28T02:15:37.000Z", "updatedAt": "2026-07-28T02:15:37.000Z", "uid": "35240-33b9c802-23c8-4609-b828-0ce2f9950d17" }, { "id": "146d1d61-2495-43eb-ba8d-f37e096da27c", "name": "Unauthorized - Invalid or missing authentication token.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/payments?status=&walletId=&startDate=&endDate=&amountGreaterThan=&amountLessThan=&senderBusinessId=&recipientBusinessId=&businessId=&description=&orderBy=updatedAt&order=desc&limit=&offset=", "host": [ "{{baseUrl}}" ], "path": [ "payments" ], "query": [ { "description": "Comma-separated list of payment statuses to filter by. Available statuses: queued, requested, initiated, lockbox, released, partial, cancelled, declined, completed, failed. Example: \"completed,lockbox\" (optional).", "key": "status", "value": "" }, { "description": "Filter payments by specific wallet ID. Must be a valid UUID format (optional).", "key": "walletId", "value": "" }, { "description": "Filter payments created after this date (ISO 8601 format) (optional).", "key": "startDate", "value": "" }, { "description": "Filter payments created before this date (ISO 8601 format) (optional).", "key": "endDate", "value": "" }, { "description": "Filter payments with transaction amount greater than or equal to this value (optional).", "key": "amountGreaterThan", "value": "" }, { "description": "Filter payments with transaction amount less than or equal to this value (optional).", "key": "amountLessThan", "value": "" }, { "description": "Filter payments with sender business ID (optional).", "key": "senderBusinessId", "value": "" }, { "description": "Filter payments with recipient business ID (optional).", "key": "recipientBusinessId", "value": "" }, { "description": "Filter payments where sender or recipient matches business ID (optional).. This is a legacy filter that is no longer supported.", "key": "businessId", "value": "" }, { "description": "Filter payments by description (case-insensitive partial match) (optional).", "key": "description", "value": "" }, { "description": "Sort payments by a field. Available fields: createdAt, updatedAt. (optional).", "key": "orderBy", "value": "updatedAt" }, { "description": "Sort direction. Available values: asc, desc. Example: \"asc\" (optional).", "key": "order", "value": "desc" }, { "description": "the maximum number of payments returned. Default: 100. Max: 200.(optional).", "key": "limit", "value": "" }, { "description": "page offset to start from (based on the limit). Default: 0.(optional).", "key": "offset", "value": "" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": \"\"\n}", "createdAt": "2026-07-28T02:15:37.000Z", "updatedAt": "2026-07-28T02:15:37.000Z", "uid": "35240-146d1d61-2495-43eb-ba8d-f37e096da27c" }, { "id": "e7ee171b-3b36-46f7-b767-e799ea37fa6f", "name": "Not Found - No payments associated with this user were found.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/payments?status=&walletId=&startDate=&endDate=&amountGreaterThan=&amountLessThan=&senderBusinessId=&recipientBusinessId=&businessId=&description=&orderBy=updatedAt&order=desc&limit=&offset=", "host": [ "{{baseUrl}}" ], "path": [ "payments" ], "query": [ { "description": "Comma-separated list of payment statuses to filter by. Available statuses: queued, requested, initiated, lockbox, released, partial, cancelled, declined, completed, failed. Example: \"completed,lockbox\" (optional).", "key": "status", "value": "" }, { "description": "Filter payments by specific wallet ID. Must be a valid UUID format (optional).", "key": "walletId", "value": "" }, { "description": "Filter payments created after this date (ISO 8601 format) (optional).", "key": "startDate", "value": "" }, { "description": "Filter payments created before this date (ISO 8601 format) (optional).", "key": "endDate", "value": "" }, { "description": "Filter payments with transaction amount greater than or equal to this value (optional).", "key": "amountGreaterThan", "value": "" }, { "description": "Filter payments with transaction amount less than or equal to this value (optional).", "key": "amountLessThan", "value": "" }, { "description": "Filter payments with sender business ID (optional).", "key": "senderBusinessId", "value": "" }, { "description": "Filter payments with recipient business ID (optional).", "key": "recipientBusinessId", "value": "" }, { "description": "Filter payments where sender or recipient matches business ID (optional).. This is a legacy filter that is no longer supported.", "key": "businessId", "value": "" }, { "description": "Filter payments by description (case-insensitive partial match) (optional).", "key": "description", "value": "" }, { "description": "Sort payments by a field. Available fields: createdAt, updatedAt. (optional).", "key": "orderBy", "value": "updatedAt" }, { "description": "Sort direction. Available values: asc, desc. Example: \"asc\" (optional).", "key": "order", "value": "desc" }, { "description": "the maximum number of payments returned. Default: 100. Max: 200.(optional).", "key": "limit", "value": "" }, { "description": "page offset to start from (based on the limit). Default: 0.(optional).", "key": "offset", "value": "" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": \"\"\n}", "createdAt": "2026-07-28T02:15:37.000Z", "updatedAt": "2026-07-28T02:15:37.000Z", "uid": "35240-e7ee171b-3b36-46f7-b767-e799ea37fa6f" }, { "id": "381fceca-6210-447e-88b1-fc5800852fac", "name": "An unexpected server error occurred while trying to retrieve the payments.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/payments?status=&walletId=&startDate=&endDate=&amountGreaterThan=&amountLessThan=&senderBusinessId=&recipientBusinessId=&businessId=&description=&orderBy=updatedAt&order=desc&limit=&offset=", "host": [ "{{baseUrl}}" ], "path": [ "payments" ], "query": [ { "description": "Comma-separated list of payment statuses to filter by. Available statuses: queued, requested, initiated, lockbox, released, partial, cancelled, declined, completed, failed. Example: \"completed,lockbox\" (optional).", "key": "status", "value": "" }, { "description": "Filter payments by specific wallet ID. Must be a valid UUID format (optional).", "key": "walletId", "value": "" }, { "description": "Filter payments created after this date (ISO 8601 format) (optional).", "key": "startDate", "value": "" }, { "description": "Filter payments created before this date (ISO 8601 format) (optional).", "key": "endDate", "value": "" }, { "description": "Filter payments with transaction amount greater than or equal to this value (optional).", "key": "amountGreaterThan", "value": "" }, { "description": "Filter payments with transaction amount less than or equal to this value (optional).", "key": "amountLessThan", "value": "" }, { "description": "Filter payments with sender business ID (optional).", "key": "senderBusinessId", "value": "" }, { "description": "Filter payments with recipient business ID (optional).", "key": "recipientBusinessId", "value": "" }, { "description": "Filter payments where sender or recipient matches business ID (optional).. This is a legacy filter that is no longer supported.", "key": "businessId", "value": "" }, { "description": "Filter payments by description (case-insensitive partial match) (optional).", "key": "description", "value": "" }, { "description": "Sort payments by a field. Available fields: createdAt, updatedAt. (optional).", "key": "orderBy", "value": "updatedAt" }, { "description": "Sort direction. Available values: asc, desc. Example: \"asc\" (optional).", "key": "order", "value": "desc" }, { "description": "the maximum number of payments returned. Default: 100. Max: 200.(optional).", "key": "limit", "value": "" }, { "description": "page offset to start from (based on the limit). Default: 0.(optional).", "key": "offset", "value": "" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": \"\"\n}", "createdAt": "2026-07-28T02:15:37.000Z", "updatedAt": "2026-07-28T02:15:37.000Z", "uid": "35240-381fceca-6210-447e-88b1-fc5800852fac" } ], "createdAt": "2026-07-28T02:15:37.000Z", "updatedAt": "2026-07-28T02:15:37.000Z", "uid": "35240-30ee6462-5075-4004-9f89-4810a6ea6d01" } ], "id": "914ccc8b-b916-447a-b405-16d59199aa2c", "createdAt": "2026-07-28T02:15:37.000Z", "updatedAt": "2026-07-28T02:15:37.000Z", "uid": "35240-914ccc8b-b916-447a-b405-16d59199aa2c" } ], "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}", "type": "string" } ] }, "variable": [ { "key": "baseUrl", "value": "https://openapi.n3xt.io" } ] }