{"id":5452,"date":"2019-03-28T10:04:42","date_gmt":"2019-03-28T09:04:42","guid":{"rendered":"https:\/\/www.gopay.com\/blog\/?p=5452"},"modified":"2023-08-30T13:19:03","modified_gmt":"2023-08-30T11:19:03","slug":"5-zasad-spravne-integrace-ktere-vam-zvysi-pocet-uhrazenych-plateb","status":"publish","type":"post","link":"https:\/\/www.gopay.com\/blog\/5-zasad-spravne-integrace-ktere-vam-zvysi-pocet-uhrazenych-plateb\/","title":{"rendered":"5 z\u00e1sad spr\u00e1vn\u00e9 integrace, kter\u00e9 v\u00e1m zv\u00fd\u0161\u00ed po\u010det uhrazen\u00fdch plateb"},"content":{"rendered":"

O tom, jak by m\u011bla vypadat spr\u00e1vn\u00e1 integrace platebn\u00ed br\u00e1ny, jsme psali u\u017e loni na podzim<\/a>.<\/p>\n

Nestihli jsme ale do \u010dl\u00e1nku d\u00e1t \u00fapln\u011b v\u0161echno, a proto p\u0159ich\u00e1z\u00edme s druh\u00fdm d\u00edlem.<\/p>\n

<\/p>\n

Uk\u00e1\u017eeme v\u00e1m v n\u011bm, jak zv\u00fd\u0161\u00edte po\u010det spr\u00e1vn\u011b uhrazen\u00fdch plateb p\u0159es platebn\u00ed br\u00e1nu<\/strong> a z\u00e1rove\u0148 zodpov\u00edme nej\u010dast\u011bj\u0161\u00ed dotazy, se kter\u00fdmi se na technick\u00e9 podpo\u0159e setk\u00e1v\u00e1me.<\/p>\n\n

1) Z\u00edsk\u00e1n\u00ed seznamu povolen\u00fdch platebn\u00edch metod<\/h2>\n

Z\u00e1kladem zv\u00fd\u0161en\u00ed \u00fasp\u011b\u0161nosti dokon\u010den\u00fdch objedn\u00e1vek a t\u00edm i plateb, je spr\u00e1vn\u00e9 rozvr\u017een\u00ed ko\u0161\u00edku<\/strong>, ve kter\u00e9m z\u00e1kazn\u00edkovi nab\u00edz\u00edte mo\u017enosti pro platbu. Pro spr\u00e1vn\u00e9 zobrazen\u00ed seznamu platebn\u00edch metod a z\u00edsk\u00e1n\u00ed jejich log m\u016f\u017eete pou\u017e\u00edt funkcionalitu na\u0161eho API, kter\u00e1 je uvedena v na\u0161\u00ed online dokumentaci<\/a>.<\/p>\n

Touto funkcionalitou z\u00edsk\u00e1te aktu\u00e1ln\u00ed seznam kategori\u00ed<\/strong>, n\u00e1zv\u016f povolen\u00fdch platebn\u00edch metod<\/strong> a odkaz\u016f na loga<\/strong>. Informace m\u016f\u017eete vyu\u017e\u00edt p\u0159i rozd\u011blov\u00e1n\u00ed platebn\u00edch metod na va\u0161em e-shopu.<\/p>\n

2) Rozd\u011blen\u00ed platebn\u00edch metod v ko\u0161\u00edku<\/h2>\n

V tomto \u010dl\u00e1nku<\/a> jsme v\u00e1m prezentovali, jak\u00fdm zp\u016fsobem je mo\u017en\u00e9 platebn\u00ed metody na va\u0161em e-shopu prezentovat. Nyn\u00ed se v\u0161ak na konkr\u00e9tn\u00ed varianty pod\u00edv\u00e1me detailn\u011bji.<\/p>\n

a) P\u0159\u00edm\u00e1 varianta<\/h3>\n

U p\u0159\u00edm\u00e9 varianty doch\u00e1z\u00ed k v\u00fdb\u011bru platebn\u00ed metody p\u0159\u00edmo na stran\u011b e-shopu<\/strong>, kde m\u00e1 obchodn\u00edk vypsan\u00e9 ve\u0161ker\u00e9 platebn\u00ed metody, kter\u00e9 si p\u0159eje z\u00e1kazn\u00edkovi nab\u00eddnout. Pro snadn\u011bj\u0161\u00ed vyps\u00e1n\u00ed v\u0161ech aktivn\u00edch platebn\u00edch metod m\u016f\u017eete pou\u017e\u00edt v\u00fd\u0161e uvedenou funkcionalitu \u201cZ\u00edsk\u00e1n\u00ed seznamu povolen\u00fdch platebn\u00edch metod pro dan\u00fd e-shop“.<\/p>\n

Po v\u00fdb\u011bru konkr\u00e9tn\u00ed platebn\u00ed metody z\u00e1kazn\u00edkem n\u00e1sleduje p\u0159esm\u011brov\u00e1n\u00ed na platebn\u00ed br\u00e1nu GoPay, kde z\u00e1kazn\u00edk pouze zad\u00e1 p\u0159\u00edpadn\u00e9 \u00fadaje a platbu potvrd\u00ed. Jak takov\u00e9 p\u0159esm\u011brov\u00e1n\u00ed vypad\u00e1 z pohledu va\u0161eho program\u00e1tora? Cel\u00fd po\u017eadavek na zalo\u017een\u00ed platby je pops\u00e1n v na\u0161\u00ed dokumentaci<\/a>.<\/p>\n

U p\u0159\u00edm\u00e9 varianty doch\u00e1z\u00ed k omezen\u00ed platebn\u00edch metod na konkr\u00e9tn\u00ed zalo\u017eenou platbu a to v parametru \"allowed_payment_instruments\"<\/code>. Pokud do tohoto parametru v\u00e1\u0161 program\u00e1tor uvede pouze jednu konkr\u00e9tn\u00ed metodu, z\u00e1kazn\u00edk na ni bude p\u0159esm\u011brov\u00e1n a nebude ji moci na platebn\u00ed br\u00e1n\u011b GoPay zm\u011bnit. P\u0159\u00edklad na p\u0159esm\u011brov\u00e1n\u00ed pouze s platebn\u00ed metodou platebn\u00ed kartou by tedy byl n\u00e1sledovn\u011b:
\n…
\n\"allowed_payment_instruments\":\u201dPAYMENT_CARD\u201d<\/code>
\n\u2026<\/p>\n

\"platebn\u00ed<\/p>\n

Pro p\u0159\u00edm\u00e9 p\u0159esm\u011brov\u00e1n\u00ed z\u00e1kazn\u00edka do internetov\u00e9ho bankovnictv\u00ed (tedy bez interakce z\u00e1kazn\u00edka na platebn\u00ed br\u00e1n\u011b GoPay), je nutn\u00e9 p\u0159edat parametry:
\n…
\n\"allowed_payment_instruments\":\u201dBANK_ACCOUNT\u201d<\/code>
\n\"allowed_swifts\"<\/code> (tento parametr by obsahoval SWIFT k\u00f3d jedn\u00e9 konkr\u00e9tn\u00ed banky)
\n…<\/p>\n

D\u00e1le je nutn\u00e9 p\u0159edat objekt \u201ccontact\u201d<\/code>, ve kter\u00e9m uvedete minim\u00e1ln\u011b parametr \u201ce-mail\u201d<\/code> (kter\u00fd mus\u00ed b\u00fdt p\u0159i platb\u011b v\u017edy potvrzen), to umo\u017en\u00ed p\u0159esm\u011brovat z\u00e1kazn\u00edka do jeho internetov\u00e9ho bankovnictv\u00ed bez iterace na platebn\u00ed br\u00e1n\u011b.<\/p>\n

b) \u010c\u00e1ste\u010dn\u011b agregovan\u00e1 varianta\u200b<\/h3>\n

U \u010d\u00e1ste\u010dn\u011b agregovan\u00e9 varianty doch\u00e1z\u00ed ke zjednodu\u0161en\u00ed v\u00fdpisu platebn\u00edch metod<\/strong>. Za p\u0159edpokladu vyu\u017eit\u00ed platebn\u00edch metod Platebn\u00ed karta<\/em> a Bankovn\u00ed p\u0159evod<\/em> bude po\u017eadavek zalo\u017een\u00ed platby vypadat n\u00e1sledovn\u011b:<\/p>\n

Platebn\u00ed karta<\/h5>\n

Dojde k zalo\u017een\u00ed platby s parametrem a hodnotou:
\n…
\n\"allowed_payment_instruments\":\u201dPAYMENT_CARD\u201d<\/code>
\n…<\/p>\n

Bankovn\u00ed p\u0159evod<\/h5>\n

Dojde k zalo\u017een\u00ed platby s parametrem a hodnotou:
\n…
\n\"allowed_payment_instruments\":\u201dBANK_ACCOUNT\u201d<\/code>
\n…<\/p>\n

Z\u00e1kazn\u00edkovi budou v p\u0159\u00edpad\u011b platby bankovn\u00edm p\u0159evodem zobrazeny agregovan\u00e9 online i offline bankovn\u00ed p\u0159evody<\/strong>, viz nastaven\u00ed platebn\u00edch metod na e-shopu<\/a>. Z\u00e1kazn\u00edk na platebn\u00ed br\u00e1n\u011b GoPay zvol\u00ed konkr\u00e9tn\u00ed banku a platbu dokon\u010d\u00ed.<\/p>\n

\"gopay<\/p>\n

c) Agregovan\u00e1 varianta\u200b<\/h3>\n

V p\u0159\u00edpad\u011b pln\u011b agregovan\u00e9 varianty je pro platbu k dispozici jedin\u00e9 tla\u010d\u00edtko<\/strong>. Z\u00e1kazn\u00edk konkr\u00e9tn\u00ed platebn\u00ed metodu zvol\u00ed a\u017e na platebn\u00ed br\u00e1n\u011b GoPay, kde mu budou nab\u00eddnuty v\u0161echny aktivn\u00ed platebn\u00ed metody e-shopu. Jak platebn\u00ed metody v e-shopu nastavit, najdete v tomto \u010dl\u00e1nku<\/a>.<\/p>\n

Pro zalo\u017een\u00ed takov\u00e9to platby nedoch\u00e1z\u00ed ze strany e-shopu k up\u0159esn\u011bn\u00ed objektu \"payer\"<\/code> v po\u017eadavku zalo\u017een\u00ed platby<\/strong>. T\u00edm jsou z\u00e1kazn\u00edkovi pro platbu nab\u00eddnuty ve\u0161ker\u00e9 dostupn\u00e9 platebn\u00ed metody<\/strong>.<\/p>\n

\"gopay<\/p>\n

D\u016fvody, pro\u010d a jak spr\u00e1vn\u011b p\u0159ed\u00e1vat polo\u017eky objedn\u00e1vky<\/h4>\n

U ka\u017ed\u00e9 platby je nutn\u00e9 korektn\u011b p\u0159ed\u00e1vat jednotliv\u00e9 polo\u017eky objedn\u00e1vky<\/strong>, za kter\u00e9 je platba p\u0159es platebn\u00ed br\u00e1nu GoPay prov\u00e1d\u011bna. Tyto \u00fadaje n\u00e1m p\u0159ed\u00e1v\u00e1te u ka\u017ed\u00e9 platby p\u0159es API<\/strong> p\u0159\u00edmo v objektu \u201citems<\/code><\/a>\u201d. Tyto informace jsou n\u00e1sledn\u011b z\u00e1kazn\u00edkovi zobrazeny pro kontrolu p\u0159\u00edmo na platebn\u00ed br\u00e1n\u011b GoPay v z\u00e1lo\u017ece objedn\u00e1vka<\/strong> a d\u00e1le jsou uvedeny v informa\u010dn\u00edm e-mailu se stavem platby<\/a>. Z\u00e1kazn\u00edk tak m\u016f\u017ee prov\u00e9st z\u00e1v\u011bre\u010dnou kontrolu a platbu potvrdit.<\/p>\n

3) Nezapome\u0148te p\u0159ed\u00e1vat e-mail<\/h2>\n

A\u010dkoliv je p\u0159ed\u00e1v\u00e1n\u00ed \u00fadaj\u016f o z\u00e1kazn\u00edkovi (objekt \u201cpayer<\/code><\/a>\u201d) nepovinn\u00e9, doporu\u010dujeme p\u0159ed\u00e1vat alespo\u0148 e-mailovou adresu z\u00e1kazn\u00edka<\/strong>. V p\u0159\u00edpad\u011b, \u017ee n\u00e1m e-mailovou adresu z\u00e1kazn\u00edka p\u0159ed\u00e1te v po\u017eadavku zalo\u017een\u00ed platby, bude p\u0159edvypln\u011bna na platebn\u00ed br\u00e1n\u011b GoPay. E-mailov\u00e1 adresa je toti\u017e povinn\u00fd \u00fadaj pro dokon\u010den\u00ed platby a pokud n\u00e1m jej v po\u017eadavku zalo\u017een\u00ed platby nep\u0159ed\u00e1te, z\u00e1kazn\u00edk bude tento \u00fadaj muset zadat ru\u010dn\u011b na platebn\u00ed br\u00e1n\u011b GoPay. Pokud e-mailovou adresu zad\u00e1val u\u017e na va\u0161em e-shopu, je to pro n\u011bj zbyte\u010dn\u00fd krok, kter\u00e9mu se d\u00e1 snadno p\u0159edej\u00edt.<\/p>\n

4) P\u0159ed\u00e1v\u00e1n\u00ed jazyka z\u00e1kazn\u00edka na platebn\u00ed br\u00e1nu<\/h2>\n

Jazykov\u00e1 lokalizace prost\u0159ed\u00ed je d\u016fle\u017eit\u00e1 pro v\u0161echny z\u00e1kazn\u00edky, dbejte tedy pros\u00edm na to, aby se z\u00e1kazn\u00edkovi na platebn\u00ed br\u00e1n\u011b GoPay v\u017edy zobrazil jazyk, u kter\u00e9ho je nejv\u011bt\u0161\u00ed pravd\u011bpodobnost, \u017ee mu bude rozum\u011bt.<\/p>\n

Logika jazyka platebn\u00ed br\u00e1ny GoPay je n\u00e1sledovn\u00e1:<\/p>\n