Kun olet käynyt oppaan läpi, ČSOB on yhdistetty tiliisi testitilassa, testikorttimaksu toimii alusta loppuun ja sinulla on selkeä tie siirtyä tuotantoon, kun sinulla on ČSOB:n sopimus.
Ennen kuin aloitat
Mitä tarvitset
- Cabintale-tili.
- Testaamiseen: ei mitään muuta. ČSOB:n testiympäristö (sandbox) on avoin kaikille, sopimusta ei tarvita.
- Tuotantoon myöhemmin: ČSOB:n maksupalvelusopimus (kaupallinen puhelinnumero 800 150 150, Tšekki) ja pääsy ČSOB:n POS Merchant -portaaliin.
- Noin 15 minuuttia.
Mitä saat aikaan
- ČSOB yhdistettynä tilitasolla, valmiina minkä tahansa kohteen käyttöön
- Testikorttimaksu, joka toimii alusta loppuun (simuloitu, oikeaa rahaa ei liiku)
- Selkeä, erillinen tie siirtyä tuotantoon, kun sopimuksesi on valmis
Miten ČSOB yhdistetään Cabintaleen
Cabintale tarvitsee sinulta kolme asiaa, jotka liität kohtaan Asetukset → Maksupalvelut:
- Kauppiastunnus (Merchant ID): saat sen ČSOB:lta.
- Yksityinen avain: luot sen itse (pidät sen itselläsi, se ei koskaan lähde sinulta).
- ČSOB:n pankin julkinen avain: tiedosto, jonka lataat ČSOB:lta.
Aloitat testitilassa (ČSOB:n ilmainen testiympäristö, simuloidut maksut) ja siirryt tuotantoon erillisillä tuotantoavaimilla, kun sinulla on sopimus.
Vaihe 1: Luo avaimet ja hae kauppiastunnus
- Avaa ČSOB:n testi-avaingeneraattori: https://iplatebnibrana.csob.cz/keygen/
- Luo 2048-bittinen RSA-avainpari. Tallenna molemmat avaimet turvalliseen paikkaan, sillä yksityistä avainta ei voi ladata myöhemmin uudelleen.
- Lähetä julkinen avain ČSOB:lle sivun painikkeella.
- ČSOB näyttää kauppiastunnuksesi (Merchant ID). Kopioi se.
Vaihe 2: Lataa ČSOB:n pankin julkinen avain
- Avaa ČSOB:n avainkansio: https://github.com/csob/paymentgateway/tree/master/keys
- Testaamiseen ota sandbox-avain:
mips_iplatebnibrana.csob.cz.pub. - Avaa se ja kopioi sen sisältö. Liität sen seuraavassa vaiheessa. (Kun siirryt tuotantoon, otat samasta paikasta tuotantoavaimen.)
Vaihe 3: Liitä kaikki Cabintaleen
- Sivupalkki → Asetukset → Maksupalvelut → napsauta ČSOB-kortissa Määritä.
- Jätä tilaksi Testitila.
- Täytä kolme kenttää:
- Kauppiastunnus: vaiheesta 1.
- Yksityinen avain (PEM): yksityinen avaimesi (se alkaa
-----BEGIN RSA PRIVATE KEY-----). - Pankin julkinen avain (PEM): vaiheen 2 tiedosto.
- Napsauta Tallenna.
ČSOB-korttisi näkyy nyt yhdistettynä ja siitä tulee tilin oletusmaksupalvelu.
Vaihe 4: Testaa maksu
- Ota maksut käyttöön kohteelle tai palvelulle (katso Maksujen vastaanotto kohteessa).
- Tee testivaraus widgetissäsi ja maksa ČSOB:n testikortilla. Maksu ja turvatarkistus simuloidaan, oikeaa rahaa ei liiku.
- Varaus saapuu hallintapaneeliisi tilassa Maksettu.
Vaihe 5: Siirry tuotantoon
- Tee ČSOB:n maksupalvelusopimus: soita ČSOB:n kaupalliseen numeroon 800 150 150 (Tšekki) tai kysy verkkokaupan maksupalvelua ČSOB:n yritysyhteyshenkilöltäsi.
- Luo erillinen tuotantoavainpari osoitteessa https://platebnibrana.csob.cz/keygen/ ja tallenna molemmat avaimet.
- Vahvista avain POS Merchantissa — https://posman.csob.cz/posmerchant — jotta ČSOB aktivoi sen tuotantomaksuja varten.
- Lataa tuotannon pankin julkinen avain samasta avainkansiosta.
- Cabintalessa → Asetukset → Maksupalvelut → ČSOB → Asetukset: vaihda tilaksi Tuotantotila, liitä tuotannon kauppiastunnus, yksityinen avain ja pankin julkinen avain, napsauta Tallenna ja aseta Tuotantotila aktiiviseksi tilaksi.
Ongelmanratkaisu
| Oire | Todennäköinen syy | Ratkaisu |
|---|---|---|
| Yhteystesti epäonnistuu heti tallennuksen jälkeen | Avain liitettiin vajaana tai ylimääräisten välilyöntien kanssa tai otsikkorivi puuttuu | Kopioi koko avain uudelleen mukaan lukien -----BEGIN…----- / -----END…----- -rivit ilman alussa olevia välilyöntejä |
| Toimii testitilassa mutta ei tuotannossa | Tuotanto tarvitsee omat tuotantoavaimet, kauppiastunnuksen ja tuotannon pankin julkisen avaimen | Luo tuotantoavaimet, vahvista ne POS Merchantissa ja liitä tuotantosarja Tuotantotilaan |
| "Wrong bank public key" / allekirjoitusvirheet | Käytit testin pankin avainta tuotannossa (tai päinvastoin) | Lataa vastaavan ympäristön avain ČSOB:n avainkansiosta |
| Vieraat eivät voi maksaa tuotannossa | Tuotantoavainta ei ole vielä aktivoitu | Vahvista avain POS Merchantissa. Aktivointi voi kestää hetken |
Aiheeseen liittyvät oppaat
- Maksupalvelun käyttöönotto — Maksupalvelut
- Maksujen vastaanotto kohteessa — Maksujen vastaanotto kohteessa
- Hyvitykset ja peruutukset — Hyvitykset ja peruutukset