Integracija AgentCASH Checkouta

Preprost način integracije AgentCASH plačil je preko Checkout-a, ki poskrbi za kreiranje obrazca, validiranje vnosa in varnost kartičnih podatkov vašega kupca. AgentCASH Checkout je varna plug-and-play rešitev za spletne trgovine, ki ne želijo dolgotrajnega in dragega postopka PCI DSS certifikacije.

AgentCASH Checkout predstavlja relativno visoko stopnjo integracije. V kolikor Checkout ne odgovarja vašim potrebam, bomo kmalu omogočili lastne vnosne obrazce preko AgentCASH.js dodatka.

 

Da bi videli, kako AgentCASH deluje v praksi, kliknite na spodnji primer in izpolnite obrazec z enim od testnih številk AgentCASH kartic (npr. 4200000000000018 Visa ali 5500000000000012 MasterCard), katero koli CVC kodo, katerim koli datumom poteka in katerim koli imenom lastnika kartice.

 

 

Integracija Checkouta

Integracija je preprosta. Z vključevanjem JavaScript datotek na svojo spletno stran vam bo omogočen globalni dostop do ''agentcash'' objekta. Ta objekt je odgovoren za komunikacijo z AgentCASH platformo in upravljanjem obrazca za plačilo.

Če je JS datoteka opremljena s key parametrom, se bo objekt avtomatsko inicializiral tako, da dodatne akcije niso potrebne. V nasprotnem primeru je potrebno objekt ročno konfigurirati s pošiljanjem API key-a kot parametra agentcash.configure() metode.

API key se lahko enostavno generirajo v administratorskem načinu na spletni strani: odprite ''API'' zavihek v ''Webshop'' meniju in ga kreirajte.

Po inicializaciji, bo AgentCASH.js poiskal vse DOM elemente, ki vsebujejo data-agentcash atribute. Odvisno od vrednosti atributov lahko nastanejo različni scenariji in lahko pričakujemo dodatne atribute.

 

Primer: Plačilo 50 €

Ta primer kaže najlažjo pot kako integrirati plačila na vašo spletno stran. Predpostavlja se, da je valuta trgovca Evro.

 

Skripta se vključuje v HTML dokument samo enkrat (primer: <head> element):

<script src="https://www.agentcash.com/js/agentcash.js?key={key}"></script>

 

Vsi gumbi, ki služijo kot štartne točke za plačilo morajo biti označene s prepoznavnim atributom data-agentcash=''charge'' in morajo imeti veljaven znesek definiran v data-amount atributu.

<button 
data-agentcash="charge"
data-amount="50.00"
data-language="sl"
data-callback-url="{callback_url}"
data-external-id="{external_id
}"
data-success-url="{success_url}"
data-failure-url="{failure_url}"
data-cancel-url="{cancel_url}">Buy</button>

 

Ta gumb nalaga AgentCASH.js da kupcu zaračuna 50 €.

S klikom na gumb se odpre pop-up dialog in začne tok plačila znotraj njega. Uporabnik vnese podatke s kreditne kartice in potrdi nakup s pritiskom na ''Plačaj''. Če je transakcija 50 EUR odobrena, AgentCASH pošlje rezultat na vaš server, tj. URL definiran v opcijskem data-callback-url atributu, ki uporabniku prikazuje dialog o uspešni transakciji s kupcem.

Če želite, da se plačilo označi z vašim identifikatorjem (npr. z številko naročil), je nujno, da je vrednost napisana v atribut data-external-id.

Callback URL-u AgentCASH čez POST telo pošlje JSON podatke o plačilu, ki v primeru uspešne transakcije izgledajo tako:

{
    payment_id: "...",
external_id: "...",
type: "purchase", status: "approved", receipt_url: "http://www.agentcash.com/p/3423235", amount: "50.00", currency: "EUR",
approval_code: "123456",
card_brand: "mastercard", card_masked_pan: "654321****1234", card_cardholder_name: "Andy Jervis",
card_fingerprint: "...", created_at: "2015-08-11T12:01:33Z", signature_order: "...", signature: "..." }  

 

V kolikor namesto standardnega AgentCASH sporočila o rezultatu transakcije želite prikazati svoje spletno mesto z obvestilom o uspešnem, neuspešnem ali prekinjenem plačilu, lahko URL do teh strani definirate v opcijskih atributih data-success-url, data-failure-url in data-cancel-url.

 

Izbira jezika uporabniškega vmesnika

Jezik obrazca izhaja iz prevzetega jezika trgovca. V primeru, da želite točno določiti jezik obrazca, ga lahko v opcijskem data-language atributu določite, pri čemer more biti vrednost dvočrkovna oznaka želenega jezika.

  • data-language="en" – nastavi jezik na angleški
  • "de" - nemški
  • "fr" - francoski
  • "it" - italijanski
  • "es" - španski
  • "pt" - portugalski
  • "ru" - ruski
  • "cs" - češki
  • "hr" - hrvaški
  • "sl" - slovenski

 

HTTPS za vašo stran

Vsa izmenjava podatkov pri uporabi Checkout-a poteka preko varne HTTPS povezave. Vseeno priporočamo, v izogib man-in-the-middle napadom tudi spletno stran, ki vsebuje obrazec za plačilo zavarujete s HTTPS protokolom. To pomeni, da se vsaka spletna stran s Checkout-om začne s https:// namesto samo s http://.

 

Imate vprašanja? Pošlji zahtevek

Komentar

Powered by Zendesk