Kart Ödemesi Al

POST/partner/1.0/pos/card/pay

Gerekli scope: payment:sale

Kart veya kayıtlı kart ile manuel ödeme (POS) başlatır.

Örnek

cURL

curl -X POST https://<host>/partner/1.0/pos/card/pay \
  -H "X-Api-Key: ..." \
  -H "X-Timestamp: ..." \
  -H "X-Signature: ..." \
  -H "Content-Type: application/json" \
  -d '{
    "referenceCode": "ORD-1001",
    "paymentMethod": "CARD",
    "amount": 100.00,
    "currency": "TRY",
    "cardNumber": "5406681122223338",
    "cardHolderName": "Test User",
    "expMonth": 12,
    "expYear": 2030,
    "cvv": "000",
    "threeDsEnabled": false,
    "installment": 1
  }'

Node.js

const res = await kaptanRequest('/partner/1.0/pos/card/pay', {
  referenceCode: 'ORD-1001',
  paymentMethod: 'CARD',
  amount: 100.00,
  currency: 'TRY',
  cardNumber: '5406681122223338',
  cardHolderName: 'Test User',
  expMonth: 12,
  expYear: 2030,
  cvv: '000',
  threeDsEnabled: false,
  installment: 1
});
console.log(res);

Java

String res = client.post("/partner/1.0/pos/card/pay", """
{
  "referenceCode": "ORD-1001",
  "paymentMethod": "CARD",
  "amount": 100.00,
  "currency": "TRY",
  "cardNumber": "5406681122223338",
  "cardHolderName": "Test User",
  "expMonth": 12,
  "expYear": 2030,
  "cvv": "000",
  "threeDsEnabled": false,
  "installment": 1
}
""");
System.out.println(res);

İstek Body

referenceCodestringrequired

Sizin tarafınızdaki benzersiz sipariş/işlem referansı.

idempotencyKeystring

Idempotency anahtarı. Verilmezse sunucu otomatik üretir.

paymentMethodenumrequired

Ödeme yöntemi. Yeni kart için CARD, kayıtlı kart için SAVED_CARD.

Allowed: CARDSAVED_CARD

amountdecimalrequired

İşlem tutarı.

currencystringrequired

3 harfli ISO-4217 para birimi kodu (örn. TRY).

customerIdstring

Müşteri kimliği (opsiyonel).

savedCardIdstring

Kayıtlı kart kimliği. paymentMethod=SAVED_CARD için kullanılır.

cardNumberstring

Kart numarası. Plain kart ödemesi (paymentMethod=CARD) için.

cardHolderNamestring

Kart üzerindeki ad-soyad.

expMonthinteger

Son kullanma ayı (1-12).

expYearinteger

Son kullanma yılı (örn. 2030).

cvvstring

Kart güvenlik kodu.

threeDsEnabledboolean

3D Secure akışını etkinleştirir.

installmentinteger

Taksit sayısı. Belirtilmezse tek çekim.