{
  "info": {
    "_postman_id": "b4d2a7cc-9f36-42d5-9f09-57ab0d896e21",
    "name": "PayStar Merchant API 2026-08-25.9",
    "description": "Generated from the owner-reviewed PayStar machine-readable contract. No secrets or payment credentials are included. Create requests must use a fresh externalTransactionId.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "variable": [
    {
      "key": "secureBaseUrl",
      "value": "https://secure.paystar.uk",
      "type": "string"
    },
    {
      "key": "initBaseUrl",
      "value": "https://init.paystar.uk",
      "type": "string"
    },
    {
      "key": "tokenBaseUrl",
      "value": "https://token.paystar.uk",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "Balance",
      "item": [
        {
          "name": "Get merchant balance",
          "request": {
            "method": "GET",
            "header": [],
            "auth": {
              "type": "bearer",
              "bearer": [
                {
                  "key": "token",
                  "value": "{{balanceToken}}",
                  "type": "string"
                }
              ]
            },
            "url": "{{secureBaseUrl}}/api/v1/balance/merchant?currency={{currency}}",
            "description": "Use the test key assigned to the exact pipeline for this request. Replace example identifiers for every create request."
          }
        }
      ]
    },
    {
      "name": "Deposits",
      "item": [
        {
          "name": "Create P2P deposit H2H",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "auth": {
              "type": "bearer",
              "bearer": [
                {
                  "key": "token",
                  "value": "{{depositToken}}",
                  "type": "string"
                }
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"amount\": 100.00,\n  \"currency\": \"RUB\",\n  \"externalTransactionId\": \"merchant-deposit-123\",\n  \"callbackUrl\": \"https://merchant.example/paystar/callback\",\n  \"processingRedirectUrl\": \"https://merchant.example/payment/processing\",\n  \"failedRedirectUrl\": \"https://merchant.example/payment/failed\",\n  \"successRedirectUrl\": \"https://merchant.example/payment/success\",\n  \"additionalFields\": []\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": "{{secureBaseUrl}}/api/v1/integration/deposit-order/",
            "description": "Use the test key assigned to the exact pipeline for this request. Replace example identifiers for every create request."
          }
        },
        {
          "name": "Create deposit H2C",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "auth": {
              "type": "bearer",
              "bearer": [
                {
                  "key": "token",
                  "value": "{{depositToken}}",
                  "type": "string"
                }
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"amount\": 100.00,\n  \"currency\": \"RUB\",\n  \"externalTransactionId\": \"merchant-h2c-123\",\n  \"callbackUrl\": \"https://merchant.example/paystar/callback\",\n  \"additionalFields\": []\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": "{{initBaseUrl}}/api/v1/integration/deposit-order/",
            "description": "Use the test key assigned to the exact pipeline for this request. Replace example identifiers for every create request."
          }
        },
        {
          "name": "Create deposit by token",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "auth": {
              "type": "bearer",
              "bearer": [
                {
                  "key": "token",
                  "value": "{{depositToken}}",
                  "type": "string"
                }
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"amount\": 100.00,\n  \"currency\": \"RUB\",\n  \"externalTransactionId\": \"merchant-token-deposit-123\",\n  \"callbackUrl\": \"https://merchant.example/paystar/callback\",\n  \"additionalFields\": [\n    {\n      \"key\": \"cardStorageToken\",\n      \"value\": \"{{cardStorageToken}}\"\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": "{{tokenBaseUrl}}/api/v1/integration/deposit-order/",
            "description": "Use the test key assigned to the exact pipeline for this request. Replace example identifiers for every create request."
          }
        },
        {
          "name": "Get deposit status by PayStar ID",
          "request": {
            "method": "GET",
            "header": [],
            "auth": {
              "type": "bearer",
              "bearer": [
                {
                  "key": "token",
                  "value": "{{depositToken}}",
                  "type": "string"
                }
              ]
            },
            "url": "{{secureBaseUrl}}/api/v1/integration/deposit-order/{{depositExternalId}}/status",
            "description": "Use the test key assigned to the exact pipeline for this request. Replace example identifiers for every create request."
          }
        },
        {
          "name": "Get deposit status by merchant ID",
          "request": {
            "method": "GET",
            "header": [],
            "auth": {
              "type": "bearer",
              "bearer": [
                {
                  "key": "token",
                  "value": "{{depositToken}}",
                  "type": "string"
                }
              ]
            },
            "url": "{{secureBaseUrl}}/api/v1/integration/deposit-order/{{depositExternalTransactionId}}/status-by-external-transaction-id",
            "description": "Use the test key assigned to the exact pipeline for this request. Replace example identifiers for every create request."
          }
        }
      ]
    },
    {
      "name": "Payouts",
      "item": [
        {
          "name": "Create payout H2H",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "auth": {
              "type": "bearer",
              "bearer": [
                {
                  "key": "token",
                  "value": "{{payoutToken}}",
                  "type": "string"
                }
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"amount\": 1000.00,\n  \"currency\": \"RUB\",\n  \"externalTransactionId\": \"merchant-payout-123\",\n  \"callbackUrl\": \"https://merchant.example/paystar/callback\",\n  \"additionalFields\": [\n    {\n      \"key\": \"payeerIdentifier\",\n      \"value\": \"merchant-customer-123\"\n    },\n    {\n      \"key\": \"bankName\",\n      \"value\": \"Example Bank\"\n    },\n    {\n      \"key\": \"cardHolder\",\n      \"value\": \"TEST CARDHOLDER\"\n    },\n    {\n      \"key\": \"cardNumber\",\n      \"value\": \"{{testCardNumber}}\"\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": "{{secureBaseUrl}}/api/v1/integration/withdrawal-order/",
            "description": "Use the test key assigned to the exact pipeline for this request. Replace example identifiers for every create request."
          }
        },
        {
          "name": "Get payout status by PayStar ID",
          "request": {
            "method": "GET",
            "header": [],
            "auth": {
              "type": "bearer",
              "bearer": [
                {
                  "key": "token",
                  "value": "{{payoutToken}}",
                  "type": "string"
                }
              ]
            },
            "url": "{{secureBaseUrl}}/api/v1/integration/withdrawal-order/{{payoutExternalId}}/status",
            "description": "Use the test key assigned to the exact pipeline for this request. Replace example identifiers for every create request."
          }
        },
        {
          "name": "Get payout status by merchant ID",
          "request": {
            "method": "GET",
            "header": [],
            "auth": {
              "type": "bearer",
              "bearer": [
                {
                  "key": "token",
                  "value": "{{payoutToken}}",
                  "type": "string"
                }
              ]
            },
            "url": "{{secureBaseUrl}}/api/v1/integration/withdrawal-order/{{payoutExternalTransactionId}}/status-by-external-transaction-id",
            "description": "Use the test key assigned to the exact pipeline for this request. Replace example identifiers for every create request."
          }
        }
      ]
    }
  ]
}