Dokumentasi Pandhuan Integrasi Aman 3D Softwares
Pandhuan Integrasi 3D Aman
Saka 01.01.2021 babagan otentikasi rong faktor bakal dileksanakake minangka syarat wajib kanggo kabeh transaksi pembayaran kertu ecommerce. Kanggo netepi kewajiban iki,
operator jaringan kertu kredit bakal nggunakake prosedur 3D Secure sing diarani. Kanggo sampeyan minangka sudagar, wajib nindakake prosedur iki kanggo para pelanggan
01.01.2021. Ing ngisor iki sampeyan bakal nemokake katrangan babagan cara integrasi lan cara prosedur 3D Secure sing kudu diterapake.
Pilih cara integrasi sing digunakake
- Apa sampeyan nggunakake formulir checkout hCO?
- Apa sampeyan nggunakake formulir checkout hPF?
- Apa sampeyan ngolah pembayaran tanpa nggunakake formulir sing diwenehake dening sistem Unzer?
Wigati dimangerteni: Sampeyan uga penting nalika nggawe debit utawa preauthorisations (reservasi). Sanajan sampeyan nggunakake formulir pambayaran saka Unzer GmbH kanggo registrasi data kertu, proses 3D Secure bakal dileksanakake tanpa formulir checkout nalika data kertu pisanan didhisiki utawa diwenehi idin. Ing kasus iki, cara integrasi katelu tanpa formulir sing diwenehake dening Unzer.
Elinga uga:
Yen sampeyan nggunakake pambayaran maneh (pembayaran langganan), priksa manawa maca bagean "Pembayaran 3D Aman lan Ambalan".
Prosedur 3D Aman nalika nggunakake formulir checkout hCO
Formulir checkout hCO wis dirancang kanggo prosedur 3D Secure. Ora ana tindakan tambahan saka sisih sampeyan sing dibutuhake kanggo ngetrapake prosedur kasebut. Nanging, sampeyan
kudu priksa manawa sistem sampeyan bisa ngatasi jawaban sing cocog karo sistem pembayaran yen proses 3D Secure diwiwiti. Ing respon bedo saka
sistem pembayaran menyang server sampeyan, asil transaksi ditularake lan kudu dievaluasi sadurunge bali URL ditularake menyang sistem pembayaran.
Kanggo tujuan kasebut, parameter ing ngisor iki kudu dievaluasi.
- PAMrosesan.KEMBALI.KODE = 000.200.000
- PROSESING.KEMBALI = Transaksi + ditunda
- PROSESING.RESULT = ACK
Katrangan: Status transaksi "ditundha", parameter PROCESSING.RESULT
mung nuduhake asil pambuka. Sajrone proses Aman 3D ditindakake, status kasebut
tetep ditundha.
Asil pungkasan transaksi yaiku salah siji
- PAMrosesan.KEMBALI.KODE = 000.000.000
- PROSESING.RESULT = ACK
or - PEMrosesan.KEMBALI.CODE = irgendein Wert ungleich 000.000.000 oder 000.200.000
- PROSESING.RESULT = NOK
Ing prekara pisanan, transaksi wis sukses rampung, ing kasus liyane, gagal ing sakabehe. Sing terakhir bisa duwe macem-macem sebab, kalebu nolak kanggo otentikasi. Sampeyan bakal
nampa informasi sing luwih rinci babagan paramèter "PROSESING. PULIH" lan "PROSESING.RETURN.CODE".
Disaranake sampeyan mbukak tes kanggo loro pesen. Kanggo informasi luwih lengkap babagan cara nggawe tes lan rincian kertu kredit sing bisa digunakake kanggo tes, waca ing ngisor iki.
Prosedur 3D Aman nalika nggunakake formulir checkout hPF
Formulir checkout hPF uga dirancang kanggo nggunakake prosedur 3DS. Ora ana tindakan tambahan saka sisih sampeyan sing dibutuhake kanggo ngetrapake prosedur kasebut. Kaya sing diandharake
kanggo implementasi hCO, respons saka sistem pembayaran ditindakake kanthi rong langkah, mula sistem sampeyan kudu mriksa regane PROSESING.
parameter nalika ngolah respons.
Kanggo tujuan kasebut, parameter ing ngisor iki kudu dievaluasi.
- PAMrosesan.KEMBALI.KODE = 000.200.000
- PROSESING.KEMBALI = Transaksi + ditunda
- PROSESING.RESULT = ACK
Katrangan: Status transaksi "ditundha", parameter PROSESING. RESES mung nuduhake asil pambuka. Sajrone proses Aman 3D ditindakake, status kasebut
tetep ditundha.
Asil pungkasan transaksi yaiku salah siji
- PAMrosesan.KEMBALI.KODE = 000.000.000
- PROSESING.RESULT = ACK
or - PEMrosesan.KEMBALI.CODE = irgendein Wert ungleich 000.000.000 oder 000.200.000
- PROSESING.RESULT = NOK
Ing prekara pisanan, transaksi wis sukses rampung, ing kasus liyane, gagal ing sakabehe. Sing terakhir bisa duwe macem-macem sebab, kalebu nolak kanggo otentikasi. Sampeyan bakal
nampa informasi sing luwih rinci babagan paramèter "PROSESING. PULIH" lan "PROSESING.RETURN.CODE".
Disaranake sampeyan mbukak tes kanggo loro pesen. Kanggo informasi luwih lengkap babagan cara nggawe tes lan rincian kertu kredit sing bisa digunakake kanggo tes, waca ing ngisor iki.
Prosedur 3D Aman kanthi sambungan langsung
Yen sampeyan ora nggunakake formulir pambayaran sing diwenehake dening Unzer (sadurunge heidelpay) kanggo ngolah pembayaran kertu kredit, utawa yen sampeyan mung ndhaptar kertu nggunakake salah sawijining formulir lan ngolah preauthorisation (reservasi) utawa debit minangka referensi kanggo registrasi minangka komunikasi langsung karo sistem pembayaran, sampeyan kudu ngetrapake proses 3D Secure.
Alur transaksi sing ora sinkron:
Iki minangka proses asinkronisasi nalika server sampeyan nampa penerusan URL (Pangalihan pangalihan URL) saka sistem pembayaran. Server sampeyan kudu nerusake pelanggan babagan iki URL saengga dheweke bisa nindakake otentikasi liwat prosedur 3D Secure. Asil otentikasi 3D Secure iki dilaporake langsung menyang Unzer dening bank sing ngetokake kertu.
Sawise otentikasi sing sukses, transaksi kasebut luwih diproses ing sistem Unzer kaya sing wis sampeyan ngerteni kanthi ngirim sistem asil umum ing pungkasan, sing sampeyan wangsuli
kanthi pangalihan URL. Sistem pembayaran banjur bakal ngarahake pelanggan bali menyang sistem sampeyan nggunakake pangalihan iki URL saka sistem sampeyan
Elinga: Ing alur kerja iki, sistem sampeyan nampa rong jawaban saka sistem pembayaran:
- Siji sing status "ditundha" (PROSESING.RETURN.CODE = 000.200.000 lan PROSESING. PULIH = Transaksi + ditundha) lan paramèter pangalihan menyang bank sing nerbitake kertu saka pelanggan
- Siji kanthi asil pungkasan saka debit utawa reservasi. Uga ana rong pangalihan URLsing kasebut ing proses iki, salah siji saka sistem pembayaran sing kudu dialihake pelanggan kanggo otentikasi ing bank sing ngetokake kertu saka sistem sampeyan, nalika nampa asil pungkasan, kanggo ngarahake pelanggan bali menyang sistem sampeyan.
Pangowahan ing ngisor iki bakal digawe kanggo prosedur biasa. Elinga yen amarga ngetrapake cara pembayaran bedo liyane, kayata Paypal, sawetara cara kasebut
proses bisa uga wis ana ing implementasine.
- wangsulan URL
Ing telpon pisanan (no.2 ing diagram) menyang sistem pembayaran, "Response URL”Kudu diliwati ing grup ngarep.
Wigati dimangerteni: Parameter IDENTIFICATION.REFERENSI mung cocog yen sampeyan nuduhake registrasi utawa transaksi liyane sing wis ana - Pangalihan Pangolahan URL Yen dibutuhake bukti asli, pangalihan URL lan paramèter liyane ing klompok pangalihan ditransfer minangka respons saka sistem pembayaran (No. 5 ing diagram).
- Nerusake pelanggan menyang pangalihan URL
Yen grup pangalihan nanggepi pangalihan URL, browser pelanggan kudu dialihake menyang iki URL (No. 6 ing diagram) kanggo nindakake otentikasi. Parameter tambahan saka klompok pangalihan kudu ditransfer menyang njaba websitus minangka paramèter POST.
Elinga: Parameter tambahan dikembalikan ing grup "PROCESSING.REDIRECT.xxx" kanthi 3D Secure Versi 1 (sanajan ana nomer lan jeneng bisa beda-beda), dene kanthi Versi 3D 2 mung PROSESING. REDIRECT.URL kaya sing ditampilake ing ngisor iki dibalekake: https://heidelpay.hpcgw.net/AuthService/v1/auth/public/2258_2863FFA4C5241C12E39F37
CCF / run Iki tegese preduli saka jinis lan nomer paramèter, browser klien kudu pangalihan menyang PROSESING.REDIRECT.URL.
Ing ngisor iki sampeyan bakal nemokake kode ex sing gampangample kepiye pangalihan kasebut bisa ditindakake. Ing bagean iki dimaksudaké kanggo ngandhani pelanggan pungkasan sing sistem ora ndhukung Javascript utawa dipateni. Disaranake banget pangalihan kasebut rampung ing jendela browser aktif pelanggan lan ora nggunakake windows pop up utawa windows browser anyar, amarga bisa
ngganggu pelanggan lan nuntun dheweke nutup kaca sing diarahake.
- Priksa asil sing ora sinkron
Asil otentikasi dikirim kanthi sinkron menyang server sampeyan. Sistem pembayaran ngarepake valid URL minangka tanggepan. (No. 12 & 13 ing diagram). Kanggo sukses utawa ditolak
pembayaran, beda URL bisa direspon ing kene dening sistem sampeyan. - Jalur bali saka pelanggan
Sistem pembayaran pangalihan pelanggan menyang URL diwenehake dening sistem pedagang sawise proses otentikasi lan transaksi pembayaran wis rampung.
Elinga: Langkah 4.) lan 5.) nerusake kanthi persis padha karo sing wis sampeyan kenal ing transaksi NONE 3D Secure sing wis ana.
Pembayaran 3D Aman lan Ambalan
Wiwit tanggal 1 Januari 2021, 3D Secure bakal dadi wajib kanggo kabeh transaksi kertu e-commerce. Nanging, amarga iki meh ora ditrapake kanggo pembayaran sing bola-bali, perbankan
sistem duwe alur kerja kapisah kanggo iki.
Kanggo tujuan kasebut, bank mbedakake antarane
- CIT = transaksi inisialisasi pelanggan
- MIT = transaksi inisialisasi saudagar
Transaksi kertu pisanan ing akun merchant sampeyan kudu diotentikasi karo 3D Secure wiwit 01.01.2021 lan liya-liyane. Otentikasi sing sukses kaya ngono iku sarat wajib ing
supaya bisa ngirim pesenan luwih lanjut ing kertu sing padha tanpa 3D Secure. Dadi, pelanggan kudu diterusake menyang bank sing ngetokake kertu kanggo debit pertama ing
sesuai karo prosedur sing wis diandharake ing ndhuwur lan otentikasi dhewe ing kana minangka sing duwe kertu. Yen debit ora direncanakake nalika pesenan, kanggo mantanampamarga wektu uji coba, reservasi (pre-authorization) paling ora siji euro kudu digawe karo 3D Secure yen ana pelanggan. Entuk reservasi iki ora prelu.
Nanging, kanggo pelanggan sing ana, ora ana otentikasi 3D Secure sing kudu digawe. Yen debit sukses sing pertama kedadeyan sadurunge 01.01.2021, cathetan pelanggan uga bisa dianggep
wis dikonfirmasi kanthi sukses. Kanggo pelanggan anyar tanggal 01.01.2021, ing tangan liyane, otentikasi 3D Secure wajib kanggo debit utawa reservasi kaping pisanan (pre-authorization).
Elinga: Ing babagan iki, sistem perbankan ndeleng data kertu, dudu data pelanggan. Dadi, yen ana pelanggan nggunakake kertu anyar sawise 01.01.2021, kanggo mantanample amarga sadurunge
ana sing wis kadaluwarsa utawa amarga wis ngganti bank sing ngetokake kertu, iki minangka siklus ambalan anyar saka titik view lan kudu dikonfirmasi karo 3D Secure kanggo pesenan pisanan.
Sawise otentikasi awal iki wis sukses ditindakake, kabeh transaksi luwih lanjut dibebasake saka kewajiban nggunakake 3D Secure Prasyarat kanggo pembayaran bola-bali tanpa 3D Secure, mula:
- Paling ora ana siji debit utawa reservasi sing wis sukses (pre-authorization) sing ditindakake kanthi 3D Secure utawa kedadeyan sadurunge 01.01.2021.
- dirujuk menyang registrasi lan debit sing ana nalika dikirim
Supaya sistem pembayaran ngerti, iki minangka pembayaran sing bola-bali, parameter REKRRENSI. MODE = REPEATED uga kudu dikirim. Iki menehi sinyal menyang sistem sing a
pembayaran sing bola-bali bakal dilaporake menyang sistem perbankan.
Elinga: Yen parameter REKRENSI.MODE = REPEATED dilebokake nalika kertu anyar dimuat kaping pisanan, Terusake 3D Secure bakal ditindakake sanajan parameter kasebut.
Nyoba implementasine 3D Secure
Sampeyan bisa nyoba sambungan 3D Secure kapan wae liwat sistem pembayaran. Kanggo nindakake, gunakake mode "CONNECTOR_TEST" kanggo transaksi, kaya sing dituduhake ing mantanamples ing ndhuwur.
Data sambungan kanggo tes iki:
| PENGIRIM KESELAMATAN | 31HA07BC8142C5A171745D00AD63D182 |
| PENGGUNA.LOGIN | 31ha07bc8142c5a171744e5aef11ffd3 |
| USER.PWD | 93167DE7 |
| TRANSAKSI.CHANNEL | 31HA07BC8142C5A171749A60D979B6E4 |
| Mata uang sing dikonfigurasi kanggo Versi 3D 2 | EUR, USD, SEK |
| Mata uang sing dikonfigurasi kanggo Versi 3D 1 | GBP, CZK, CHF |
Endpoint gateway sistem uga
Gerbang SGW:
- https://test-heidelpay.hpcgw.net/sgw/gtw - Latin-15 dienkode
- https://test-heidelpay.hpcgw.net/sgw/gtwu - UTF-8 dienkode
Gerbang NGW:
- https://test-heidelpay.hpcgw.net/ngw/post
Data kertu kredit kanggo tes iki:
| merek | nomer kertu | CVV | tanggal kadaluwarsa | cathetan |
| MasterCard | 5453010000059543 | 123 | tanggal mbesuk | 3D - tembung sandhi: rahasia3 |
| visa | 4711100000000000 | 123 | tanggal mbesuk | 3DS - tembung sandhi: rahasia! 33 |
Elinga: Kanggo 3D Secure Versi 2, sampeyan ora prelu ngetik sandhi, nanging cukup klik link ”Klik ing kene kanggo ngrampungake otentikasi.
Siji-sijine cara kanggo simulasi kesalahan karo 3D Secure Versi 2 yaiku supaya kaca kasebut metu wektu link (udakara 18 menit).
Waca Liyane Babagan Manual Iki & Unduh PDF:
Dokumen / Sumber Daya
 |
Pandhuan Integrasi Aman 3D Softwares [pdf] Dokumentasi Unzer, Pandhuan Integrasi, 3D Aman |
