Platba na míru - csob/platebnibrana GitHub Wiki

Platba na míru umožňuje zaplatit na platební bráně i takové nákupy, při kterých zákazník neprochází typickým procesem nákupu na e-shopu. Obchodník platbu založí na platební bráně, získá platební odkaz, který pak doručí zákazníkovi tím způsobem, který je aktuálně nejlepší - e-mailem, smskou nebo jako QR kód vytištěný na faktuře. Po otevření platebního linku může zákazník zaplatit všemi platebními metodami, které má obchodník na platební bráně aktivní.

Platba na míru je na platební bráně ČSOB dostupná od verze eAPI 1.8, které přidává právě podporu zakládání plateb a získávání platebních linků.

Kdy je vhodné Platbu na míru použít?

Fantazii a obchodním potřebám se samozřejmě meze nekladou. Toto je jen pár příkladů situací, kdy se vám může Platba na míru hodit:

při vystavování faktur nebo zálohových faktur
pokud je potřeba zaplatit při obsluze klienta na call centru
pokud potřebujete od klienta přijmout platbu za dodatečnou změnu objednávky, která způsobila vyšší cenu

A pak je tu ještě jeden případ: když žádný e-shop nemáte a nechcete ani implementovat eAPI platební brány do vašich interních systémů (např. pro obsluhu klientů na call centru). Platbu na míru si můžete založit i "ručně" v administračním systému ČSOB POS Merchant. Výsledkem bude opět platební link, pomocí kterého váš klient zaplatí – a vůbec nepozná, že platba byla zadána ručně.

Jak Platba na míru funguje pro můj e-shop / systém?

Když víte, kolik má klient zaplatit, založíte na platební bráně transakci. Kromě údajů, které na bránu posíláte při "běžných" platbách (částka, vaše číslo objednávky pro párování, údaje pro zobrazení v košíku atd.), můžete nastavit i platnost Platby na míru, která je maximálně 60 dnů. Po uplynutí této doby již platební link nebude aktivní. Z brány získáte platební odkaz (v eAPI customerCode), který identifikuje platbu pro vašeho zákazníka. Kód je šestimístný a obsahuje jak číslice, tak písmena. Tím komunikace s bránou končí a nyní musíte k zákazníkovi dopravit platební link v podobě:

https://platebnibrana.csob.cz/zaplat/{customerCode}

Způsob doručení nijak neomezujeme a záleží na vašem použití Platby na míru, zda kód pošlete e-mailem, SMS, umístíte na fakturu a zda jej pošlete jako odkaz nebo například QR kód.

Když zákazník otevře platební link, zobrazí se mu platební brána ve stejné podobě, jako kdyby se přesměroval z e-shopu. Může použít všechny platební metody (tj. může si přímo na bráně vybrat mezi kartou a platebními tlačítky). Po dokončení platby je zákazník přesměrován do e-shopu, který se tak dozví o výsledku platby. Platební link je aktivní až do doby uplynutí jeho platnosti (max. 60 dnů, viz výše - nastavení při zakládání platby) nebo uhrazení platby – podle toho, co nastane dříve. Pokud si zákazník otevře platební link "jen tak", nebo je platba zamítnuta, je platební link nadále platný a zákazník se k platbě může vrátit až do doby uplynutí platnosti platebního linku.

Založíte-li Platbu na míru ručně v aplikaci ČSOB POS Merchant, můžete si zvolit i možnost platby bez návratu do e-shopu. Tato volba je vhodná pro případ, že nemáte žádný systém integrovaný s platební bránou a zákazník se tak nemá kam "vrátit". Zaplacené transakce si pak musíte ručně kontrolovat v ČSOB POS Merchant.

Ověření Platby na míru

V momentě otevření platebního linku zákazníkem proběhne ověření stejně jako u běžné platby na bráně. Při zakládání Platby na míru je nutné platební bráně poskytnout stejná dodatečná data o nákupu jako v případě běžné platby na bráně.

Jak můžeme Platbu na míru implementovat?

Platba na míru nevyžaduje žádné nové API metody. Obsluhuje se pouze rozšířenými parametry metody payment/init. Kód pro předání zákazníkovi obdržíte jako součást odpovědi na volání payment/init.

Co ještě vědět o Platbě na míru?

Jaké jsou poplatky?

Stejné jako u platby při přesměrování zákazníka z e-shopu. Platba na míru není nijak zvlášť zpoplatněna.

Jak Platbu na míru získám?

Možnost provádět Platby na míru aktivujeme na vaši žádost. Kontaktujte prosím [email protected].