Dokumentasi Panduan Integrasi Selamat 3D perisian
Panduan Integrasi 3D Selamat
Mulai 01.01.2021, pengesahan dua faktor akan dilaksanakan sebagai syarat wajib untuk semua transaksi pembayaran kad e-dagang. Untuk memenuhi kewajiban ini, pihak
pengendali rangkaian kad kredit akan menggunakan prosedur 3D Secure yang disebut. Bagi anda sebagai pedagang, wajib melaksanakan prosedur ini untuk pelanggan anda dari
01.01.2021. Berikut ini anda akan mendapat penerangan mengenai pelbagai cara penyatuan dan bagaimana prosedur 3D Secure harus dilaksanakan untuknya.
Sila pilih kaedah penyatuan yang anda gunakan
- Adakah anda menggunakan borang pembayaran hCO?
- Adakah anda menggunakan borang pembayaran hPF?
- Adakah anda memproses pembayaran tanpa menggunakan borang yang disediakan oleh sistem Unzer?
Sila ambil perhatian: Ia juga penting dengan cara debit atau pra-kebenaran (tempahan) dibuat. Walaupun anda menggunakan borang pembayaran dari Unzer GmbH untuk pendaftaran data kad, proses 3D Secure akan dilakukan tanpa borang pembayaran ketika data kad pertama kali didebitkan atau dibenarkan. Dalam kes ini cara integrasi ketiga tanpa borang yang disediakan oleh Unzer berlaku.
Harap maklum juga:
Jika anda menggunakan pembayaran berulang (pembayaran langganan), pastikan untuk membaca bagian "Pembayaran 3D Selamat dan Berulang".
Prosedur Selamat 3D semasa menggunakan borang pembayaran hCO
Borang pembayaran hCO sudah dirancang untuk prosedur 3D Secure. Tidak ada tindakan tambahan dari pihak anda yang diperlukan untuk pelaksanaan prosedur. Walau bagaimanapun, anda
harus memastikan bahawa sistem anda dapat menangani jawapan yang sesuai dari sistem pembayaran kami sekiranya proses 3D Secure dimulakan. Dalam tindak balas tidak segerak dari
sistem pembayaran ke pelayan anda, hasil transaksi dihantar dan mesti dinilai di sana sebelum kembali URL dihantar ke sistem pembayaran.
Untuk tujuan ini parameter berikut mesti dinilai.
- PEMPROSESAN.RETURN.CODE = 000.200.000
- PEMPROSESAN.RETURN = Transaksi + belum selesai
- PEMPROSESAN.RESULT = TERIMA
Penjelasan: Status transaksi adalah "belum selesai", parameter PROCESSING.RESULT
hanya mewakili hasil awal. Selagi proses 3D Secure dijalankan, statusnya
masih belum selesai.
Hasil akhir transaksi adalah sama ada
- PEMPROSESAN.RETURN.CODE = 000.000.000
- PEMPROSESAN.RESULT = TERIMA
or - PROSES.RETURN.CODE = irgendein Wert ungleich 000.000.000 oder 000.200.000
- PEMPROSESAN.RESULT = NOK
Dalam kes pertama transaksi berjaya diselesaikan, dalam kes kedua gagal keseluruhan. Yang terakhir boleh mempunyai pelbagai alasan, termasuk penolakan untuk mengesahkan. Anda akan
terima maklumat yang lebih terperinci dalam parameter "PROCESSING.RETURN" dan "PROCESSING.RETURN.CODE".
Kami mengesyorkan agar anda menjalankan ujian untuk kedua-dua mesej tersebut. Untuk maklumat lebih lanjut mengenai cara melakukan ujian dan butiran kad kredit yang boleh anda gunakan untuk ujian, sila lihat di bawah.
Prosedur Selamat 3D semasa menggunakan borang pembayaran hPF
Borang pembayaran hPF juga dirancang untuk menggunakan prosedur 3DS. Tidak ada tindakan tambahan dari pihak anda yang diperlukan untuk pelaksanaan prosedur. Seperti yang dijelaskan
untuk pelaksanaan hCO, tindak balas dari sistem pembayaran berlaku dalam dua langkah, sebab itulah sistem anda mesti memeriksa nilai PEMPROSESAN.RETURN.CODE
parameter semasa memproses tindak balas.
Untuk tujuan ini parameter berikut mesti dinilai.
- PEMPROSESAN.RETURN.CODE = 000.200.000
- PEMPROSESAN.RETURN = Transaksi + belum selesai
- PEMPROSESAN.RESULT = TERIMA
Penjelasan: Status transaksi "menunggu keputusan", parameter PROCESSING.RESULT hanya menunjukkan hasil awal. Selagi proses 3D Secure dijalankan, statusnya
masih belum selesai.
Hasil akhir transaksi adalah sama ada
- PEMPROSESAN.RETURN.CODE = 000.000.000
- PEMPROSESAN.RESULT = TERIMA
or - PROSES.RETURN.CODE = irgendein Wert ungleich 000.000.000 oder 000.200.000
- PEMPROSESAN.RESULT = NOK
Dalam kes pertama transaksi berjaya diselesaikan, dalam kes kedua gagal keseluruhan. Yang terakhir boleh mempunyai pelbagai alasan, termasuk penolakan untuk mengesahkan. Anda akan
terima maklumat yang lebih terperinci dalam parameter "PROCESSING.RETURN" dan "PROCESSING.RETURN.CODE".
Kami mengesyorkan agar anda menjalankan ujian untuk kedua-dua mesej tersebut. Untuk maklumat lebih lanjut mengenai cara melakukan ujian dan butiran kad kredit yang boleh anda gunakan untuk ujian, sila lihat di bawah.
Prosedur Selamat 3D dengan sambungan langsung
Sekiranya anda tidak menggunakan borang pembayaran yang disediakan oleh Unzer (sebelumnya heidelpay) untuk memproses pembayaran kad kredit, atau jika anda hanya mendaftarkan kad menggunakan salah satu borang dan memproses pra-kebenaran (tempahan) atau debit sebagai rujukan kepada pendaftaran sebagai komunikasi langsung dengan sistem pembayaran, anda mesti melaksanakan proses 3D Secure.
Aliran transaksi tak segerak:
Ini adalah proses asinkron di mana pelayan anda menerima pemajuan URL (Ubah hala URL) dari sistem pembayaran kami. Pelayan anda mesti memajukan pelanggan untuk ini URL supaya dia dapat melakukan pengesahan melalui prosedur 3D Secure. Hasil pengesahan 3D Secure ini dilaporkan terus ke Unzer oleh bank penerbit kad.
Setelah pengesahan berjaya, transaksi diproses lebih lanjut dalam sistem Unzer dengan cara yang sudah anda ketahui dengan mengirimkan hasil keseluruhan sistem anda pada akhir, yang anda balas
dengan pengalihan URL. Sistem pembayaran kemudian akan mengarahkan pelanggan kembali ke sistem anda menggunakan pengalihan ini URL dari sistem anda
Harap maklum: Dalam aliran kerja ini sistem anda menerima dua jawapan dari sistem pembayaran:
- Satu dengan status "menunggu keputusan" (PROCESSING.RETURN.CODE = 000.200.000 dan PROCESSING.RETURN = Transaction + pending) dan parameter pengalihan ke bank penerbit kad pelanggan
- Satu dengan hasil akhir debit atau tempahan. Terdapat juga dua pengalihan URLdisebutkan dalam proses ini, salah satu dari sistem pembayaran yang pelanggan harus diarahkan untuk mengesahkan di bank penerbit kadnya dan satu dari sistem anda, ketika menerima hasil akhir, untuk mengarahkan pelanggan kembali ke sistem anda.
Perubahan berikut akan dilakukan pada prosedur biasa. Harap maklum bahawa kerana pelaksanaan kaedah pembayaran asinkron lain, seperti Paypal, beberapa di antaranya
proses mungkin sudah ada dalam pelaksanaan anda.
- Respon URL
Dalam panggilan pertama (no.2 dalam rajah) ke sistem pembayaran, "Respons" URL"Mesti lulus dalam kumpulan frontend.
Sila ambil perhatian: Parameter IDENTIFICATION.REFERENCEID hanya relevan jika anda merujuk kepada pendaftaran atau transaksi lain yang sudah ada - Pengalihan Pemprosesan URL Sekiranya pengesahan diperlukan, ubah hala URL dan parameter lain dalam kumpulan pengalihan dipindahkan sebagai tindak balas dari sistem pembayaran (No. 5 dalam rajah).
- Memajukan pelanggan ke pengalihan semula URL
Sekiranya kumpulan pengalihan bertindak balas dengan pengalihan URL, penyemak imbas pelanggan mesti dialihkan ke ini URL (No. 6 dalam rajah) untuk melakukan pengesahan. Parameter tambahan dari kumpulan pengalihan harus dipindahkan ke luaran weblaman web sebagai parameter POST.
Harap diperhatikan: Parameter tambahan dikembalikan dalam kumpulan "PROCESSING.REDIRECT.xxx" hanya dengan 3D Secure Version 1 (walaupun jumlah dan penamaannya mungkin berbeza-beza), sedangkan dengan Versi 3D 2 hanya PROSES.URL seperti yang dipaparkan di bawah dikembalikan: https://heidelpay.hpcgw.net/AuthService/v1/auth/public/2258_2863FFA4C5241C12E39F37
CCF / run Ini bermaksud bahawa tanpa mengira jenis dan bilangan parameter, penyemak imbas pelanggan mesti mengarahkan semula ke PEMPROSESAN.REDIRECT.URL.
Di bawah ini anda akan dapati kod ringkasampbagaimana pengalihan seperti itu dapat dilaksanakan. The bahagian bertujuan untuk memberitahu pelanggan akhir yang sistemnya tidak menyokong Javascript atau telah dilumpuhkan. Kami sangat mengesyorkan agar pengalihan dilakukan dalam tetingkap penyemak imbas aktif pelanggan dan tidak menggunakan tetingkap pop timbul atau tetingkap penyemak imbas baru, kerana ini mungkin
mengganggu pelanggan dan memimpin mereka untuk menutup halaman tempat mereka diarahkan.
- Pemeriksaan hasil tak segerak
Hasil pengesahan dihantar secara serentak ke pelayan anda. Sistem pembayaran mengharapkan berlaku URL sebagai tindak balas. (No. 12 & 13 dalam rajah). Untuk berjaya atau ditolak
pembayaran, berbeza URL boleh disahut di sini oleh sistem anda. - Jalan kembali pelanggan
Sistem pembayaran mengarahkan pelanggan ke URL disediakan oleh sistem pedagang setelah proses pengesahan dan transaksi pembayaran selesai.
Harap maklum: Langkah 4.) dan 5.) teruskan dengan cara yang sama seperti yang sudah anda ketahui dalam transaksi TANPA 3D Selamat yang ada.
Pembayaran 3D Selamat dan Berulang
Mulai 1 Januari 2021, 3D Secure akan diwajibkan untuk semua transaksi kad e-dagang. Namun, kerana ini hampir tidak berlaku untuk pembayaran berulang, perbankan
sistem mempunyai aliran kerja yang berasingan untuk ini.
Untuk tujuan ini, bank membezakan antara
- CIT = transaksi yang dimulakan oleh pelanggan
- MIT = transaksi yang dimulakan peniaga
Transaksi pertama kad di akaun pedagang anda mesti disahkan dengan 3D Secure mulai 01.01.2021 dan seterusnya. Pengesahan yang berjaya adalah syarat wajib di
agar dapat menghantar tempahan selanjutnya pada kad yang sama tanpa 3D Secure. Oleh itu, pelanggan mesti dihantar ke bank penerbit kadnya untuk debit pertama di
mengikut prosedur yang dinyatakan di atas dan mengesahkan dirinya di sana sebagai pemegang kad. Sekiranya debit tidak dirancang pada masa pesanan, untuk exampOleh kerana tempoh percubaan, tempahan (pra-kebenaran) sekurang-kurangnya satu euro mesti dibuat dengan 3D Secure di hadapan pelanggan sebagai gantinya. Pengambilan tempahan ini tidak diperlukan.
Namun, untuk pelanggan yang ada, tidak perlu dibuat pengesahan 3D Secure. Sekiranya debit pertama berjaya dilakukan sebelum 01.01.2021, rekod pelanggan juga boleh dianggap
telah berjaya disahkan. Untuk pelanggan baru pada 01.01.2021, sebaliknya, pengesahan 3D Secure adalah wajib untuk debit atau tempahan pertama (pra-kebenaran).
Harap perhatikan: Dalam hal ini, sistem perbankan melihat data kad, bukan data pelanggan. Jadi jika pelanggan yang ada menggunakan kad baru selepas 01.01.2021, untuk bekasample kerana sebelumnya
seseorang telah tamat tempoh atau kerana dia telah menukar bank penerbit kadnya, ini adalah kitaran berulang baru dari sudut bank view dan mesti disahkan dengan 3D Secure untuk tempahan pertama.
Setelah pengesahan awal ini berjaya dilakukan, semua transaksi selanjutnya dikecualikan dari kewajiban untuk menggunakan 3D Secure Prasyarat untuk pembayaran berulang tanpa 3D Secure adalah:
- Terdapat sekurang-kurangnya satu debit atau tempahan yang berjaya (pra-kebenaran) yang dilakukan dengan 3D Secure atau berlaku sebelum 01.01.2021.
- ia dirujuk ke pendaftaran dan debit yang ada semasa penyerahan
Untuk memberitahu sistem pembayaran, bahawa ini adalah pembayaran berulang, parameter RECURRENCE.MODE = REPEATED juga harus dihantar. Ini memberi isyarat kepada sistem bahawa a
pembayaran berulang harus dilaporkan kepada sistem perbankan.
Harap diperhatikan: Jika parameter RECURRENCE.MODE = DIPEROLEHI dimasukkan ketika kad baru dimuat untuk pertama kalinya, penerusan 3D Secure akan dilakukan walaupun parameter ini.
Menguji pelaksanaan 3D Secure
Anda boleh menguji sambungan 3D Secure kapan saja melalui sistem pembayaran kami. Untuk melakukannya, gunakan mod "CONNECTOR_TEST" untuk transaksi, seperti yang ditunjukkan dalam contohamples di atas.
Data sambungan untuk ujian ini:
| KESELAMATAN.SENDER | 31HA07BC8142C5A171745D00AD63D182 |
| LOG MASUK PENGGUNA | 31ha07bc8142c5a171744e5aef11ffd3 |
| PENGGUNA.PWD | 93167DE7 |
| TRANSAKSI.SALURAN | 31HA07BC8142C5A171749A60D979B6E4 |
| Mata wang dikonfigurasikan untuk Versi 3D 2 | EUR, USD, SEK |
| Mata wang dikonfigurasikan untuk Versi 3D 1 | GBP, CZK, CHF |
Titik akhir pintu masuk sistem adalah sama ada
Gerbang SGW:
- https://test-heidelpay.hpcgw.net/sgw/gtw - Latin-15 dikodkan
- https://test-heidelpay.hpcgw.net/sgw/gtwu - Dikodkan UTF-8
Gerbang NGW:
- https://test-heidelpay.hpcgw.net/ngw/post
Data kad kredit untuk ujian ini:
| jenama | nombor kad | CVV | tarikh luput | nota |
| MasterCard | 5453010000059543 | 123 | tarikh masa depan | 3D - kata laluan: rahsia3 |
| Visa | 4711100000000000 | 123 | tarikh masa depan | 3DS - kata laluan: rahsia! 33 |
Harap maklum: Untuk 3D Secure Version 2, anda tidak perlu memasukkan kata laluan, tetapi cukup klik pada pautan ”Klik di sini untuk menyelesaikan pengesahan.
Satu-satunya cara untuk mensimulasikan ralat dengan 3D Secure Version 2 adalah membiarkan halaman dengan pautan habis (kira-kira 18 minit).
Baca Lebih Lanjut Mengenai Manual Ini & Muat Turun PDF:
Dokumen / Sumber
 |
Panduan Integrasi Selamat 3D Perisian [pdf] Dokumentasi Unzer, Panduan Integrasi, 3D Selamat |
