📟 Ortak Ödeme Sayfasını Kullanmak

POST /api/payment

Ortak ödeme sayfası özelliği, ödeme altyapısı bulunmayan müşterilerin, sistemimize ait güvenli bir ödeme sayfasına yönlendirme yaparak ödeme almasını sağlar. Müşteri, belirli parametrelerle birlikte ödeme sayfasına yönlendirilir. Ödeme tamamlandığında, sistem tanımlanan return_url adresine yönlendirme yapar. Müşteri, yönlendirme sonrası payment_id gibi temel parametreleri kullanarak ödeme durumunu API üzerinden sorgulayabilir ve işlemi kendi sisteminde sonuçlandırabilir.

🧾 Örnek Request

curl https://sandbox-pgw.klogs.io/api/payment \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer API_KEY' \
  --data '{
  "amount": 1,
  "currency": "TRY",
  "reference": "",
  "invoice": {
    "name": null,
    "surname": null,
    "countryCode": null,
    "city": null,
    "district": null,
    "street1": null,
    "street2": null,
    "number": null,
    "postalCode": null,
    "company": null,
    "phone": null,
    "fax": null
  },
  "shipping": {
    "name": null,
    "surname": null,
    "countryCode": null,
    "city": null,
    "district": null,
    "street1": null,
    "street2": null,
    "number": null,
    "postalCode": null,
    "company": null,
    "phone": null,
    "fax": null
  },
  "explanation": null,
  "additionalData": null,
  "email": "",
  "phone": "",
  "returnURL": null,
  "chargeType": "directSale",
  "fullName": "",
  "nationalNumber": null,
  "products": [
    {
      "id": null,
      "category": null,
      "quantity": 1,
      "code": null,
      "description": null,
      "price": 1
    }
  ],
  "paymentSystemId": null,
  "paymentSystemGroupId": null
}'

Params

Name	Location	Type	Required	Description
body	body	HostedPaymentRequest	no	none

Response Examples

200 Response

{"success":true,"error":{"summary":"string","errorObject":null},"link":"string","paymentId":"string"}

Responses

HTTP Status Code	Meaning	Description	Data schema
200	OK	OK	CreateHostedPaymentResponse
401	Unauthorized	Unauthorized	ProblemDetails
403	Forbidden	Forbidden	ProblemDetails

---

💡 Ekstra İpuçları

• Güvenlik: Authorization header'ında geçerli bir Bearer Token kullanılmalıdır.
• Loglama: Kişisel veri ve ödeme bilgileri loglanmamalıdır.
• Test Ortamı: Ödeme testleri için sandbox ortamı kullanılabilir.
• Idempotency: Aynı reference kodu ile birden fazla istek yapılmamalıdır.