Platba SMS#
Brána Mobilní platby přijímá prémiové SMS přes agregátora mobilniplatby.cz. Umí dvě cesty a obě obsluhuje jedna adresa:
| Cesta | Jak to probíhá | Text SMS |
|---|---|---|
| Formulářová | zákazník vybere tarif v platebním formuláři, platba vznikne hned a SMS na ni odkazuje kódem | KLÍČOVÉ_SLOVO kód |
| Expresní | zákazník rovnou pošle SMS z nabídky u inzerátu, platba vznikne až z přijaté SMS | KLÍČOVÉ_SLOVO MODUL SLUŽBA ID |
Jak to vypadá ze strany zákazníka, popisuje Platba SMS v manuálu pro návštěvníky.
Jak systém rozhodne, co zákazník zaplatil#
- Agregátor pošle přijatou SMS na adresu Příjem SMS. Adresa nese sdílené tajemství; požadavek bez něj se odmítne a nic se nezaloží.
- První slovo musí být klíčové slovo brány, druhé určí modul, třetí službu, poslední objekt (inzerát, firmu, příspěvek, uživatele).
- Modul ověří, že služba existuje a objekt je aktivní.
- Cenu určuje číslo, na které SMS přišla, nikdy text. Cena čísla se musí přesně rovnat ceně služby ve stejné měně, jinak se služba neaktivuje.
- Vznikne platba, položka služby a účetní snapshot; pak běží stejné zpracování jako u platby z formuláře — aktivace služby, notifikace, doklad.
- Zákazník dostane odpověď SMS: potvrzení, nebo důvod a kód reklamace.
Agregátor posílá tutéž SMS opakovaně (až dvanáctkrát), dokud nedostane odpověď. Opakování pozná systém podle identifikátoru SMS a vrátí původní odpověď — služba se zaplatí jednou.
Moduly a služby#
| Modul v SMS | Co se platí | Odkud se berou služby a ceny |
|---|---|---|
INZ |
topování, zvýraznění, topbox inzerátu | rychlé ceny tarifů v inzerci |
FIRMA |
služby firmy v katalogu | rychlé ceny tarifů v katalogu firem |
DISK |
zvýraznění příspěvku | rychlé ceny tarifů v diskuzi |
UCET |
CLEN = členství, KREDIT = kredit |
ceny tarifů členství pro bránu Mobilní platby |
Služba (třetí slovo SMS) je u inzerce, firem a diskuze poslední slovo klíčového
slova rychlé ceny. Rychlá cena s klíčovým slovem TOP i XHIFILAB INZ TOP dává službu
TOP.
U členství je služba pevná: CLEN patří tarifům s dobou platnosti, KREDIT tarifům
s kreditem. Balíček s oběma (doba i kredit) je pod oběma slovy; který tarif se koupí,
určí cena prémiového čísla. Objektem je číslo uživatele — platbu i položku dostane ten
uživatel, jehož číslo je v textu. Uživatel musí mít aktivovaný účet, který není zablokovaný, zrušený ani čekající na zrušení.
Prémiová čísla a cenové hladiny#
Každá cena má u agregátora vlastní číslo. Čísla a hladiny se zakládají při zprovoznění brány podle smlouvy s agregátorem. Rozlišují se dva druhy:
| Druh | Kdy se strhnou peníze | Stav platby po přijetí SMS |
|---|---|---|
| MO (jednorázová čísla, hladina 0) | při odeslání SMS | Zaplacená hned |
| MT (hladina u odpovědi) | při doručení odpovědi | Čeká na zaplacení, dokončí ji doručenka |
U MT čísla se do odpovědi připisuje hladina; když se služba aktivovat nedá, odpoví
systém hladinou FREE a zákazníkovi se nic neúčtuje.
Postup: zprovoznit platbu SMS#
- Otevřete Systém → Platební brány a bránu Mobilní platby v editaci.
- Do pole Konfigurace zapište klíčové slovo a sdílené tajemství:
keyword[SLOVO],delivery_secret[dlouhy-nahodny-retezec]. Klíčové slovo je první slovo SMS, které máte u agregátora registrované. Volitelně přidejtedelivery_ips[…]— seznam adres, ze kterých agregátor volá. - Zkontrolujte, že je zapnuté Konečné ceny a Aktivní, a uložte.
- V sekci Integrační adresy se teď zobrazí dvě adresy. Zkopírujte je do portálu agregátora:
- Příjem SMS (expresní i formulářové) — adresa pro příjem SMS (MO),
- Notifikace o doručení SMS (delivery report) — adresa pro doručenky.
- U tarifů, které se mají dát zaplatit SMS, nastavte rychlou cenu pro každý region (u členství cenu tarifu pro bránu Mobilní platby):
- Aktivní zaškrtnuté,
- Klíčové slovo končí slovem služby (
TOP,ZVYRAZNENI…), - Cena konečná, včetně DPH — přesně hladina, za kterou máte číslo,
- Měna,
- Telefon vyplněný (bez něj se nabídka u inzerátu nezobrazí; číslo pro SMS si systém bere z čísel brány podle ceny).
- Vraťte se do editace brány a projděte sekci Expresní služby.
- Pošlete zkušební SMS a ověřte platbu v Systém → Platby.
Přehled Expresní služby#
V editaci brány Mobilní platby je sekce Expresní služby (platba jednou SMS). Seznam se skládá sám z tarifů — službu přidáte nebo změníte v tarifu, ne tady.
| Sloupec | Význam |
|---|---|
| Modul, Služba | druhé a třetí slovo SMS |
| Tarif | tarif, který se po zaplacení aktivuje |
| Cena, Platební region | rychlá cena (cena tarifu) a region, pro který platí |
| Číslo | číslo brány přesně za tuto cenu; u MT čísla i hladina |
| Příklad SMS | text pro objekt číslo 123 |
| Stav | aktivní, nebo chybí číslo za tuto cenu |
Chybí číslo za tuto cenu znamená, že brána nemá číslo přesně za cenu služby. Taková služba se na webu nenabízí a SMS by ji neaktivovala. Upravte cenu služby na hladinu, pro kterou číslo máte, nebo si u agregátora doplňte číslo pro tuto hladinu.
Reklamace podle kódu#
Každá SMS, která službu neaktivovala, založí platbu ve stavu Selhala. Číslo platby je kód reklamace, který zákazník dostal v odpovědi.
Postup: vyřídit reklamaci#
- V Systém → Platby najděte platbu podle kódu (číslo platby).
- V popisu platby je důvod:
Expresní SMS neaktivována: <důvod>. Když SMS mířila na existující službu, je v závorce i tarif a objekt (Topování, inzerat 956). - Podle důvodu rozhodněte:
| Důvod | Co se stalo | Řešení |
|---|---|---|
priceMismatch |
SMS přišla na číslo s jinou cenou | doplatek nebo aktivace podle skutečně zaplacené částky |
objectNotFound, objectInactive |
objekt neexistuje / není schválený, je vypnutý | po schválení aktivujte ručně, nebo vraťte |
keywordMismatch, malformed |
text nedává smysl nebo začíná cizím klíčovým slovem | dohledejte se zákazníkem, co chtěl zaplatit |
unknownModule, unknownService |
neexistující modul nebo služba | jako výše |
unknownPaymentCode |
formulářová SMS s kódem, ke kterému není platba | zkontrolujte kód z formuláře |
- Službu aktivujte ručně u objektu (záložka Platby u inzerátu, příspěvku nebo Platby uživatelů), nebo zákazníkovi peníze vraťte.
Neúspěšná SMS na MT číslo se zákazníkovi neúčtuje (odpověď nesla FREE); reklamace
u ní obvykle není potřeba.