{ "item": [ { "name": "PaysafeCash Reusable Barcode - REST", "description": "REST API calls used to create, retrieve, modify, and cancel reusable barcodes.", "item": [ { "id": "965d6661-7564-4922-987c-2c99bc7b3e40", "name": "Generate Reusable Barcode", "request": { "name": "Generate Reusable Barcode", "description": { "content": "Creates a PaysafeCash reusable barcode.", "type": "text/plain" }, "url": { "path": [ "barcodes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"currency\": \"\",\n \"country\": \"\",\n \"webhook_url\": \"\",\n \"merchant_client_id\": \"\",\n \"expire_time\": \"\",\n \"amount\": \"\",\n \"max_amount\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "basic", "basic": [ { "key": "username", "value": "{{basicAuthUsername}}" }, { "key": "password", "value": "{{basicAuthPassword}}" } ] } }, "response": [ { "id": "c145b0bc-00f6-4711-9f49-f5fa7c937d69", "name": "Reusable barcode created successfully.", "originalRequest": { "url": { "path": [ "barcodes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: basic", "type": "text/plain" }, "key": "Authorization", "value": "Basic " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"currency\": \"\",\n \"country\": \"\",\n \"webhook_url\": \"\",\n \"merchant_client_id\": \"\",\n \"expire_time\": \"\",\n \"amount\": \"\",\n \"max_amount\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"barcode\": \"\",\n \"created\": \"\",\n \"updated\": \"\",\n \"expires\": \"\",\n \"visualization\": \"\",\n \"country\": \"\",\n \"status\": \"ACTIVE\",\n \"barcode_identifier\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f92992f9-5aac-4209-8821-27ea5e40651e", "name": "Invalid barcode request.", "originalRequest": { "url": { "path": [ "barcodes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: basic", "type": "text/plain" }, "key": "Authorization", "value": "Basic " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"currency\": \"\",\n \"country\": \"\",\n \"webhook_url\": \"\",\n \"merchant_client_id\": \"\",\n \"expire_time\": \"\",\n \"amount\": \"\",\n \"max_amount\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"number\": \"\",\n \"param\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "dcbc0a28-0137-4b6c-b10f-4c1422cf1b60", "name": "Authentication failed.", "originalRequest": { "url": { "path": [ "barcodes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: basic", "type": "text/plain" }, "key": "Authorization", "value": "Basic " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"currency\": \"\",\n \"country\": \"\",\n \"webhook_url\": \"\",\n \"merchant_client_id\": \"\",\n \"expire_time\": \"\",\n \"amount\": \"\",\n \"max_amount\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"number\": \"\",\n \"param\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "419e9764-8592-4e63-9357-65175f2ea24d", "name": "Retrieve Reusable Barcode", "request": { "name": "Retrieve Reusable Barcode", "description": { "content": "Retrieves a reusable barcode by its unique identifier.", "type": "text/plain" }, "url": { "path": [ "barcodes", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) Unique reusable barcode identifier.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "basic", "basic": [ { "key": "username", "value": "{{basicAuthUsername}}" }, { "key": "password", "value": "{{basicAuthPassword}}" } ] } }, "response": [ { "id": "02e056c1-d7d5-4893-afc0-87accb0a52b9", "name": "Reusable barcode retrieved successfully.", "originalRequest": { "url": { "path": [ "barcodes", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Unique reusable barcode identifier.", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: basic", "type": "text/plain" }, "key": "Authorization", "value": "Basic " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"barcode\": \"\",\n \"created\": \"\",\n \"updated\": \"\",\n \"expires\": \"\",\n \"visualization\": \"\",\n \"country\": \"\",\n \"status\": \"ACTIVE\",\n \"barcode_identifier\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "35212220-512b-4d47-9e3e-4c524b3c310a", "name": "Invalid request.", "originalRequest": { "url": { "path": [ "barcodes", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Unique reusable barcode identifier.", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: basic", "type": "text/plain" }, "key": "Authorization", "value": "Basic " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"number\": \"\",\n \"param\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "24c69470-8bd7-450e-8664-de1d0cd025ec", "name": "Authentication failed.", "originalRequest": { "url": { "path": [ "barcodes", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Unique reusable barcode identifier.", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: basic", "type": "text/plain" }, "key": "Authorization", "value": "Basic " } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"number\": \"\",\n \"param\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4b7537d8-5f1b-4578-bbd1-b7000bca044d", "name": "Reusable barcode not found.", "originalRequest": { "url": { "path": [ "barcodes", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Unique reusable barcode identifier.", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: basic", "type": "text/plain" }, "key": "Authorization", "value": "Basic " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"number\": \"\",\n \"param\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "f61a0229-7a7a-4b53-a055-59cdc3e1f8b6", "name": "Cancel Reusable Barcode", "request": { "name": "Cancel Reusable Barcode", "description": { "content": "Cancels an active reusable barcode.", "type": "text/plain" }, "url": { "path": [ "barcodes", ":id", "" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) Unique reusable barcode identifier.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": { "type": "basic", "basic": [ { "key": "username", "value": "{{basicAuthUsername}}" }, { "key": "password", "value": "{{basicAuthPassword}}" } ] } }, "response": [ { "id": "2e8cf796-c77c-405b-9040-e78db563484d", "name": "Reusable barcode cancelled successfully.", "originalRequest": { "url": { "path": [ "barcodes", ":id", "" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Unique reusable barcode identifier.", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: basic", "type": "text/plain" }, "key": "Authorization", "value": "Basic " } ], "method": "DELETE", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "09d0c1c3-b72d-40fb-a8b5-260f0a0940ec", "name": "Invalid request.", "originalRequest": { "url": { "path": [ "barcodes", ":id", "" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Unique reusable barcode identifier.", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: basic", "type": "text/plain" }, "key": "Authorization", "value": "Basic " } ], "method": "DELETE", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"number\": \"\",\n \"param\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d7a9d150-de77-4524-8e52-8cec1a6425ed", "name": "Authentication failed.", "originalRequest": { "url": { "path": [ "barcodes", ":id", "" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Unique reusable barcode identifier.", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: basic", "type": "text/plain" }, "key": "Authorization", "value": "Basic " } ], "method": "DELETE", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"number\": \"\",\n \"param\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "910503a3-f64f-48c4-b2f2-6a8727a1a5e0", "name": "Update Reusable Barcode", "request": { "name": "Update Reusable Barcode", "description": { "content": "Updates an existing reusable barcode.", "type": "text/plain" }, "url": { "path": [ "barcodes", ":id", "" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) Unique reusable barcode identifier.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": {}, "auth": { "type": "basic", "basic": [ { "key": "username", "value": "{{basicAuthUsername}}" }, { "key": "password", "value": "{{basicAuthPassword}}" } ] } }, "response": [ { "id": "40781afc-2ac2-4833-b565-6589a8caa67b", "name": "Reusable barcode updated successfully.", "originalRequest": { "url": { "path": [ "barcodes", ":id", "" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Unique reusable barcode identifier.", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: basic", "type": "text/plain" }, "key": "Authorization", "value": "Basic " } ], "method": "PATCH", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"barcode\": \"\",\n \"created\": \"\",\n \"updated\": \"\",\n \"expires\": \"\",\n \"visualization\": \"\",\n \"country\": \"\",\n \"status\": \"ACTIVE\",\n \"barcode_identifier\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c1fe585a-45ea-458d-b690-766b02bdd9e7", "name": "Invalid request.", "originalRequest": { "url": { "path": [ "barcodes", ":id", "" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Unique reusable barcode identifier.", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: basic", "type": "text/plain" }, "key": "Authorization", "value": "Basic " } ], "method": "PATCH", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"number\": \"\",\n \"param\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8a1ea38e-96fa-4925-9e1c-b48b0b18c827", "name": "Authentication failed.", "originalRequest": { "url": { "path": [ "barcodes", ":id", "" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Unique reusable barcode identifier.", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: basic", "type": "text/plain" }, "key": "Authorization", "value": "Basic " } ], "method": "PATCH", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"number\": \"\",\n \"param\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "PaysafeCash Reusable Barcode Notifications", "description": "JSON webhook payloads sent for reusable barcode payment updates.", "item": [ { "id": "9c0cbeb1-1492-4047-96fb-40296e5f5c87", "name": "Reusable Barcode Webhook Notification", "request": { "name": "Reusable Barcode Webhook Notification", "description": { "content": "Sends a JSON webhook notification to the business partner endpoint\nprovided in the `webhook_url` field of the barcode request.\n\nA webhook is sent as soon as a payment is captured by paysafecard\n(status \"SUCCESS\"), the payment is actively cancelled (status\n\"CANCELLED_CUSTOMER\" or \"CANCELLED_MERCHANT\"), or the payment expires\n(status \"EXPIRED\").\n\nThe business partner payment server must respond with HTTP `200`. When\na technical error occurs or the receiving application returns an error,\nthe notification is resubmitted at a regular interval of 1 minute until\none of the following conditions is met:\n\n- The payment server receives an HTTP `200` response.\n- The maximum number of retry attempts is reached (currently configured\n at 5 retries).\n\nThe webhook notification is signed with `rsa-sha256`. The signature can\nbe found in the HTTP `Authorization` header.\n", "type": "text/plain" }, "url": { "path": [ "webhooks", "paysafecash", "reusable-barcode" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"timestamp\": \"\",\n \"eventType\": \"PAYMENT_EXPIRED\",\n \"version\": \"\",\n \"data\": {\n \"mid\": \"\",\n \"mtid\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "9965635d-2595-4fd5-aee1-65471845502d", "name": "Reusable barcode webhook notification received successfully.", "originalRequest": { "url": { "path": [ "webhooks", "paysafecash", "reusable-barcode" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"timestamp\": \"\",\n \"eventType\": \"PAYMENT_EXPIRED\",\n \"version\": \"\",\n \"data\": {\n \"mid\": \"\",\n \"mtid\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ], "event": [], "variable": [ { "key": "baseUrl", "value": "https://apitest.paysafecard.com/v1" } ], "info": { "_postman_id": "a34726b5-5cc3-4698-ba6c-eda50e470e34", "name": "PaysafeCash Reusable Barcode API", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "description": { "content": "## Overview\n\nThis API reference contains PaysafeCash reusable barcode REST API calls.\n\nReusable barcodes allow business partners to generate PaysafeCash barcodes\nthrough an API request and display them to customers using their own UI.\n\nCustomers bring the barcode to a payment point, pay the transaction amount,\nand PaysafeCash captures the payment on behalf of the business partner.\n", "type": "text/plain" } } }