{
  "info": {
    "name": "Lidya API",
    "_postman_id": "lidya-api-v1",
    "description": "Lidya public API (v1). High-risk merchant payment gateway — accept card payments, settle in USDT next business day. See https://docs.lidya.money for the full reference.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.lidya.money",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_test_replace_me",
      "type": "string"
    }
  ],
  "auth": {
    "type": "apikey",
    "apikey": [
      { "key": "key", "value": "X-API-Key", "type": "string" },
      { "key": "value", "value": "{{apiKey}}", "type": "string" },
      { "key": "in", "value": "header", "type": "string" }
    ]
  },
  "item": [
    {
      "name": "Charges",
      "item": [
        {
          "name": "Create charge",
          "request": {
            "method": "POST",
            "header": [
              { "key": "Content-Type", "value": "application/json" },
              { "key": "X-Idempotency-Key", "value": "{{$guid}}" }
            ],
            "url": { "raw": "{{baseUrl}}/v1/charges", "host": ["{{baseUrl}}"], "path": ["v1", "charges"] },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"amount\": 12550,\n  \"currency\": \"TRY\",\n  \"paymentMethod\": \"credit_card_international\",\n  \"merchantReference\": \"order-001\",\n  \"customer\": {\n    \"name\": \"Test Customer\",\n    \"email\": \"test@example.com\"\n  }\n}"
            }
          },
          "response": [
            {
              "name": "201 created",
              "originalRequest": { "method": "POST", "url": { "raw": "{{baseUrl}}/v1/charges" } },
              "status": "Created",
              "code": 201,
              "header": [{ "key": "content-type", "value": "application/json" }],
              "body": "{\n  \"id\": \"3ad7c342-7935-4531-91dd-e059ac9cae34\",\n  \"amount\": \"12550\",\n  \"currency\": \"TRY\",\n  \"paymentMethod\": \"credit_card_international\",\n  \"merchantReference\": \"order-001\",\n  \"status\": \"pending\",\n  \"paymentPageUrl\": \"https://checkout.lidya.money/c/019e1066-bdb5-736a-8ddf-5b48ac163aff\",\n  \"providerPaymentId\": \"019e1066-bdb5-736a-8ddf-5b48ac163aff\",\n  \"createdAt\": \"2026-05-10T05:40:23.321Z\",\n  \"updatedAt\": \"2026-05-10T05:40:29.693Z\"\n}"
            }
          ]
        },
        {
          "name": "List charges",
          "request": {
            "method": "GET",
            "url": {
              "raw": "{{baseUrl}}/v1/charges?limit=20",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "charges"],
              "query": [{ "key": "limit", "value": "20" }, { "key": "cursor", "value": "", "disabled": true }]
            }
          }
        },
        {
          "name": "Get charge by id",
          "request": {
            "method": "GET",
            "url": { "raw": "{{baseUrl}}/v1/charges/:id", "host": ["{{baseUrl}}"], "path": ["v1", "charges", ":id"], "variable": [{ "key": "id", "value": "3ad7c342-7935-4531-91dd-e059ac9cae34" }] }
          }
        }
      ]
    },
    {
      "name": "Balance",
      "item": [
        {
          "name": "Get balance",
          "request": {
            "method": "GET",
            "url": { "raw": "{{baseUrl}}/v1/balance", "host": ["{{baseUrl}}"], "path": ["v1", "balance"] }
          }
        }
      ]
    },
    {
      "name": "Payouts",
      "item": [
        {
          "name": "Create payout",
          "request": {
            "method": "POST",
            "header": [
              { "key": "Content-Type", "value": "application/json" },
              { "key": "X-Idempotency-Key", "value": "{{$guid}}" }
            ],
            "url": { "raw": "{{baseUrl}}/v1/payouts", "host": ["{{baseUrl}}"], "path": ["v1", "payouts"] },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"amount\": 100000000,\n  \"currency\": \"USDT\",\n  \"network\": \"tron\",\n  \"walletAddress\": \"TXYZabc...\",\n  \"merchantReference\": \"payout-001\"\n}"
            }
          }
        },
        {
          "name": "List payouts",
          "request": {
            "method": "GET",
            "url": { "raw": "{{baseUrl}}/v1/payouts?limit=20", "host": ["{{baseUrl}}"], "path": ["v1", "payouts"], "query": [{ "key": "limit", "value": "20" }] }
          }
        },
        {
          "name": "Get payout by id",
          "request": {
            "method": "GET",
            "url": { "raw": "{{baseUrl}}/v1/payouts/:id", "host": ["{{baseUrl}}"], "path": ["v1", "payouts", ":id"], "variable": [{ "key": "id", "value": "" }] }
          }
        }
      ]
    },
    {
      "name": "Wallets",
      "item": [
        {
          "name": "List wallets",
          "request": { "method": "GET", "url": { "raw": "{{baseUrl}}/v1/wallets", "host": ["{{baseUrl}}"], "path": ["v1", "wallets"] } }
        },
        {
          "name": "Create wallet",
          "request": {
            "method": "POST",
            "header": [{ "key": "Content-Type", "value": "application/json" }, { "key": "X-Idempotency-Key", "value": "{{$guid}}" }],
            "url": { "raw": "{{baseUrl}}/v1/wallets", "host": ["{{baseUrl}}"], "path": ["v1", "wallets"] },
            "body": { "mode": "raw", "raw": "{\n  \"label\": \"Settlement wallet\",\n  \"network\": \"tron\",\n  \"tokenType\": \"usdt\",\n  \"address\": \"TXYZabc...\",\n  \"isDefault\": true\n}" }
          }
        }
      ]
    },
    {
      "name": "Customers",
      "item": [
        {
          "name": "List customers",
          "request": { "method": "GET", "url": { "raw": "{{baseUrl}}/v1/customers", "host": ["{{baseUrl}}"], "path": ["v1", "customers"] } }
        },
        {
          "name": "Get customer by reference",
          "request": {
            "method": "GET",
            "url": { "raw": "{{baseUrl}}/v1/customers/:reference", "host": ["{{baseUrl}}"], "path": ["v1", "customers", ":reference"], "variable": [{ "key": "reference", "value": "" }] }
          }
        }
      ]
    },
    {
      "name": "API keys",
      "item": [
        {
          "name": "List api keys",
          "request": { "method": "GET", "url": { "raw": "{{baseUrl}}/v1/api-keys", "host": ["{{baseUrl}}"], "path": ["v1", "api-keys"] } }
        },
        {
          "name": "Create api key",
          "request": {
            "method": "POST",
            "header": [{ "key": "Content-Type", "value": "application/json" }, { "key": "X-Idempotency-Key", "value": "{{$guid}}" }],
            "url": { "raw": "{{baseUrl}}/v1/api-keys", "host": ["{{baseUrl}}"], "path": ["v1", "api-keys"] },
            "body": { "mode": "raw", "raw": "{\n  \"label\": \"Production backend\",\n  \"mode\": \"LIVE\",\n  \"scopes\": [\"read\", \"write\"]\n}" }
          }
        },
        {
          "name": "Revoke api key",
          "request": {
            "method": "DELETE",
            "url": { "raw": "{{baseUrl}}/v1/api-keys/:id", "host": ["{{baseUrl}}"], "path": ["v1", "api-keys", ":id"], "variable": [{ "key": "id", "value": "" }] }
          }
        }
      ]
    },
    {
      "name": "Webhook endpoints",
      "item": [
        {
          "name": "List endpoints",
          "request": { "method": "GET", "url": { "raw": "{{baseUrl}}/v1/webhook-endpoints", "host": ["{{baseUrl}}"], "path": ["v1", "webhook-endpoints"] } }
        },
        {
          "name": "Create endpoint",
          "request": {
            "method": "POST",
            "header": [{ "key": "Content-Type", "value": "application/json" }, { "key": "X-Idempotency-Key", "value": "{{$guid}}" }],
            "url": { "raw": "{{baseUrl}}/v1/webhook-endpoints", "host": ["{{baseUrl}}"], "path": ["v1", "webhook-endpoints"] },
            "body": { "mode": "raw", "raw": "{\n  \"url\": \"https://your-server.example.com/lidya-webhooks\",\n  \"enabledEvents\": [\"charge.succeeded\", \"charge.failed\", \"payout.completed\"]\n}" }
          }
        },
        {
          "name": "Rotate secret",
          "request": {
            "method": "POST",
            "url": { "raw": "{{baseUrl}}/v1/webhook-endpoints/:id/rotate-secret", "host": ["{{baseUrl}}"], "path": ["v1", "webhook-endpoints", ":id", "rotate-secret"], "variable": [{ "key": "id", "value": "" }] }
          }
        },
        {
          "name": "List deliveries",
          "request": {
            "method": "GET",
            "url": { "raw": "{{baseUrl}}/v1/webhook-endpoints/:id/deliveries?limit=20", "host": ["{{baseUrl}}"], "path": ["v1", "webhook-endpoints", ":id", "deliveries"], "query": [{ "key": "limit", "value": "20" }, { "key": "status", "value": "all" }], "variable": [{ "key": "id", "value": "" }] }
          }
        },
        {
          "name": "Retry delivery",
          "request": {
            "method": "POST",
            "url": { "raw": "{{baseUrl}}/v1/webhook-endpoints/:id/deliveries/:deliveryId/retry", "host": ["{{baseUrl}}"], "path": ["v1", "webhook-endpoints", ":id", "deliveries", ":deliveryId", "retry"], "variable": [{ "key": "id", "value": "" }, { "key": "deliveryId", "value": "" }] }
          }
        }
      ]
    },
    {
      "name": "Events",
      "item": [
        {
          "name": "List events",
          "request": {
            "method": "GET",
            "url": { "raw": "{{baseUrl}}/v1/events?limit=50", "host": ["{{baseUrl}}"], "path": ["v1", "events"], "query": [{ "key": "limit", "value": "50" }, { "key": "type", "value": "" }, { "key": "since", "value": "" }] }
          }
        }
      ]
    },
    {
      "name": "Applications (public)",
      "item": [
        {
          "name": "Submit merchant application",
          "request": {
            "method": "POST",
            "header": [{ "key": "Content-Type", "value": "application/json" }],
            "auth": { "type": "noauth" },
            "url": { "raw": "{{baseUrl}}/v1/applications", "host": ["{{baseUrl}}"], "path": ["v1", "applications"] },
            "body": { "mode": "raw", "raw": "{\n  \"companyName\": \"Example Co\",\n  \"jurisdiction\": \"TR\",\n  \"vertical\": \"forex\",\n  \"monthlyVolumeUSD\": 25000,\n  \"contactName\": \"Jane Doe\",\n  \"contactEmail\": \"jane@example.com\"\n}" }
          }
        }
      ]
    }
  ]
}