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.mealPer1Amount | Merchant vergi sisteminizin Paycell sözleşmesine göre ürettiği zorunlu rakam dizisi |
paycellPaye.mealPer1Tax | Merchant vergi sisteminizin Paycell sözleşmesine göre ürettiği zorunlu rakam dizisi |
paycellPayeAuthorization.customerId | Merchant 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.verificationReference | Oturum/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.