Ödeme Linki Oluştur

POST/partner/1.0/payment/link/create

Gerekli scope: collection:link

Alıcıya gönderilebilecek bir tahsilat (ödeme) linki oluşturur. Ödeme sonrası opsiyonel olarak ürün kalemlerinden otomatik sipariş oluşturulabilir.

Örnek

cURL

curl -X POST https://<host>/partner/1.0/payment/link/create \
  -H "X-Api-Key: ..." \
  -H "X-Timestamp: ..." \
  -H "X-Signature: ..." \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 100.00,
    "currency": "TRY",
    "description": "Sipariş ORD-1001",
    "expiryDate": "2026-07-20T12:00:00Z",
    "enableInstallment": true,
    "availableInstallments": "1,3,6",
    "userAddressRequired": false,
    "email": "customer@example.com"
  }'

Node.js

const res = await kaptanRequest('/partner/1.0/payment/link/create', {
  amount: 100.00,
  currency: 'TRY',
  description: 'Sipariş ORD-1001',
  expiryDate: '2026-07-20T12:00:00Z',
  enableInstallment: true,
  availableInstallments: '1,3,6',
  userAddressRequired: false,
  email: 'customer@example.com'
});
console.log(res);

Java

String res = client.post("/partner/1.0/payment/link/create", """
{
  "amount": 100.00,
  "currency": "TRY",
  "description": "Sipariş ORD-1001",
  "expiryDate": "2026-07-20T12:00:00Z",
  "enableInstallment": true,
  "availableInstallments": "1,3,6",
  "userAddressRequired": false,
  "email": "customer@example.com"
}
""");
System.out.println(res);

İstek Body

amountdecimalrequired

Tahsil edilecek tutar.

Default: 0

cartAmountdecimal

Sepet tutarı. Belirtilmezse amount ile aynı kabul edilir.

currencyenum

Para birimi (ISO-4217).

Default: TRY

Allowed: TRYUSDEURGBP

descriptionstring

Link açıklaması.

expiryDatestring

Linkin son geçerlilik tarihi (ISO-8601). Geçmiş bir tarih reddedilir.

enableInstallmentboolean

Taksit imkanını etkinleştirir.

Default: true

availableInstallmentsstring

İzin verilen taksit sayıları, virgülle ayrık (örn. "1,3,6,12"). Verilmezse sınır yok.

userAddressRequiredboolean

Ödeme sırasında alıcıdan adres istenip istenmeyeceği.

Default: false

itemsarray<object>

Opsiyonel ürün kalemleri. Ödeme sonrası otomatik sipariş oluşturmak için kullanılır.

emailstring

Alıcı e-posta adresi.

phoneCountryCodestring

Alıcı telefon ülke kodu.

phoneNumberstring

Alıcı telefon numarası.