{
  "info": {
    "_postman_id": "cf3e54f9-d95b-4085-b312-ae877b0508ae",
    "name": "Sanal POS API v1",
    "description": "Sanal POS API'si.\n\n**Kimlik doğrulama:** `/external/...` altındaki her istek koleksiyonun pre-request script'i ile otomatik imzalanır (`X-Api-Key`, `X-Timestamp`, `X-Signature`). Ortamda `baseUrl`, `apiKey`, `secretKey` tanımlı olmalı.\n\n**Klasörler:**\n1. *Ödeme sayfası*: e-ticaret entegrasyonları için önerilen akış (kart bilgisi sizde olmaz).\n2. *Ödeme sayfası - public*: checkout sayfasının token ile çağırdığı uçlar (imzasız).\n3. *Kartla ödeme*: kart bilgisini kendiniz aldığınız akış (PCI DSS gerekir).\n4. *Bilgi*: taksit ve komisyon sorguları.\n\nAynı imza iki kez kabul edilmez; Postman her gönderimde yeniden imzalar.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "event": [
    {
      "listen": "prerequest",
      "script": {
        "type": "text/javascript",
        "exec": [
          "// Requests that create something get a fresh ID here, before signing:",
          "// Postman runs this collection script before the request's own script",
          "const freshIds = { 'Oturum oluştur': ['orderId', 'WC-'], 'Ödeme başlat': ['transactionId', 'TX'] };",
          "const fresh = freshIds[pm.info.requestName];",
          "if (fresh) pm.collectionVariables.set(fresh[0], `${fresh[1]}${Date.now()}`);",
          "",
          "// Signs every merchant endpoint (/external/...) the way the API expects:",
          "// X-Signature = HMAC-SHA256(timestamp \\n METHOD \\n path?query \\n rawBody, secretKey)",
          "const fullUrl = pm.variables.replaceIn(pm.request.url.toString());",
          "const path = fullUrl.replace(/^https?:\\/\\/[^/]+/, '');",
          "if (path.startsWith('/external/')) {",
          "  const body = pm.request.body && pm.request.body.raw ? pm.variables.replaceIn(pm.request.body.raw) : '';",
          "  const timestamp = Math.floor(Date.now() / 1000).toString();",
          "  const signature = CryptoJS.HmacSHA256(",
          "    `${timestamp}\\n${pm.request.method}\\n${path}\\n${body}`,",
          "    pm.variables.get('secretKey'),",
          "  ).toString(CryptoJS.enc.Hex);",
          "  pm.request.headers.upsert({ key: 'X-Api-Key', value: pm.variables.get('apiKey') });",
          "  pm.request.headers.upsert({ key: 'X-Timestamp', value: timestamp });",
          "  pm.request.headers.upsert({ key: 'X-Signature', value: signature });",
          "}"
        ]
      }
    }
  ],
  "item": [
    {
      "name": "Ödeme sayfası",
      "item": [
        {
          "name": "Oturum oluştur",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept-Language",
                "value": "tr"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/external/vpos/v1/checkout-sessions",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "external",
                "vpos",
                "v1",
                "checkout-sessions"
              ]
            },
            "description": "Sipariş için ödeme oturumu açar ve müşterinin yönlendirileceği `paymentUrl`'i döner. Aynı sipariş için yeni oturum açılırsa öncekiler iptal edilir.\n\n`items` gönderilirse `productPrice × quantity` toplamı `order.amount`'a eşit olmalı (`amount` değişkeni 1249.90).",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"order\": {\n    \"orderId\": \"{{orderId}}\",\n    \"amount\": {{amount}},\n    \"description\": \"Sipariş #{{orderId}}\",\n    \"maxInstallment\": 6,\n    \"expiresInMinutes\": 60\n  },\n  \"customer\": {\n    \"name\": \"Ada\",\n    \"surname\": \"Yılmaz\",\n    \"email\": \"ada@example.com\",\n    \"phoneNumber\": \"5550000000\"\n  },\n  \"items\": [\n    {\n      \"productId\": \"A1\",\n      \"productName\": \"Keten gömlek\",\n      \"productPrice\": 649.9,\n      \"quantity\": 1\n    },\n    {\n      \"productId\": \"B7\",\n      \"productName\": \"Pamuklu çorap\",\n      \"productPrice\": 150,\n      \"quantity\": 2\n    },\n    {\n      \"productId\": \"SHIP\",\n      \"productName\": \"Kargo\",\n      \"productPrice\": 300,\n      \"quantity\": 1\n    }\n  ],\n  \"urls\": {\n    \"successUrl\": \"{{successUrl}}\",\n    \"failUrl\": \"{{failUrl}}\"\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('200', () => pm.response.to.have.status(200));",
                  "const { content } = pm.response.json();",
                  "pm.collectionVariables.set('checkoutToken', content.token);",
                  "pm.test('paymentUrl döndü', () => pm.expect(content.paymentUrl).to.include(content.token));",
                  "console.log('Ödeme sayfası:', content.paymentUrl);"
                ]
              }
            }
          ]
        },
        {
          "name": "Oturum durumu",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept-Language",
                "value": "tr"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/external/vpos/v1/checkout-sessions/{{checkoutToken}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "external",
                "vpos",
                "v1",
                "checkout-sessions",
                "{{checkoutToken}}"
              ]
            },
            "description": "Oturumun durumu (OPEN, COMPLETED, CANCELLED, EXPIRED), başarılı ödeme ve tüm denemeler."
          },
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('200', () => pm.response.to.have.status(200));",
                  "pm.test('status var', () => pm.expect(pm.response.json().content.status).to.be.a('string'));"
                ]
              }
            }
          ]
        }
      ]
    },
    {
      "name": "Ödeme sayfası - public (token ile)",
      "item": [
        {
          "name": "Oturum bilgisi",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept-Language",
                "value": "tr"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/checkout-sessions/{{checkoutToken}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "checkout-sessions",
                "{{checkoutToken}}"
              ]
            },
            "description": "Sayfada gösterilecek tutar, sepet, mağaza adı ve logosu."
          },
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('Oturum bilgisi döndü', () => pm.response.to.have.status(200));",
                  "const { content } = pm.response.json();",
                  "pm.test('Tutar ve mağaza var', () => {",
                  "  pm.expect(content.amount).to.be.a('number');",
                  "  pm.expect(content.merchant.companyName).to.be.a('string');",
                  "});"
                ]
              }
            }
          ]
        },
        {
          "name": "Taksitler",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept-Language",
                "value": "tr"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/checkout-sessions/{{checkoutToken}}/installments?binCode=43550800",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "checkout-sessions",
                "{{checkoutToken}}",
                "installments"
              ],
              "query": [
                {
                  "key": "binCode",
                  "value": "43550800",
                  "description": "Kart numarasının ilk 6-8 hanesi; 8 hane kartı kesin belirler"
                },
                {
                  "key": "showAllInstallments",
                  "value": "true",
                  "description": "Banka/ön ödemeli kartta tüm taksitleri listeler",
                  "disabled": true
                }
              ]
            },
            "description": "Kartın bankasına göre taksitler; oturumun tutarı ve maxInstallment değeriyle süzülüp hesaplanır. Banka/ön ödemeli kartta `singlePaymentSuggested: true` döner; `showAllInstallments=true` ile tüm taksitler açılır."
          },
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('Taksitler döndü', () => pm.response.to.have.status(200));",
                  "pm.test('installments listesi var', () => {",
                  "  pm.expect(pm.response.json().content.installments).to.be.an('array');",
                  "});"
                ]
              }
            }
          ]
        },
        {
          "name": "Ödeme (kartla)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept-Language",
                "value": "tr"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/checkout-sessions/{{checkoutToken}}/pay",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "checkout-sessions",
                "{{checkoutToken}}",
                "pay"
              ]
            },
            "description": "⚠️ Sağlayıcıda gerçek bir 3D ödeme başlatır. Dönen `url`/`form` ile 3D ekranına gidilir.\n\nKart reddedildikten sonra tekrar denerken `retryOfTransactionId` gönderilirse ilk sağlayıcı atlanır.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"cardNumber\": \"4355084355084358\",\n  \"cardHolderName\": \"Test Kart\",\n  \"expiryMonth\": 7,\n  \"expiryYear\": 2030,\n  \"cvv\": \"000\",\n  \"installment\": 1\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "if (pm.response.code === 200) {",
                  "  const { content } = pm.response.json();",
                  "  pm.collectionVariables.set('checkoutTransactionId', content.transactionId);",
                  "  pm.test('3D bilgisi döndü', () => pm.expect(content.url || content.form).to.be.a('string'));",
                  "} else {",
                  "  // 400: kart/taksit/oturum hatası; mesaj cevapta",
                  "  console.log(pm.response.json().message);",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "3D sonrası dönüş",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept-Language",
                "value": "tr"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/checkout-sessions/{{checkoutToken}}/return?transactionId={{checkoutTransactionId}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "checkout-sessions",
                "{{checkoutToken}}",
                "return"
              ],
              "query": [
                {
                  "key": "transactionId",
                  "value": "{{checkoutTransactionId}}",
                  "description": "Ödeme denemesinin işlem no'su"
                }
              ]
            },
            "description": "Sağlayıcının 3D sonrası yönlendirdiği adres. Sonucu veritabanından okur ve müşteriyi mağazaya ya da tekrar denemek için ödeme sayfasına gönderen bir HTML döner (iframe içindeyse postMessage ile)."
          },
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('HTML yönlendirme sayfası döndü', () => {",
                  "  pm.response.to.have.status(200);",
                  "  pm.expect(pm.response.headers.get('Content-Type')).to.include('text/html');",
                  "  pm.expect(pm.response.text()).to.include('checkout:return');",
                  "});"
                ]
              }
            }
          ]
        },
        {
          "name": "İptal / Mağazaya dön",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept-Language",
                "value": "tr"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/checkout-sessions/{{checkoutToken}}/cancel",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "checkout-sessions",
                "{{checkoutToken}}",
                "cancel"
              ]
            },
            "description": "Oturumu kapatır ve müşteriyi imzalı parametrelerle mağazanın failUrl adresine yönlendirir (302). Bu istekten sonra oturum ödeme kabul etmez."
          },
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('Mağazaya yönlendiriyor', () => {",
                  "  pm.expect(pm.response.code).to.be.oneOf([301, 302]);",
                  "  const location = pm.response.headers.get('Location');",
                  "  pm.expect(location).to.include('signature=');",
                  "  console.log('Yönlendirme:', location);",
                  "});"
                ]
              }
            }
          ],
          "protocolProfileBehavior": {
            "followRedirects": false
          }
        }
      ]
    },
    {
      "name": "Kartla ödeme (PCI)",
      "item": [
        {
          "name": "Ödeme başlat",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept-Language",
                "value": "tr"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/external/vpos/v1/payments",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "external",
                "vpos",
                "v1",
                "payments"
              ]
            },
            "description": "⚠️ Kart bilgisini sizin sunucunuz alır (PCI DSS gerekir). Sağlayıcıda gerçek bir 3D ödeme başlatır.\n\n200: `content.threeD` ile 3D ekranına gidilir. 422: banka ödemeyi başlatmadı. 409: transactionId kullanılmış.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"transactionId\": \"{{transactionId}}\",\n  \"amount\": {{amount}},\n  \"installment\": 1,\n  \"description\": \"Sipariş #1001\",\n  \"returnUrl\": \"{{successUrl}}\",\n  \"card\": {\n    \"holderName\": \"Test Kart\",\n    \"number\": \"4355084355084358\",\n    \"expiryMonth\": \"07\",\n    \"expiryYear\": \"2030\",\n    \"cvv\": \"000\"\n  },\n  \"customer\": {\n    \"name\": \"Ada\",\n    \"surname\": \"Yılmaz\",\n    \"email\": \"ada@example.com\",\n    \"phoneNumber\": \"5550000000\",\n    \"ip\": \"85.105.12.34\"\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('200 veya 422', () => pm.expect(pm.response.code).to.be.oneOf([200, 422]));",
                  "if (pm.response.code === 200) {",
                  "  const { threeD } = pm.response.json().content;",
                  "  pm.test('3D bilgisi döndü', () => pm.expect(threeD.url || threeD.form).to.be.a('string'));",
                  "} else {",
                  "  console.log(pm.response.json().message);",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "Ödeme durumu",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept-Language",
                "value": "tr"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/external/vpos/v1/payments/{{transactionId}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "external",
                "vpos",
                "v1",
                "payments",
                "{{transactionId}}"
              ]
            },
            "description": "Ödemenin güncel durumu. Siparişi onaylamadan önce sunucudan sorgulayın."
          },
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('200', () => pm.response.to.have.status(200));",
                  "pm.test('aynı işlem', () => pm.expect(pm.response.json().content.transactionId).to.eql(pm.collectionVariables.get('transactionId')));"
                ]
              }
            }
          ]
        },
        {
          "name": "İade",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept-Language",
                "value": "tr"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/external/vpos/v1/payments/{{transactionId}}/refund",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "external",
                "vpos",
                "v1",
                "payments",
                "{{transactionId}}",
                "refund"
              ]
            },
            "description": "Başarılı ödemenin tamamını iade eder. Gövde gönderilmez.\n\n409: ödeme başarılı değil veya zaten iade edildi. 422: banka iadeyi reddetti."
          },
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('200 veya 409', () => pm.expect(pm.response.code).to.be.oneOf([200, 409]));"
                ]
              }
            }
          ]
        }
      ]
    },
    {
      "name": "Bilgi",
      "item": [
        {
          "name": "Taksitler",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept-Language",
                "value": "tr"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/external/vpos/v1/installments?binCode=43550800&amount={{amount}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "external",
                "vpos",
                "v1",
                "installments"
              ],
              "query": [
                {
                  "key": "binCode",
                  "value": "43550800",
                  "description": "Kart numarasının ilk 6-8 hanesi; 8 hane kartı kesin belirler"
                },
                {
                  "key": "amount",
                  "value": "{{amount}}"
                },
                {
                  "key": "showAllInstallments",
                  "value": "true",
                  "description": "Banka/ön ödemeli kartta tüm taksitleri listeler",
                  "disabled": true
                }
              ]
            },
            "description": "Kart BIN'ine göre üye işyerinin taksit seçenekleri. `amount` verilirse tutar sınırına uymayan taksitler çıkarılır, tutarlar ve kampanya bu tutara göre hesaplanır. Kart banka/ön ödemeli kart görünüyorsa `singlePaymentSuggested: true` döner ve yalnızca tek çekim listelenir; `showAllInstallments=true` ile tüm taksitler açılır."
          },
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('200', () => pm.response.to.have.status(200));",
                  "pm.test('taksit listesi', () => pm.expect(pm.response.json().content.installments).to.be.an('array'));"
                ]
              }
            }
          ]
        },
        {
          "name": "Komisyonlar",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept-Language",
                "value": "tr"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/external/vpos/v1/commissions?amount={{amount}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "external",
                "vpos",
                "v1",
                "commissions"
              ],
              "query": [
                {
                  "key": "amount",
                  "value": "{{amount}}"
                }
              ]
            },
            "description": "Tüm bankaların taksit komisyonları ve tutara göre hesaplanmış tutarlar."
          },
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('200', () => pm.response.to.have.status(200));",
                  "pm.test('banka listesi', () => pm.expect(pm.response.json().content).to.be.an('array'));"
                ]
              }
            }
          ]
        }
      ]
    }
  ],
  "variable": [
    {
      "key": "amount",
      "value": "1249.90"
    },
    {
      "key": "orderId",
      "value": ""
    },
    {
      "key": "checkoutToken",
      "value": ""
    },
    {
      "key": "transactionId",
      "value": ""
    },
    {
      "key": "checkoutTransactionId",
      "value": ""
    },
    {
      "key": "successUrl",
      "value": "https://webhook.site/your-id"
    },
    {
      "key": "failUrl",
      "value": "https://webhook.site/your-id"
    }
  ]
}