Yazılımlar 3D Secure Entegrasyon Kılavuzu Dokümantasyon
Entegrasyon Kılavuzu 3D Secure
01.01.2021 tarihinden itibaren iki faktörlü kimlik doğrulama, tüm e-ticaret kartı ödeme işlemleri için zorunlu bir gereklilik olarak uygulanacaktır. Bu yükümlülüğe uymak için,
kredi kartı ağlarının operatörleri sözde 3D Secure prosedürünü kullanacaklardır. Satıcı olarak sizin için müşterileriniz için bu prosedürü şu tarihten itibaren gerçekleştirmeniz zorunludur:
01.01.2021. Aşağıda, farklı entegrasyon yollarının bir açıklamasını ve bunlar için 3D Secure prosedürünün nasıl uygulanması gerektiğini bulacaksınız.
Lütfen kullandığınız entegrasyon yöntemini seçin
- HCO ödeme formunu mu kullanıyorsunuz?
- HPF ödeme formunu mu kullanıyorsunuz?
- Unzer sistemi tarafından sağlanan bir formu kullanmadan ödemeleri yapıyor musunuz?
Lütfen aklınızda bulundurun: Borçların veya ön provizyonların (rezervasyonların) hangi şekilde yapıldığı da önemlidir. Kart verilerinin kaydı için Unzer GmbH'den bir ödeme formu kullansanız bile, 3D Secure işlemi, kart verileri ilk kez borçlandırıldığında veya ilk kez yetkilendirildiğinde ödeme formu olmadan gerçekleştirilecektir. Bu durumda, Unzer tarafından sağlanan form olmadan üçüncü entegrasyon yolu geçerlidir.
Lütfen şunları da unutmayın:
Yinelenen ödemeler (abonelik ödemeleri) kullanıyorsanız, "3D Güvenli ve Yinelenen Ödeme" bölümünü okuduğunuzdan emin olun.
HCO ödeme formunu kullanırken 3D Secure prosedürü
HCO ödeme formu zaten 3D Secure prosedürü için tasarlanmıştır. Prosedürün uygulanması için sizin tarafınızdan herhangi bir ek işlem yapmanız gerekmez. Sen yine de
3D Secure işleminin başlaması durumunda, sisteminizin ödeme sistemimizin ilgili yanıtlarını işleyebileceğinden emin olmalısınız. Asenkron yanıtta
sunucunuza ödeme sistemi, işlemin sonucu iletilir ve iade edilmeden önce orada değerlendirilmesi gerekir. URL ödeme sistemine iletilir.
Bu amaçla aşağıdaki parametreler değerlendirilmelidir.
- İŞLEME.İADE.KODU = 000.200.000
- PROCESSING.RETURN = İşlem + beklemede
- İŞLENİYOR.SONUÇ = ACK
Açıklama: İşlemin durumu "beklemede", PROCESSING parametresi. SONUÇ
yalnızca bir ön sonucu temsil eder. 3D Secure işlemi gerçekleştirildiği sürece durum
beklemede kal.
İşlemin nihai sonucu o zaman ya
- İŞLEME.İADE.KODU = 000.000.000
- İŞLENİYOR.SONUÇ = ACK
or - PROCESSING.RETURN.CODE = irgendein Wert ungleich 000.000.000 veya 000.200.000
- İŞLEME.SONUÇ = HAYIR
İlk durumda işlem başarıyla tamamlanmış, ikinci durumda ise genel olarak başarısız olmuştur. İkincisinin, kimlik doğrulamayı reddetme gibi çeşitli nedenleri olabilir. Olacaksın
"PROCESSING.RETURN" ve "PROCESSING.RETURN.CODE" parametrelerinde daha ayrıntılı bilgi alın.
Her iki mesaj için de bir test yapmanızı öneririz. Bir testin nasıl yapılacağı ve test için hangi kredi kartı ayrıntılarını kullanabileceğiniz hakkında daha fazla bilgi için lütfen aşağıya bakın.
HPF ödeme formunu kullanırken 3D Secure prosedürü
HPF ödeme formu ayrıca zaten 3DS prosedürünü kullanmak için tasarlanmıştır. Prosedürün uygulanması için sizin tarafınızdan herhangi bir ek işlem yapmanız gerekmez. Tarif edildiği gibi
hCO uygulaması için ödeme sisteminden gelen yanıt iki adımda gerçekleşir, bu nedenle sisteminiz PROCESSING.RETURN.CODE değerini kontrol etmelidir.
yanıtı işlerken parametre.
Bu amaçla aşağıdaki parametreler değerlendirilmelidir.
- İŞLEME.İADE.KODU = 000.200.000
- PROCESSING.RETURN = İşlem + beklemede
- İŞLENİYOR.SONUÇ = ACK
Açıklama: İşlemin durumu "beklemede" dir, PROCESSING.RESULT parametresi yalnızca bir ön sonucu temsil eder. 3D Secure işlemi gerçekleştirildiği sürece durum
beklemede kal.
İşlemin nihai sonucu o zaman ya
- İŞLEME.İADE.KODU = 000.000.000
- İŞLENİYOR.SONUÇ = ACK
or - PROCESSING.RETURN.CODE = irgendein Wert ungleich 000.000.000 veya 000.200.000
- İŞLEME.SONUÇ = HAYIR
İlk durumda işlem başarıyla tamamlanmış, ikinci durumda ise genel olarak başarısız olmuştur. İkincisinin, kimlik doğrulamayı reddetme gibi çeşitli nedenleri olabilir. Olacaksın
"PROCESSING.RETURN" ve "PROCESSING.RETURN.CODE" parametrelerinde daha ayrıntılı bilgi alın.
Her iki mesaj için de bir test yapmanızı öneririz. Bir testin nasıl yapılacağı ve test için hangi kredi kartı ayrıntılarını kullanabileceğiniz hakkında daha fazla bilgi için lütfen aşağıya bakın.
Doğrudan bağlantılı 3D Secure prosedürü
Kredi kartı ödemelerini işleme koymak için Unzer (eski adıyla heidelpay) tarafından sağlanan bir ödeme formunu kullanmıyorsanız veya yalnızca formlardan birini kullanarak bir kart kaydettirirseniz ve kayda referans olarak ön provizyonu (rezervasyon) veya banka kartını işleme koyarsanız ödeme sistemiyle doğrudan iletişim kurduğunuzda, 3D Secure sürecini uygulamanız gerekir.
Eşzamansız işlem akışı:
Bu, sunucunuzun bir yönlendirme aldığı eşzamansız bir işlemdir. URL (Yönlendir URL) ödeme sistemimizden. Sunucunuz müşteriyi buna yönlendirmelidir URL böylece doğrulamayı 3D Secure prosedürü aracılığıyla gerçekleştirebilir. Bu 3D Secure kimlik doğrulamasının sonucu, kartı veren banka tarafından doğrudan Unzer'e bildirilir.
Başarılı bir kimlik doğrulamasından sonra, işlem, sisteminize yanıt vereceğiniz genel bir sonuç göndererek zaten bildiğiniz şekilde Unzer sisteminde işlenir.
yönlendirme ile URL. Ödeme sistemi daha sonra bu yönlendirmeyi kullanarak müşteriyi sisteminize geri yönlendirecektir. URL sisteminizden
Lütfen dikkat: Bu iş akışında sisteminiz ödeme sisteminden iki yanıt alır:
– Biri “beklemede” (İŞLENİYOR.İADE.KODU=000.200.000 ve İŞLENİYOR.RETURN=İşlem+beklemede) durumunda ve müşterinin kartını veren bankasına yönlendirme parametreleri
- Borç veya rezervasyonun nihai sonucunu içeren bir tane. Ayrıca iki yönlendirme var URLBu süreçte bahsedilenler, müşterinin kartını veren bankada kimlik doğrulaması için yönlendirilmesi gereken ödeme sisteminden ve sisteminizden son sonucu alırken müşteriyi tekrar sisteminize yeniden yönlendirmek için yönlendirilmesi gereken bir sistemdir.
Normal prosedürde aşağıdaki değişiklikler yapılacaktır. Paypal gibi diğer eşzamansız ödeme yöntemlerinin uygulanması nedeniyle, bunlardan bazılarının
işlemler uygulamanızda zaten mevcut olabilir.
- Cevap URL
Ödeme sistemine yapılan ilk aramada (şemada 2 numaralı), "Cevap URL"Ön uç grubunda geçirilmelidir.
Lütfen aklınızda bulundurun: IDENTIFICATION.REFERENCEID parametresi yalnızca bir kayda veya halihazırda mevcut başka bir işleme atıfta bulunmanız durumunda geçerlidir. - Yönlendirme işleniyor URL Kimlik doğrulama gerekliyse, bir yeniden yönlendirme URL ve yönlendirme grubundaki diğer parametreler, ödeme sisteminden gelen yanıtta aktarılır (diyagramda 5 numara).
- Müşterinin yönlendirmeye yönlendirilmesi URL
Yönlendirme grubu bir yönlendirme ile yanıt veriyorsa URL, müşterinin tarayıcısı buna yeniden yönlendirilmelidir URL (şemada No. 6) kimlik doğrulaması gerçekleştirmek için. Yönlendirme grubundan ek parametreler harici gruba aktarılmalıdır. webPOST parametreleri olarak site.
Lütfen unutmayın: "PROCESSING.REDIRECT.xxx" grubunda yalnızca 3D Secure Sürüm 1'de (orada bile sayı ve adlandırma değişebilir) ek parametreler döndürülürken, 3D Sürüm 2'de yalnızca bir PROCESSING.YÖNLENDİRME.URL aşağıda gösterildiği gibi döndürülür: https://heidelpay.hpcgw.net/AuthService/v1/auth/public/2258_2863FFA4C5241C12E39F37
CCF / run Bu, parametrelerin türü ve sayısı ne olursa olsun, istemci tarayıcısının PROCESSING.REDIRECT'e yeniden yönlendirmesi gerektiği anlamına gelir.URL.
Aşağıda basit bir kod bulacaksınızampböyle bir yönlendirmenin nasıl yürütülebileceğine ilişkin bilgi. NS bölümü, sistemleri Javascript'i desteklemeyen veya devre dışı bırakan son müşterileri bilgilendirmeyi amaçlamaktadır. Yönlendirmenin müşterinin etkin tarayıcı penceresinde yapılmasını ve açılır pencereleri veya yeni tarayıcı pencerelerini kullanmamasını şiddetle tavsiye ederiz, çünkü bu mümkün olabilir.
müşterileri sinirlendirmek ve yönlendirildikleri sayfayı kapatmalarını sağlamak.
- Eşzamansız sonuç kontrolü
Kimlik doğrulamanın sonucu, sunucunuza eşzamansız olarak gönderilir. Ödeme sistemi geçerli bir URL yanıt olarak. (Şemada No. 12 ve 13). Başarılı veya reddedilmiş için
ödemeler, farklı URL sisteminiz tarafından buradan yanıtlanabilir. - Müşterinin dönüş yolu
Ödeme sistemi müşteriyi şuraya yönlendirir: URL kimlik doğrulama işlemi ve ödeme işlemi tamamlandıktan sonra üye işyeri sistemi tarafından sağlanır.
Lütfen dikkat: Adım 4.) ve 5.), mevcut NONE 3D Secure işlemlerinde zaten aşina olduğunuz şekilde ilerleyin.
3D Güvenli ve Yinelenen Ödeme
1 Ocak 2021'den itibaren tüm e-ticaret kartı işlemlerinde 3D Secure zorunlu olacaktır. Ancak, bu yinelenen ödemeler için pek geçerli olmadığından, bankacılık
sistemler bunun için ayrı bir iş akışına sahiptir.
Bu amaçla, bankalar arasında ayrım yapar
- CIT = müşteri tarafından başlatılan işlemler
- MIT = tüccar başlatılmış işlemler
Üye işyeri hesabınızdaki bir kartın ilk işlemi 3 tarihinden itibaren 01.01.2021D Secure ile doğrulanmalıdır. Böyle başarılı bir kimlik doğrulama,
3D Secure olmadan aynı karttan daha sonra başka rezervasyonlar gönderebilmek için. Bu nedenle müşteri, ilk ödeme için kartını veren bankaya yönlendirilmelidir.
yukarıda açıklanan prosedüre uygun olarak ve orada kart sahibi olarak kimliğini doğrulayın. Sipariş sırasında bir borçlandırma planlanmamışsa, örneğinampdeneme süresi nedeniyle, müşterinin huzurunda 3D Secure ile en az bir Euro'luk rezervasyon (ön provizyon) yapılmalıdır. Bu rezervasyonun yakalanması gerekli değildir.
Ancak mevcut müşteriler için 3D Secure kimlik doğrulamasının yapılması gerekmez. İlk başarılı borçlandırma 01.01.2021 tarihinden önce gerçekleştiyse, müşteri kaydının da olduğu varsayılabilir.
başarıyla doğrulandı. 01.01.2021 tarihinden itibaren yeni müşteriler için ise 3D Secure kimlik doğrulaması ilk ödeme veya rezervasyon için zorunludur (ön provizyon).
Lütfen dikkat: Bu konuda bankacılık sistemi müşteri verilerine değil kart verilerine bakar. Yani mevcut bir müşteri 01.01.2021 tarihinden sonra yeni bir kart kullanırsa, örneğinampçünkü önceki
birinin süresi dolmuş veya kartını veren bankayı değiştirmişse, bu, bankaların bakış açısından yeni bir tekrar eden döngüdür. view ve ilk rezervasyon için 3D Secure ile kimlik doğrulaması yapılmalıdır.
Bu ilk kimlik doğrulaması başarıyla gerçekleştirildikten sonra, tüm diğer işlemler 3D Secure kullanma yükümlülüğünden muaftır Bu nedenle, 3D Secure olmadan tekrarlayan ödemenin ön koşulları şunlardır:
- 3D Secure ile gerçekleştirilen veya 01.01.2021 tarihinden önce gerçekleşen en az bir başarılı ödeme veya rezervasyon (ön provizyon) vardır.
- mevcut bir kayda ve gönderimin ardından borçlandırmaya atıfta bulunulur
Ödeme sistemine bunun yinelenen bir ödeme olduğunu bildirmek için RECURRENCE.MODE = REPEATED parametresi de gönderilmelidir. Bu, sisteme bir
mükerrer ödeme bankacılık sistemlerine bildirilecektir.
Lütfen dikkat: RECURRENCE.MODE = REPEATED parametresi, yeni bir kart ilk kez yüklendiğinde girilirse, bu parametreye rağmen 3D Secure iletimi gerçekleştirilecektir.
3D Secure uygulamasını test etme
3D Secure bağlantısını istediğiniz zaman ödeme sistemimiz üzerinden test edebilirsiniz. Bunu yapmak için, ex'te gösterildiği gibi bir işlem için "CONNECTOR_TEST" modunu kullanın.ampyukarıdakiler.
Bu test için bağlantı verileri:
| GÜVENLİK SENSÖRÜ | 31HA07BC8142C5A171745D00AD63D182 |
| KULLANICI GİRİŞİ | 31ha07bc8142c5a171744e5aef11ffd3 |
| KULLANICI.PWD | 93167DE7 |
| İŞLEM.KANAL | 31HA07BC8142C5A171749A60D979B6E4 |
| 3D Sürüm 2 için yapılandırılan para birimleri | EUR, USD, SEK |
| 3D Sürüm 1 için yapılandırılan para birimleri | GBP, CZK, CHF |
Sistem ağ geçidi uç noktası,
SGW ağ geçidi:
- https://test-heidelpay.hpcgw.net/sgw/gtw - Latin-15 kodlu
- https://test-heidelpay.hpcgw.net/sgw/gtwu - UTF-8 kodlu
NGW ağ geçidi:
- https://test-heidelpay.hpcgw.net/ngw/post
Bu test için kredi kartı verileri:
| markalar | kart numaraları | Özgeçmiş | Son kullanma tarihi | Not |
| MasterCard | 5453010000059543 | 123 | gelecek tarih | 3D - şifre: gizli3 |
| Visa | 4711100000000000 | 123 | gelecek tarih | 3DS - şifre: gizli! 33 |
Lütfen dikkat: 3D Secure Sürüm 2 için bir şifre girmenize gerek yoktur, sadece "Kimlik doğrulamayı tamamlamak için burayı tıklayın" bağlantısını tıklayın.
3D Secure Sürüm 2 ile bir hatayı simüle etmenin tek yolu, bağlantının bulunduğu sayfanın zaman aşımına uğramasına izin vermektir (yaklaşık 18 dakika).
Bu Kılavuz Hakkında Daha Fazlasını Okuyun ve PDF'i İndirin:
Belgeler / Kaynaklar
 |
Yazılımlar 3D Güvenli Entegrasyon Kılavuzu [pdf] Belgeler Unzer, Entegrasyon Kılavuzu, 3D Secure |
