Dokumentasi Panduan Integrasi Aman 3D Softwares
Panduan Integrasi 3D Aman
Mulai 01.01.2021 pada otentikasi dua faktor akan diimplementasikan sebagai persyaratan wajib untuk semua transaksi pembayaran kartu e-niaga. Untuk memenuhi kewajiban ini,
Operator jaringan kartu kredit akan menggunakan apa yang disebut prosedur 3D Secure. Bagi Anda sebagai pedagang, prosedur ini wajib dapat dilakukan untuk pelanggan Anda dari
01.01.2021. Berikut ini Anda akan menemukan penjelasan tentang berbagai cara integrasi dan bagaimana prosedur 3D Secure harus diterapkan untuk mereka.
Pilih metode integrasi yang Anda gunakan
- Apakah Anda menggunakan formulir pembayaran hCO?
- Apakah Anda menggunakan formulir pembayaran hPF?
- Apakah Anda memproses pembayaran tanpa menggunakan formulir yang disediakan oleh sistem Unzer?
Harap diperhatikan: Hal ini juga penting dalam cara pendebetan atau pra-otorisasi (reservasi) dilakukan. Meskipun Anda menggunakan formulir pembayaran dari Unzer GmbH untuk pendaftaran data kartu, proses 3D Secure akan dilakukan tanpa formulir pembayaran saat data kartu pertama kali didebit atau diotorisasi untuk pertama kalinya. Dalam hal ini, cara integrasi ketiga tanpa formulir yang disediakan oleh Unzer berlaku.
Harap diperhatikan juga:
Jika Anda menggunakan pembayaran berulang (pembayaran langganan), pastikan untuk membaca bagian "3D Secure dan Pembayaran Berulang".
Prosedur 3D Secure saat menggunakan formulir pembayaran hCO
Formulir pembayaran hCO sudah dirancang untuk prosedur 3D Secure. Tidak ada tindakan tambahan dari pihak Anda yang diperlukan untuk penerapan prosedur ini. Namun, kamu
harus memastikan bahwa sistem Anda dapat menangani jawaban yang sesuai dari sistem pembayaran kami jika proses 3D Secure dimulai. Dalam respons asinkron dari
sistem pembayaran ke server Anda, hasil transaksi dikirim dan harus dievaluasi di sana sebelum dikembalikan URL dikirim ke sistem pembayaran.
Untuk tujuan ini, parameter berikut harus dievaluasi.
- PENGOLAHAN.RETURN.CODE = 000.200.000
- PROCESSING.RETURN = Transaksi + tertunda
- PENGOLAHAN.HASIL = ACK
Penjelasan: Status transaksi adalah “pending”, parameter PROCESSING.RESULT
hanya mewakili hasil awal. Selama proses 3D Secure dilakukan, statusnya
tetap menunggu.
Hasil akhir dari transaksi tersebut adalah salah satunya
- PENGOLAHAN.RETURN.CODE = 000.000.000
- PENGOLAHAN.HASIL = ACK
or - PROCESSING.RETURN.CODE = irgendein Wert ungleich 000.000.000 atau 000.200.000
- PENGOLAHAN.HASIL = NOK
Dalam kasus pertama, transaksi telah berhasil diselesaikan, dalam kasus kedua transaksi gagal secara keseluruhan. Yang terakhir dapat memiliki berbagai alasan, termasuk penolakan untuk mengotentikasi. Kamu akan
menerima informasi lebih rinci dalam parameter "PROCESSING.RETURN" dan "PROCESSING.RETURN.CODE".
Kami menyarankan Anda menjalankan pengujian untuk kedua pesan tersebut. Untuk informasi lebih lanjut tentang cara melakukan tes dan detail kartu kredit mana yang dapat Anda gunakan untuk tes, silakan lihat di bawah.
Prosedur 3D Secure saat menggunakan formulir pembayaran hPF
Formulir pembayaran hPF juga dirancang untuk menggunakan prosedur 3DS. Tidak ada tindakan tambahan dari pihak Anda yang diperlukan untuk penerapan prosedur ini. Seperti yang dijelaskan
untuk implementasi hCO respon dari sistem pembayaran berlangsung dalam dua langkah, oleh karena itu sistem anda harus memeriksa nilai PROCESSING.RETURN.CODE
parameter saat memproses respons.
Untuk tujuan ini, parameter berikut harus dievaluasi.
- PENGOLAHAN.RETURN.CODE = 000.200.000
- PROCESSING.RETURN = Transaksi + tertunda
- PENGOLAHAN.HASIL = ACK
Penjelasan: Status transaksi adalah “pending”, parameter PROCESSING.RESULT hanya merupakan hasil awal. Selama proses 3D Secure dilakukan, statusnya
tetap menunggu.
Hasil akhir dari transaksi tersebut adalah salah satunya
- PENGOLAHAN.RETURN.CODE = 000.000.000
- PENGOLAHAN.HASIL = ACK
or - PROCESSING.RETURN.CODE = irgendein Wert ungleich 000.000.000 atau 000.200.000
- PENGOLAHAN.HASIL = NOK
Dalam kasus pertama, transaksi telah berhasil diselesaikan, dalam kasus kedua transaksi gagal secara keseluruhan. Yang terakhir dapat memiliki berbagai alasan, termasuk penolakan untuk mengotentikasi. Kamu akan
menerima informasi lebih rinci dalam parameter "PROCESSING.RETURN" dan "PROCESSING.RETURN.CODE".
Kami menyarankan Anda menjalankan pengujian untuk kedua pesan tersebut. Untuk informasi lebih lanjut tentang cara melakukan tes dan detail kartu kredit mana yang dapat Anda gunakan untuk tes, silakan lihat di bawah.
Prosedur 3D Secure dengan koneksi langsung
Jika Anda tidak menggunakan formulir pembayaran yang disediakan oleh Unzer (sebelumnya heidelpay) untuk memproses pembayaran kartu kredit, atau jika Anda hanya mendaftarkan kartu menggunakan salah satu formulir dan memproses pra-otorisasi (reservasi) atau debit sebagai referensi untuk pendaftaran sebagai a komunikasi langsung dengan sistem pembayaran, Anda harus menerapkan proses 3D Secure.
Alur transaksi asinkron:
Ini adalah proses asinkron di mana server Anda menerima penerusan URL (Alihkan URL) dari sistem pembayaran kami. Server Anda harus meneruskan pelanggan ke ini URL sehingga dia dapat melakukan otentikasi melalui prosedur 3D Secure. Hasil otentikasi 3D Secure ini dilaporkan langsung ke Unzer oleh bank penerbit kartu.
Setelah otentikasi berhasil, transaksi diproses lebih lanjut dalam sistem Unzer dengan cara yang sudah Anda ketahui dengan mengirimkan sistem Anda hasil keseluruhan di bagian 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 diperhatikan: Dalam alur kerja ini sistem Anda menerima dua jawaban dari sistem pembayaran:
- Satu dengan status "tertunda" (PROCESSING.RETURN.CODE = 000.200.000 dan PROCESSING.RETURN = Transaksi + tertunda) dan parameter pengalihan ke bank penerbit kartu dari pelanggan
- Satu dengan hasil akhir dari debit atau reservasi. Ada juga dua pengalihan URLSeperti yang disebutkan dalam proses ini, satu dari sistem pembayaran di mana pelanggan harus diarahkan untuk mengautentikasi di bank penerbit kartunya dan dari sistem Anda, saat menerima hasil akhir, untuk mengarahkan pelanggan kembali ke sistem Anda.
Perubahan berikut akan dilakukan pada prosedur biasa. Harap dicatat bahwa karena penerapan metode pembayaran asinkron lainnya, seperti Paypal, beberapa di antaranya
proses mungkin sudah ada dalam implementasi Anda.
- Tanggapan URL
Dalam panggilan pertama (no.2 dalam diagram) ke sistem pembayaran, muncul “Respon URL”Harus diteruskan di grup frontend.
Harap diperhatikan: Parameter IDENTIFICATION.REFERENCEID hanya relevan jika Anda mengacu pada registrasi atau transaksi lain yang sudah ada - Memproses Pengalihan URL Jika otentikasi diperlukan, pengalihan URL dan parameter lain dalam grup pengalihan ditransfer sebagai respons dari sistem pembayaran (No. 5 dalam diagram).
- Meneruskan pelanggan ke pengalihan URL
Jika grup pengalihan merespons dengan pengalihan URL, browser pelanggan harus dialihkan ke ini URL (No. 6 dalam diagram) untuk melakukan otentikasi. Parameter tambahan dari grup redirect harus ditransfer ke eksternal websitus sebagai parameter POST.
Harap diperhatikan: Parameter tambahan dikembalikan dalam grup “PROCESSING.REDIRECT.xxx” hanya dengan 3D Secure Versi 1 (bahkan di sana nomor dan penamaannya dapat bervariasi), sedangkan dengan 3D Versi 2 hanya sebuah PROCESSING.REDIRECT.URL seperti yang ditampilkan di bawah ini dikembalikan: https://heidelpay.hpcgw.net/AuthService/v1/auth/public/2258_2863FFA4C5241C12E39F37
CCF / run Ini berarti bahwa terlepas dari jenis dan jumlah parameter, browser klien harus mengarahkan ke PROCESSING.REDIRECT.URL.
Di bawah ini Anda akan menemukan kode sederhana example tentang bagaimana pengalihan tersebut dapat dijalankan. NS bagian ini dimaksudkan untuk memberi tahu pelanggan akhir yang sistemnya tidak mendukung Javascript atau menonaktifkannya. Kami sangat menyarankan agar pengalihan dilakukan dalam jendela browser aktif pelanggan dan tidak menggunakan jendela pop-up atau jendela browser baru, karena hal ini dapat
mengganggu pelanggan dan mengarahkan mereka untuk menutup halaman tempat mereka diarahkan.
- Pemeriksaan hasil asinkron
Hasil otentikasi dikirim secara asinkron ke server Anda. Sistem pembayaran mengharapkan valid URL sebagai tanggapan. (No. 12 & 13 dalam diagram). Untuk berhasil atau ditolak
pembayaran, berbeda URL dapat ditanggapi di sini oleh sistem Anda. - Jalur pengembalian pelanggan
Sistem pembayaran mengalihkan pelanggan ke URL disediakan oleh sistem merchant setelah proses otentikasi dan transaksi pembayaran selesai.
Harap diperhatikan: Langkah 4.) dan 5.) lanjutkan dengan cara yang persis sama seperti yang Anda ketahui dalam transaksi NONE 3D Secure yang ada.
Pembayaran 3D Aman dan Berulang
Mulai 1 Januari 2021, 3D Secure akan menjadi wajib untuk semua transaksi kartu e-commerce. Namun, karena ini hampir tidak berlaku untuk pembayaran berulang, perbankan
sistem memiliki alur kerja terpisah untuk ini.
Untuk tujuan ini, bank membedakan antara
- CIT = transaksi yang dimulai oleh pelanggan
- MIT = pedagang memulai transaksi
Transaksi pertama kartu di akun pedagang Anda harus diautentikasi dengan 3D Secure mulai 01.01.2021 dan seterusnya. Otentikasi yang berhasil adalah persyaratan wajib di
agar dapat mengirimkan pemesanan selanjutnya dengan kartu yang sama tanpa 3D Secure. Oleh karena itu, pelanggan harus diteruskan ke bank penerbit kartunya untuk debit pertama masuk
sesuai dengan prosedur yang dijelaskan di atas dan mengotentikasi dirinya di sana sebagai pemegang kartu. Jika debit tidak direncanakan pada saat pemesanan, misalnyaample karena masa percobaan, reservasi (pra-otorisasi) minimal satu euro harus dilakukan dengan 3D Secure di hadapan pelanggan. Pengambilan reservasi ini tidak diperlukan.
Untuk pelanggan yang sudah ada, bagaimanapun, tidak ada otentikasi 3D Secure yang perlu dibuat. Jika debit sukses pertama terjadi sebelum 01.01.2021, catatan pelanggan juga dapat diasumsikan
telah berhasil diautentikasi. Sebaliknya, untuk pelanggan baru pada 01.01.2021, otentikasi 3D Secure wajib untuk debit atau reservasi pertama (pra-otorisasi).
Harap diperhatikan: Dalam hal ini, sistem perbankan melihat data kartu, bukan data nasabah. Jadi jika pelanggan lama menggunakan kartu baru setelah 01.01.2021, misalnyaample karena sebelumnya
seseorang telah kedaluwarsa atau karena dia telah mengubah bank penerbit kartunya, ini adalah siklus berulang baru dari sudut pandang bank view dan harus diautentikasi dengan 3D Secure untuk pemesanan pertama.
Setelah otentikasi awal ini berhasil dilakukan, semua transaksi selanjutnya dibebaskan dari kewajiban menggunakan 3D Secure. Oleh karena itu, prasyarat untuk pembayaran berulang tanpa 3D Secure adalah:
- Setidaknya ada satu debit atau reservasi yang berhasil (pra-otorisasi) yang dilakukan dengan 3D Secure atau terjadi sebelum 01.01.2021.
- itu dirujuk ke pendaftaran dan debit yang ada pada saat pengajuan
Untuk memberi tahu sistem pembayaran bahwa ini adalah pembayaran berulang, parameter RECURRENCE.MODE = REPEATED juga harus dikirim. Ini memberi sinyal kepada sistem bahwa a
pembayaran berulang harus dilaporkan ke sistem perbankan.
Harap diperhatikan: Jika parameter RECURRENCE.MODE = REPEATED dimasukkan saat kartu baru dimuat untuk pertama kalinya, penerusan 3D Secure akan dijalankan meskipun ada parameter ini.
Menguji implementasi 3D Secure
Anda dapat menguji koneksi 3D Secure kapan saja melalui sistem pembayaran kami. Untuk melakukannya, gunakan mode “CONNECTOR_TEST” untuk transaksi, seperti yang ditunjukkan pada contohamples di atas.
Data koneksi untuk tes ini:
| KEAMANAN.SENDER | 31HA07BC8142C5A171745D00AD63D182 |
| PENGGUNA.LOGIN | 31ha07bc8142c5a171744e5aef11ffd3 |
| PENGGUNA.PWD | Nomor 93167DE7 |
| TRANSAKSI.SALURAN | 31HA07BC8142C5A171749A60D979B6E4 |
| Mata uang dikonfigurasi untuk 3D Versi 2 | EUR, USD, SEK |
| Mata uang dikonfigurasi untuk 3D Versi 1 | GBP, CZK, CHF |
Titik akhir gateway sistem juga
Gateway SGW:
- https://test-heidelpay.hpcgw.net/sgw/gtw - dienkode Latin-15
- https://test-heidelpay.hpcgw.net/sgw/gtwu - dikodekan UTF-8
Gerbang NGW:
- https://test-heidelpay.hpcgw.net/ngw/post
Data kartu kredit untuk tes ini:
| Merek | nomor kartu | CVV | tanggal kadaluarsa | catatan |
| MasterCard | 5453010000059543 | 123 | tanggal yang akan datang | 3D - kata sandi: rahasia3 |
| Visa | 4711100000000000 | 123 | tanggal yang akan datang | 3DS - kata sandi: rahasia! 33 |
Harap diperhatikan: Untuk 3D Secure Versi 2, Anda tidak perlu memasukkan kata sandi, tetapi cukup klik pada link ”Klik di sini untuk menyelesaikan otentikasi.
Satu-satunya cara untuk mensimulasikan kesalahan dengan 3D Secure Versi 2 adalah membiarkan halaman dengan waktu tautan habis (sekitar 18 menit).
Baca Selengkapnya Tentang Manual Ini & Unduh PDF:
Dokumen / Sumber Daya
 |
Panduan Integrasi Aman 3D Perangkat Lunak [Bahasa Indonesia:] Dokumentasi Unzer, Panduan Integrasi, 3D Aman |
