Dokuméntasi Pitunjuk Integrasi Aman Softwares 3D
Pamaduan Guide 3D Aman
Ti 01.01.2021 on auténtikasi dua-faktor bakal dilaksanakeun salaku sarat wajib pikeun sakabéh transaksi pembayaran kartu ecommerce. Dina raraga minuhan kawajiban ieu, nu
operator jaringan kartu kiridit bakal ngagunakeun disebut prosedur 3D Secure. Pikeun anjeun salaku padagang éta wajib pikeun bisa ngalaksanakeun prosedur ieu pikeun konsumén Anjeun tina
01.01.2021. Di handap ieu anjeun bakal mendakan pedaran ngeunaan cara integrasi anu béda sareng kumaha prosedur 3D Secure kedah dilaksanakeun pikeun aranjeunna.
Mangga pilih metodeu integrasi nu Anjeun pake
- Dupi anjeun nganggo formulir Checkout hCO?
- Dupi anjeun nganggo hPF formulir Checkout?
- Naha anjeun ngolah pamayaran tanpa nganggo formulir anu disayogikeun ku sistem Unzer?
Punten Catet: Éta ogé penting kumaha cara debit atanapi preauthorizations (reservations) dijieun. Sanaos anjeun nganggo bentuk pamayaran ti Unzer GmbH pikeun pendaptaran data kartu, prosés 3D Secure bakal dilaksanakeun tanpa formulir pamariksaan nalika data kartu munggaran didebit atanapi otorisasi pikeun kahiji kalina. Dina hal ieu cara katilu integrasi tanpa formulir disadiakeun ku Unzer lumaku.
Perhatikeun ogé:
Upami anjeun nganggo pangmayaran anu ngulang deui (pamayaran langganan), pastikeun maca bagian "3D Secure and Recurring Payment".
Prosedur 3D Aman nalika nganggo formulir kasir hCO
Bentuk checkout hCO parantos dirarancang pikeun prosedur 3D Secure. Teu aya tindakan tambahan ti sisi anjeun anu diperyogikeun pikeun palaksanaan prosedur. Sanajan kitu, anjeun
Anjeun kedah mastikeun yén sistem anjeun tiasa ngadamel jawaban anu cocog tina sistem pamayaran kami upami prosés 3D Secure dimimitian. Dina respon Asynchronous ti
sistem pamayaran ka server anjeun, hasil transaksi dikirimkeun sarta kudu dievaluasi aya saméméh mulang URL dikirimkeun ka sistem pembayaran.
Pikeun tujuan ieu, parameter di handap ieu kedah dievaluasi.
- PROSES.BALIK.KODE = 000.200.000
- NGPROSES.PULUNG = Transaksi+pending
- PROSES.HASIL = ACK
Katerangan: Status transaksi "pending", parameter PROCESSING.RESULT
ngan ngagambarkeun hasil awal. Salami prosés 3D Secure dilaksanakeun, statusna
tetep pending.
Hasil ahir tina transaksi nyaeta lajeng boh
- PROSES.BALIK.KODE = 000.000.000
- PROSES.HASIL = ACK
or - PROCESSING.RETURN.CODE = irgendein Wert ungleich 000.000.000 oder 000.200.000
- PROSES.HASIL = NOK
Dina kasus kahiji urus geus hasil réngsé, dina kasus kadua geus gagal sakabéh. Anu terakhir tiasa gaduh sababaraha alesan, kalebet panolakan pikeun ngabuktoskeun kaaslianana. Anjeun bakal
nampi inpormasi anu langkung lengkep dina parameter "PROCESSING.RETURN" sareng "PROCESSING.RETURN.CODE".
Kami nyarankeun yén anjeun ngajalankeun tés pikeun duanana pesen. Kanggo inpo nu langkung lengkep ihwal kumaha cara ngalakukeun tés sareng wincik kartu kiridit mana anu anjeun tiasa dianggo pikeun tés, mangga tingali di handap.
Prosedur 3D Aman nalika nganggo formulir kasir hPF
Formulir checkout hPF ogé dirancang pikeun ngagunakeun prosedur 3DS. Teu aya tindakan tambahan ti sisi anjeun anu diperyogikeun pikeun palaksanaan prosedur. Sakumaha anu dijelaskeun
pikeun palaksanaan hCO respon ti sistem pembayaran lumangsung dina dua hambalan, naha sistem Anjeun kudu pariksa nilai PROCESSING.RETURN.CODE.
parameter nalika ngolah respon.
Pikeun tujuan ieu, parameter di handap ieu kedah dievaluasi.
- PROSES.BALIK.KODE = 000.200.000
- NGPROSES.PULUNG = Transaksi+pending
- PROSES.HASIL = ACK
Katerangan: Status transaksi "pending", parameter PROCESSING.RESULT ngan ukur ngagambarkeun hasil awal. Salami prosés 3D Secure dilaksanakeun, statusna
tetep pending.
Hasil ahir tina transaksi nyaeta lajeng boh
- PROSES.BALIK.KODE = 000.000.000
- PROSES.HASIL = ACK
or - PROCESSING.RETURN.CODE = irgendein Wert ungleich 000.000.000 oder 000.200.000
- PROSES.HASIL = NOK
Dina kasus kahiji urus geus hasil réngsé, dina kasus kadua geus gagal sakabéh. Anu terakhir tiasa gaduh sababaraha alesan, kalebet panolakan pikeun ngabuktoskeun kaaslianana. Anjeun bakal
nampi inpormasi anu langkung lengkep dina parameter "PROCESSING.RETURN" sareng "PROCESSING.RETURN.CODE".
Kami nyarankeun yén anjeun ngajalankeun tés pikeun duanana pesen. Kanggo inpo nu langkung lengkep ihwal kumaha cara ngalakukeun tés sareng wincik kartu kiridit mana anu anjeun tiasa dianggo pikeun tés, mangga tingali di handap.
Prosedur 3D Aman sareng sambungan langsung
Upami anjeun henteu nganggo bentuk pamayaran anu disayogikeun ku Unzer (baheulana heidelpay) pikeun ngolah pamayaran kartu kiridit, atanapi upami anjeun ngan saukur ngadaptarkeun kartu nganggo salah sahiji bentuk sareng ngolah pra-otorisasi (reservasi) atanapi debit salaku rujukan pikeun pendaptaran salaku a komunikasi langsung jeung sistem pembayaran, anjeun kudu nerapkeun prosés 3D Aman.
Aliran transaksi Asynchronous:
Ieu mangrupikeun prosés asynchronous dimana server anjeun nampi diteruskeun URL (Alihan URL) tina sistem pembayaran kami. Server anjeun kedah neraskeun palanggan ka ieu URL supados anjeunna tiasa ngalaksanakeun auténtikasi ngalangkungan prosedur 3D Secure. Hasil tina auténtikasi 3D Secure ieu dilaporkeun langsung ka Unzer ku bank anu ngaluarkeun kartu.
Saatos auténtikasi suksés, urus diolah satuluyna dina sistem Unzer ku cara anu anjeun parantos terang ku ngirim sistem anjeun hasil sadayana dina tungtungna, anu anjeun bales.
kalawan alihan URL. Sistem pamayaran teras bakal alihan palanggan deui ka sistem anjeun nganggo alihan ieu URL ti sistem Anjeun
Perhatikeun: Dina alur kerja ieu sistem anjeun nampi dua jawaban tina sistem pamayaran:
- Hiji sareng status "pending" (PROCESSING.RETURN.CODE=000.200.000 sareng PROCESSING.RETURN=Transaksi+pending) sareng parameter alihan ka bank anu ngaluarkeun kartu nasabah
- Hiji kalawan hasil ahir tina debit atawa reservasi. Aya ogé dua alihan URLs disebutkeun dina prosés ieu, salah sahiji sistem pembayaran nu nasabah kudu dialihkeun ka auténtikasi dina kartu na ngaluarkeun bank und hiji ti sistem Anjeun, nalika narima hasil ahir, pikeun alihan nasabah deui kana sistem Anjeun.
Parobihan di handap ieu bakal dilakukeun kana prosedur biasa. Perhatikeun yén alatan palaksanaan métode pembayaran Asynchronous séjén, kayaning Paypal, sababaraha ieu
prosés bisa geus aya dina palaksanaan Anjeun.
- Tanggapan URL
Dina panggero kahiji (no.2 dina diagram) kana sistem pembayaran, a "Tanggapan URL” kudu diliwatan dina grup frontend.
Punten Catet: Parameter IDENTIFICATION.REFERENCEID ngan ukur relevan upami anjeun ngarujuk kana pendaptaran atanapi transaksi anu parantos aya - Ngolah alihan URL Upami auténtikasi diperyogikeun, alihan URL sarta parameter sejenna dina grup alihan ditransferkeun dina respon ti sistem pembayaran (No. 5 dina diagram).
- Neraskeun palanggan ka alihan URL
Lamun grup alihan ieu ngabales ku alihan URL, browser customer urang kudu dialihkeun ka ieu URL (No. 6 dina diagram) pikeun ngalakukeun auténtikasi. Parameter tambahan tina grup alihan kedah dialihkeun ka luar websitus salaku parameter POST.
Perhatikeun: Parameter tambahan dipulangkeun dina grup "PROCESSING.REDIRECT.xxx" ngan nganggo 3D Secure Version 1 (malah aya nomer sareng nami tiasa béda-béda), sedengkeun sareng 3D Version 2 ngan ukur PROCESSING.REDIRECT.URL sakumaha ditémbongkeun di handap ieu balik: https://heidelpay.hpcgw.net/AuthService/v1/auth/public/2258_2863FFA4C5241C12E39F37
CCF/run Ieu ngandung harti yén paduli tipe sarta jumlah parameter, browser klien kudu alihan ka PROCESSING.REDIRECT.URL.
Handap anjeun bakal manggihan ex kode basajanample kumaha alihan misalna bisa dieksekusi. The bagian dimaksudkeun pikeun nginpokeun ka konsumén tungtung anu sistemna henteu ngadukung Javascript atanapi ditumpurkeun. Kami nyarankeun pisan yén alihan dilakukeun dina jandela pangotektak aktip palanggan sareng henteu nganggo windows pop up atanapi windows browser énggal, sabab ieu tiasa
ngairitasi konsumén jeung ngarah ka nutup kaca maranéhanana dialihkeun ka.
- Cék hasil Asynchronous
Hasil auténtikasi dikirim asynchronously ka server anjeun. Sistem pembayaran ekspektasi valid a URL salaku respon. (No. 12 & 13 dina diagram). Pikeun suksés atawa ditolak
pangmayaran, béda URL tiasa direspon di dieu ku sistem anjeun. - Jalan balik konsumén
Sistem pembayaran alihan nasabah ka URL disayogikeun ku sistem padagang saatos prosés auténtikasi sareng transaksi pamayaran parantos réngsé.
Perhatikeun: Lengkah 4.) jeung 5.) lumangsungna persis cara nu sarua sakumaha anjeun geus akrab jeung dina transaksi NONE 3D Aman aya.
Pamayaran 3D Aman sareng ngulang
Ti 1 Januari 2021, 3D Secure bakal diwajibkeun pikeun sadaya transaksi kartu e-commerce. Sanajan kitu, saprak ieu boro lumaku pikeun pangmayaran ngulang, perbankan
Sistem gaduh alur kerja anu misah pikeun ieu.
Pikeun tujuan ieu, bank ngabedakeun antara
- CIT = transaksi initialised customer
- MIT = padagang initialised transaksi
Transaksi mimiti kartu dina akun sudagar anjeun kedah dioténtikasi ku 3D Secure ti 01.01.2021 teras. A auténtikasi suksés sapertos sarat wajib di
supados tiasa salajengna ngalebetkeun bookings salajengna dina kartu sarua tanpa 3D Secure. Ku alatan éta, nasabah kedah diteruskeun ka bank anu ngaluarkeun kartu na pikeun debit munggaran
luyu jeung prosedur ditétélakeun di luhur sarta ngabuktoskeun kaaslianana dirina aya salaku cardholder nu. Upami debit henteu direncanakeun dina waktos pesenan, contonaample alatan periode percobaan, hiji reservasi (pra-otorisasi) sahenteuna hiji euro kudu dilakukeun kalawan 3D Secure ku ayana nasabah gantina. Capture tina reservasi ieu teu perlu.
Pikeun konsumén anu tos aya, kumaha oge, teu aya otentikasi 3D Secure anu kedah didamel. Lamun debit suksés kahiji lumangsung saméméh 01.01.2021, catetan customer ogé bisa dianggap
geus hasil dioténtikasi. Pikeun konsumén anyar ti 01.01.2021, sabalikna, auténtikasi 3D Secure wajib pikeun debit atanapi reservasi munggaran (pra-otorisasi).
Punten dicatet: Dina hal ieu, sistem perbankan ningali data kartu, sanés data nasabah. Ku kituna lamun hiji customer aya ngagunakeun kartu anyar sanggeus 01.01.2021, pikeun example sabab saméméhna
hiji geus kadaluwarsa atawa alatan anjeunna geus robah bank-ngaluarkeun kartu na, ieu téh siklus ngulang anyar ti titik bank '. view sarta kudu dioténtikasi kalawan 3D Secure pikeun booking munggaran.
Sakali auténtikasi awal ieu parantos suksés dilaksanakeun, sadaya transaksi salajengna dibebaskeun tina kawajiban ngagunakeun 3D Secure.
- Sahenteuna aya hiji debit atanapi reservasi anu suksés (pra-otorisasi) anu dilaksanakeun nganggo 3D Secure atanapi dilaksanakeun sateuacan 01.01.2021.
- éta dirujuk kana pendaptaran sareng debit anu tos aya nalika kiriman
Pikeun sistem pamayaran terang yén ieu mangrupikeun pamayaran anu ngulang, parameter RECURRENCE.MODE=REPEATED ogé kedah dikirimkeun. Ieu sinyal ka sistem anu a
pangmayaran ulang kudu dilaporkeun ka sistem perbankan.
Perhatikeun: Upami parameter RECURRENCE.MODE=REPEATED diasupkeun nalika kartu anyar dimuat pikeun kahiji kalina, 3D Secure forwarding bakal dilaksanakeun sanajan parameter ieu.
Nguji palaksanaan 3D Secure
Anjeun tiasa nguji sambungan 3D Secure iraha waé liwat sistem pamayaran kami. Jang ngalampahkeun kitu, make "CONNECTOR_TEST" mode pikeun transaksi, sakumaha ditémbongkeun dina examples luhur.
Data sambungan pikeun tés ieu:
| KAAMANAN.SENDER | 31HA07BC8142C5A171745D00AD63D182 |
| USER.LOGIN | 31ha07bc8142c5a171744e5aef11ffd3 |
| USER.PWD | 93167DE7 |
| TRANSAKSI.SALURAN | 31HA07BC8142C5A171749A60D979B6E4 |
| Mata uang dikonpigurasi pikeun Vérsi 3D 2 | EUR, USD, SEK |
| Mata uang dikonpigurasi pikeun Vérsi 3D 1 | GBP, CZK, CHF |
System gateway endpoint boh
Gerbang SGW:
- https://test-heidelpay.hpcgw.net/sgw/gtw - disandikeun Latin-15
- https://test-heidelpay.hpcgw.net/sgw/gtwu - disandi UTF-8
NGW gateway:
- https://test-heidelpay.hpcgw.net/ngw/post
Data kartu kiridit pikeun tés ieu:
| merek | angka kartu | CVV | tanggal kadaluarsa | Catetan |
| MasterCard | 5453010000059543 | 123 | tanggal hareup | 3D - sandi: rusiah3 |
| Visa | 4711100000000000 | 123 | tanggal hareup | 3DS – sandi: rusiah!33 |
Perhatikeun: Pikeun 3D Secure Version 2, anjeun henteu kedah ngalebetkeun kecap konci, tapi ngan saukur klik tautan "Klik di dieu pikeun ngalengkepan auténtikasi.
Hiji-hijina jalan pikeun simulate kasalahan jeung 3D Secure Vérsi 2 nyaéta pikeun ngidinan kaca jeung link waktu kaluar (approx. 18 menit).
Maca deui Ngeunaan Buku Panduan Ieu & Unduh PDF:
Dokumén / Sumberdaya
 |
Softwares 3D Panungtun Pamaduan Aman [pdf] Dokuméntasi Unzer, Pitunjuk Integrasi, 3D Aman |
