Sağlayıcılar
Paycell PAYE

Paycell PAYE

Paycell PAYE, Lunixi Yemek Kartı ürünü altında PAYCELL_PAYE sağlayıcı koduyla kullanılır. Paycell'in kart POS'u, cüzdanı ve Faturana Yansıt bağlantılarından ayrıdır. Bu akışta müşteri uygun PAYE kartını seçer; QR, 2D/3D, taksit ve ön provizyon kullanılmaz.

Bağlantı ve ortam

Panelde Paycell PAYE bağlantısını sağlayıcının verdiği bilgilerle oluşturun. Kullanacağınız TEST/LIVE ortamı, bağlantıdaki ortam ve sağlayıcının hesabınıza verdiği yetkilerle uyumlu olmalıdır. Katalogda bulunması tek başına hesabınızda ödeme alabileceğiniz anlamına gelmez.

TRY ve tek çekim kullanılır. Ödemeyi başlatmak için ortak API ve Checkout Formu sözleşmesi geçerlidir. Aşağıdaki PAYE gereksinimleri her iki giriş yolu için de hazırlanmalıdır.

Sipariş ve müşteri bilgileri

Merchant sunucunuz, ödeme veya form oluşturulmadan önce müşterinin oturum/telefon bağını doğrular. Başlangıç siparişinin metadata alanında iki ayrı nesne gerekir:

Alanİçerik
paycellPaye.mealPer1AmountMerchant vergi sisteminizin Paycell sözleşmesine göre ürettiği zorunlu rakam dizisi
paycellPaye.mealPer1TaxMerchant vergi sisteminizin Paycell sözleşmesine göre ürettiği zorunlu rakam dizisi
paycellPayeAuthorization.customerIdMerchant sisteminizde doğrulanmış müşteri kimliği
paycellPayeAuthorization.msisdnÜlke koduyla telefon numarası; ör. 905321234567
paycellPayeAuthorization.orderIdÖdemenin orderId değeriyle aynı sipariş kimliği
paycellPayeAuthorization.verificationReferenceOturum/telefon doğrulamasının denetim referansı; şifre, OTP veya erişim token'ı değildir

paycellPayeAuthorization, merchant sunucunuzun müşteri bağlamı beyanıdır; Paycell token'ı değildir. Müşteri/telefon doğrulamasının ve sağlayıcının istediği izinlerin doğruluğundan merchant sorumludur. Yalnız başka bir telefon numarası girip kutu işaretlemek bu bağlamı sağlamaz.

İki vergi alanı alıcıdan istenmez. Birim ve hesaplama kurallarını sağlayıcı sözleşmenizden alın; amount alanından varsayımsal bir oran veya dönüşüm üretmeyin. Ödemenin ana amount alanı her zaman kuruş cinsindedir.

Başlangıçtaki mealCard alanları, yöntem listesindeki inputFields tanımına göre gsmNumber ve müşterinin verdiği dataSharingConsent onayını içerir. Kod PAYCELL_PAYE olmalıdır. Paylaşım onayını müşteri adına otomatik işaretlemeyin.

Kart seçimi ve sonuç

Başlatma yanıtı INPUT aksiyonu döndürür. action.input.fields içindeki payeCard seçim alanı, o ödeme için uygun kartların maskeli etiketlerini ve seçim değerlerini taşır. Müşterinin seçtiği değeri mevcut aksiyon confirm sözleşmesine gönderin:

{
  "fields": {
    "payeCard": "<aksiyonda sunulan seçim değeri>"
  }
}

Kart numarası veya sağlayıcının kart kimliğini üretmeyin; yalnız dönen seçim değerini kullanın. Kart seçimi tahsilat başarısı değildir. Kesin sonucu ödeme kaydı ve webhook üzerinden izleyin.

İptal, iade ve mutabakat

PAYE aynı mutabakat gününde tam iptal, sonraki mutabakat günlerinde tam iade kuralını kullanır. Kısmi iade desteklenmez. Panel/API işlemini bağlantının desteklenen yetkilerine göre kullanın; Metropol'ün kısmi iade veya aynı-batch kuralını PAYE'ye uygulamayın.

API mutabakatı sağlayıcının günlük işlem dökümünü kullanır. Belirsiz tahsilat veya ters işlem sonucu ikinci bir istekle tekrarlanmaz; mevcut ödeme ve operasyon kayıtları üzerinden sorgulanır. İşlem dökümü, banka hesabına net ödemenin ulaştığını tek başına kanıtlamaz.