Kā pieslēgt Prodamus

Lai pieslēgtu Prodamus, jums ir nepieciešams maksājuma formas URL un slepenā atslēga.

Maksājuma formas URL tiek sniegts pēc reģistrācijas. Piemērs:

demo.payform.ru

Slepeno atslēgu var iegūt savā Prodamus kontā. Jums arī jānorāda URL, uz kuru tiks nosūtīti maksājuma paziņojumi.

Detalizēti norādījumi, kā to konfigurēt

Paziņojumu URL:
https://chatter.mavibot.ai/prodamus_callback/result

Šis URL ir jānorāda divās iestatījumu vietās.

Galvenajā iestatījumu lapā varat izvēlēties maksājuma formas darbības režīmu:

  • Demo režīms bez reāliem maksājumiem
  • Tiešraides režīms maksājumu pieņemšanai

Paziņojumu URL ir jānorāda divās maksājumu sistēmas iestatījumu sadaļās:

  • Cilnē Formas iestatījumi vienreizējiem maksājumiem
  • Cilnē Abonementi abonēšanas maksājumiem

Paziņojumu URL:
https://chatter.mavibot.ai/prodamus_callback/result

Lai konfigurētu abonēšanas maksājumus, atveriet cilni Abonementi un ievadiet paziņojumu URL:

https://chatter.mavibot.ai/prodamus_callback/result

Svarīgi: Pēc URL ievadīšanas noteikti noklikšķiniet uz Saglabāt.

Lai pieslēgtu Prodamus Mavibot, atveriet sadaļu Norēķini.

Pēc tam ievadiet maksājuma formas URL un slepeno atslēgu attiecīgajos laukos.

Svarīgi: Neiekļaujiet https://, ievadot maksājuma formas URL.

Savienojums tagad ir pabeigts. Tālāk apskatīsim, kā izmantot šo funkcionalitāti.

Maksājuma saites izveide

Maksājuma poga

Maksājuma saiti var ģenerēt, izmantojot pogu ar funkciju Maksājums.

Skatiet ceļvedi par maksājuma pogas izveidi:
/docs/chatbot-builder-buttons-payment-button

Tālāk esošajās sadaļās ir aprakstīti visi pieejamie pogas iestatījumi.

Nepieciešamie parametri

Lai ģenerētu maksājuma saiti, ir nepieciešami šādi lauki:

  • Summa
  • Produkta nosaukums
  • Produkti čekam (nepieciešams tikai tad, ja jums nav sava tiešsaistes kases aparāta un vēlaties, lai Prodamus ģenerē fiskālos čekus)

Kad klients atver maksājuma lapu, produkta informācija un cena jau ir aizpildīti. Klientam tikai jāievada savi kontaktinformācijas dati.

Ja klienta e-pasts un/vai tālruņa numurs ir norādīti pogas iestatījumos, tie arī tiks iepriekš aizpildīti maksājuma lapā.

Pogu iestatījumi

Teksts – Teksts, kas tiek parādīts uz maksājuma pogas.

Funkcija – Izvēlieties Maksājums, lai ģenerētu maksājuma saiti.

Maksājumu sistēma – Parāda projektam pieslēgtās maksājumu sistēmas.

Ja nav pieslēgta neviena maksājumu sistēma, šis pogas veids nav pieejams.

Produkta nosaukums (obligāts) – Norādiet precīzu produkta nosaukumu.

Piemēram, tā vietā:

Tālrunis

izmantojiet:

Xiaomi viedtālrunis, modelis ...

Piezīme: Produkta nosaukumā nav atļautas dubultās pēdiņas ("). Noņemiet tās vai aizstājiet ar vienkāršajām pēdiņām.

Summa (obligāts) – Maksājuma summa.

Papildu parametri

Noklikšķiniet uz Papildu informācija, lai konfigurētu neobligātos laukus:

  • Pasūtījuma apraksts
  • Atlaide (RUB)
  • Klienta e-pasta mainīgais
  • Klienta tālruņa mainīgais
  • Saites derīguma termiņš
  • Abonementa produkta ID
  • Produkti čekam

Paziņot par klikšķi – Iespējojiet šo opciju, ja vēlaties saņemt paziņojumu klienta sarunā, kad viņš noklikšķina uz maksājuma pogas.

Šo paziņojumu var izmantot, lai veidotu papildu tērzēšanas robota loģiku.

Daudzi maksājumu pakalpojumu sniedzēji atbalsta mākoņa kases aparātus, kas nepieciešami nodokļu atbilstībai. Pārbaudiet sava maksājumu pakalpojumu sniedzēja dokumentāciju, lai iegūtu informāciju par čeku ģenerēšanu un fiskalizāciju.

Maksājuma lapa, ko atver poga, izskatās šādi:

Papildu maksājuma saites iestatījumi

Pasūtījuma apraksts – Šajā laukā ievadītais teksts tiek parādīts maksājuma lapā sadaļā Papildu informācija.

Atlaide – Norādiet atlaides summu RUB. Tiek atbalstītas decimāldaļas, izmantojot punktu kā atdalītāju (piemēram, 50.99).

Maksājuma lapā atlaide tiek piemērota automātiski. Sākotnējā cena tiek pārsvītrota, un atlaides summa tiek parādīta kā kopējais maksājums.

Klienta e-pasta mainīgais (obligāts, ja nav norādīts tālruņa numurs) – Klienta e-pasta adrese vai mainīgais, kas to satur, piemēram:

#{email}

Klienta tālruņa mainīgais (obligāts, ja nav norādīta e-pasta adrese) – Mainīgais, kas satur klienta tālruņa numuru formātā:

79000000000

Piemēram:

#{phone}

Jānorāda vai nu e-pasta adrese, vai tālruņa numurs.

Saites derīguma termiņš – Norādiet derīguma termiņu formātā:

dd.MM.yyyy HH:mm

Piemērs:

25.01.2021 11:00

Varat arī izmantot mainīgo, piemēram:

#{link_expired}

Abonementa produkta ID – Ievadiet abonementa produkta ID, lai izveidotu atkārtotu maksājumu.

Informāciju par abonementa produktu izveidi skatiet Prodamus dokumentācijā.

Ja ir norādīts abonementa produkta ID:

  • maksājuma summa tiek ignorēta;
  • produkta informācija tiek ielādēta no abonementa produkta Prodamus;
  • klienta tālruņa numurs ir nepieciešams abonementa pārvaldībai;
  • atzvanē pēc veiksmīga maksājuma ir ietverts abonementa produkta ID.

Produkti čekam (nosacīti obligāts) – Nepieciešams maksājuma fiskalizācijai, izmantojot Prodamus, ja neizmantojat savu tiešsaistes kases aparātu.

Norādiet produkta aprakstu, cenu un saiti uz iegādāto saturu.

Piemērs:

Kurss "Padziļinātā fotogrāfija", cena 3000 RUB,
https://example.com/course

Saites derīguma termiņa darbība

Ja norādāt saites derīguma termiņu, maksājuma poga darbojas atšķirīgi atkarībā no tā, vai saite vēl ir derīga.

Beidzies saites derīguma termiņš

Ja klients atver maksājuma saiti pēc tās derīguma termiņa beigām, maksājumu nevar pabeigt, un viņš redzēs šādu ziņojumu:

Piezīme: Derīguma termiņam jābūt vēlākam par pašreizējo datumu. Pretējā gadījumā klients nevarēs pabeigt maksājumu.

Neaktīva maksājuma poga

Ja klients pieprasa maksājuma pogu pēc tam, kad saites derīguma termiņš jau ir beidzies, poga netiek parādīta.

Tā vietā tiek izveidots šāds klienta mainīgais:

error_payment_button

Vērtība:

Kļūda: Saites derīguma termiņam jābūt vēlākam par pašreizējo datumu.

Mēs iesakām apstrādāt šo situāciju sava tērzēšanas robota plūsmā.

Izveidojiet nosacījumu, kas pārbauda:

error_payment_button == "Kļūda: Saites derīguma termiņam jābūt vēlākam par pašreizējo datumu."

Ja nosacījums ir izpildīts, nosūtiet ziņojumu, piemēram:

Atvainojiet, jūs nevarējāt veikt maksājumu laikā. Maksājuma saite ir beigusies.

Klienta mainīgie, ko izveido maksājuma poga

Kad klients saņem ziņojumu, kas satur Maksājuma pogu, Mavibot automātiski izveido šādus mainīgos.

__payments

Sistēmas mainīgais, kas glabā maksājuma summu un ģenerētās maksājuma saites identifikatoru. To izmanto, lai saskaņotu no maksājumu sistēmas saņemtos atzvanus.

Svarīgi: Nemodificējiet un neizdzēsiet sistēmas mainīgo __payments.

error_payment_button

Šis mainīgais tiek izveidots automātiski, ja, ģenerējot maksājuma pogu, rodas kļūda.

Tas satur vai nu Mavibot ģenerēto kļūdas ziņojumu, vai maksājumu sistēmas atgriezto kļūdu.

Mainīgo vērtības kļūst pieejamas pēc tam, kad tērzēšanas robots pāriet uz nākamo bloku.

Maksājuma rezultātu apstrāde

Veiksmīgs maksājums

Pēc veiksmīga maksājuma Mavibot automātiski saņem šādu atzvanu:

<first_10_characters_of_secret_key>_success <payment_amount>

Piemērs:

ovg58keefc_success 44

Kur:

  • ovg58keefc — pirmās 10 Prodamus slepenās atslēgas rakstzīmes.
  • _success — norāda uz veiksmīgu maksājumu.
  • 44 — maksājuma summa.

Klienti nekad neredz maksājuma atzvanus. Tie ir redzami tikai sadaļā Klienti, un tos var izmantot, lai veidotu tērzēšanas robota loģiku.

Piemērs

1. solis

Izveidojiet bloku, kas satur Maksājuma pogu.

2. solis

Izveidojiet Trigera bloku vai konfigurējiet bultiņu, kas ved uz nākamo bloku.

Ielīmējiet maksājuma atzvanu trigerī vai saskaņošanas nosacījumā.

To pašu atzvanu var konfigurēt arī blokā Sākotnējais nosacījums, ja jūsu tērzēšanas robotam nepieciešama globāla maksājumu apstrāde.

Svarīgi: Izmantojiet vai nu Precīza atbilstība, vai Satur atslēgvārdus kā saskaņošanas veidu.

Piezīme: Ja apstrādājat atzvanus uz konkrētas bultiņas, pārliecinieties, ka klients joprojām atrodas blokā, kas satur šo bultiņu, kad atzvans ierodas. Pretējā gadījumā pāreja nenotiks. Tērzēšanas robota plūsmām, kurās klienti var pārvietoties starp blokiem, ieteicams apstrādāt atzvanus blokā Sākotnējais nosacījums.

Veiksmīgs abonementa maksājums

Abonementa produktiem atzvana formāts ir:

<first_10_characters_of_secret_key>_success <subscription_product_id>

Piemērs:

214009eefc_success 618117

Kur:

  • 214009eefc — pirmās 10 slepenās atslēgas rakstzīmes.
  • _success — veiksmīgs maksājums.
  • 618117 — abonementa produkta ID.

Neveiksmīgs maksājums

Ja maksājums neizdodas, Mavibot saņem šādu atzvanu:

<first_10_characters_of_secret_key>_fail <payment_amount>

Piemērs:

ovg58keefc_fail 44

Kur:

  • ovg58keefc — pirmās 10 slepenās atslēgas rakstzīmes.
  • _fail — maksājums neizdevās.
  • 44 — maksājuma summa.

Piezīme: Ne visi maksājumu pakalpojumu sniedzēji sūta atzvanus par neveiksmīgiem maksājumiem.

Maksājuma summas neatbilstība

Ja samaksātā summa atšķiras no maksājuma pogā norādītās summas, Mavibot saņem šādu atzvanu:

<first_10_characters_of_secret_key>_different_amounts <payment_id>

Piemērs:

ovg58keefc_different_amounts 123456

Kur:

  • ovg58keefc — pirmās 10 slepenās atslēgas rakstzīmes.
  • _different_amounts — norāda, ka samaksātā summa atšķiras no paredzētās summas.
  • 123456 — unikālais maksājuma ID.

get_prodamus_payment_url Kalkulatora funkcija

Varat ģenerēt maksājuma saiti, izmantojot funkciju get_prodamus_payment_url blokā Kalkulators.

Piešķiriet funkcijas rezultātu jebkuram mainīgajam.

Varat izvēlēties jebkuru mainīgā nosaukumu. Tālāk esošajos ekrānuzņēmumos tiek izmantoti piemēru mainīgo nosaukumi.

Ģenerētā maksājuma saite tiek saglabāta mainīgajā, un to var izmantot ziņojumā vai pievienot pogai.

Maksājuma saites piemērs:

https://payform.ru/7p3JR8/

Piemērs

Funkcijas sintakse

your_variable = get_prodamus_payment_url(
    amount,
    product_name,
    expired,
    customer_phone,
    customer_email,
    discount,
    description,
    extra_params,
    products_for_receipt
)

Parametri

Parametrs Apraksts
amount Obligāts. Maksājuma summa. Pieņem veselus skaitļus vai decimālvērtības (piemēram, 25 vai 52.5).
product_name Obligāts. Produkta nosaukums.
expired Maksājuma saites derīguma termiņš. Atbalstītie formāti: dd.MM.yyyy vai dd.MM.yyyy HH:mm. Varat izmantot arī mainīgos vai izteiksmes, piemēram, current_date + 2. Izlaidiet šo parametru, norādot '', "" vai None.
customer_phone Klienta tālruņa numurs. Nav obligāts, ja ir norādīts customer_email. Izlaidiet, norādot '' vai "".
customer_email Klienta e-pasta adrese. Nav obligāta, ja ir norādīts customer_phone. Izlaidiet, norādot '' vai "".
discount Atlaides summa. Pieņem veselus skaitļus vai decimālvērtības (piemēram, 25 vai 63.5). Izlaidiet, norādot '' vai "".
description Produkta apraksts. Ja nav norādīts, Prodamus automātiski izmanto Payment for order order_id. Izlaidiet, norādot '' vai "".
extra_params Papildu Prodamus API parametri, kas nav iekļauti funkcijas argumentos. Izlaidiet, norādot '', "" vai None.
products_for_receipt Čeka dati formātā "product description - price - purchased content URL". Obligāti, ja izmantojat Prodamus fiskalizāciju bez sava tiešsaistes kases aparāta.

Derīguma termiņa piemēri

Derīgums pēc divām dienām:

expired = current_date + 2

Derīgums pēc 30 minūtēm:

time = current_time + 30
expired = "#{current_date} #{time}"

Piemērs extra_params 

extra_params = {
    "payments_limit": "3",
    "payment_method": "vsegdada_installment_0_0_6"
}

Pilnu atbalstīto parametru sarakstu skatiet Prodamus REST API dokumentācijā.

Piemērs

extra_params = {
    "payments_limit": "3"
}

products_for_receipt = "Photography Course, price 4999 RUB, https://example.com/course"

payment_link = get_prodamus_payment_url(4999, "Photography Course", "27.03.2023 17:00", "79167777771", "[email protected]", 20, "The best photography course", extra_params, products_for_receipt)

Šajā piemērā:

  • extra_params satur papildu maksājuma parametrus.
  • products_for_receipt satur fiskālā čeka informāciju.
  • payment_link glabā ģenerēto maksājuma saiti.

Ja vienā Calculator blokā tiek izmantotas vairākas maksājuma saites funkcijas un viena no tām neizdodas, kļūda tiek ierakstīta mainīgajā error_payment_func. Tiek saglabāta tikai pēdējās funkcijas kļūda.

Maksājuma saites ģenerēšana, izmantojot payment_sum

Piezīme: payment_sum vērtība tiek piemērota pēc visiem neobligātajiem mainīgajiem, piemēram, payment_description, product_name un citiem.

Tā vietā, lai izsauktu get_prodamus_payment_url(), maksājuma saiti var ģenerēt, vienkārši piešķirot vērtību mainīgajam payment_sum Calculator blokā.

Pēc payment_sum piešķiršanas Mavibot automātiski izveido mainīgo prodamus_pay_url, kas satur maksājuma saiti.

Piemērs:

https://payform.ru/7p3JR8/

Šo mainīgo varat parādīt ziņojumā vai izmantot kā pogas URL.

Neobligātie mainīgie

Sekojošos mainīgos var definēt pirms payment_sum piešķiršanas.

Mainīgais Apraksts
product_name Produkta nosaukums. Ja nav norādīts, noklusējuma vērtība ir Payment for order order_id.
payment_description Produkta apraksts, kas tiek rādīts maksājuma lapā.
discount_value Atlaides summa. Piemērs: 25 vai 50.25.
customer_phone Klienta tālruņa numurs.
customer_email Klienta e-pasta adrese.
link_expired Maksājuma saites derīguma termiņš.
currency Maksājuma valūta. Atbalstītās vērtības: rub, usd, eur, kzt. Jābūt mazajiem burtiem.
payment_title Maksājuma nosaukums (līdz 127 rakstzīmēm). Noklusējuma vērtība ir Payment payment_id.
locale Maksājuma lapas valoda (piemēram, ru-RU, en-US, fr-FR).
products_for_receipt Čeka informācija. Obligāti, ja izmantojat Prodamus fiskalizāciju bez sava tiešsaistes kases aparāta.
payment_sum Obligāts. Maksājuma summa.

Saites derīguma termiņš

Derīguma termiņu var norādīt vairākos veidos.

Konkrēts datums:

25.01.2021

Konkrēts datums un laiks:

25.01.2021 12:23

Izmantojot mainīgos:

time = current_time + 30
link_expired = "#{current_date} #{time}"

Vai:

link_expired = current_date + 2

Piemērs

Vispirms iestatiet maksājuma summu.

Pēc tam izmantojiet ģenerēto mainīgo prodamus_pay_url tur, kur nepieciešams nosūtīt maksājuma saiti.

Pieejamās maksājumu metodes

Mainīgais prodamus_available_payment_methods ir jādefinē pirms payment_sum.

Atbalstītās vērtības:

Vērtība Apraksts
AC Krievijas banku kartes
ACkz Kazahstānas banku kartes
ACf NVS valstu banku kartes (izņemot Krieviju)
ACEURNMBX EUR kartes (izņemot Krieviju un Baltkrieviju)
SBP Ātro maksājumu sistēma (Krievija)
QW QIWI maks
PC YooMoney
GP Maksājumu terminālis
sbol Sberbank Online
invoice Rēķina apmaksa
installment Prodamus nomaksa
credit T-Bank kredīts
monetaworld Starptautiskās kartes (izņemot Krieviju)

Vairākas maksājumu metodes var norādīt, atdalot tās ar vertikālo svītru (|).

Piemērs:

prodamus_available_payment_methods = "AC|PC|QW"

Valūta

Maksājuma valūtu var norādīt, izmantojot mainīgo prodamus_currency.

Atbalstītās vērtības:

  • kzt
  • usd
  • eur

Ģenerētajā maksājuma lapā summa tiks rādīta izvēlētajā valūtā.

Apstrādājot payment_callback atzvanu, pievērsiet uzmanību šādiem laukiem:

  • currency
  • currency_sum

Tie satur maksājuma valūtu un samaksāto summu.

Ja nav norādītas maksājumu metodes, maksājuma lapā netiks rādītas pieejamās maksājumu metodes. Vispirms iespējojiet nepieciešamās maksājumu metodes savā Prodamus kontā.

Maksājuma rezultātu apstrāde

Maksājuma atzvanīšana

Pēc veiksmīga vai neveiksmīga maksājuma Mavibot saņem atzvanus, kurus var izmantot, lai noteiktu maksājuma statusu.

Atzvani sarunā parādās kā sistēmas ziņojumi. Klienti nekad neredz un nesūta šos ziņojumus.

Piemēri:

Veiksmīgs maksājums:

453e8fba8b7cef9ce58dc6e18e25b39ad5a05748175a3f205f2b084acbfc3b66_success

Neveiksmīgs maksājums:

453e8fba8b7cef9ce58dc6e18e25b39ad5a05748175a3f205f2b084acbfc3b66_fail

Pēc veiksmīga maksājuma automātiski tiek izveidots šāds klienta mainīgais:

prodamus_payment_completed = True

Piezīme: Atzvani tiek saņemti ar nelielu aizkavi. Pēc maksājuma saites nosūtīšanas ieteicams informēt klientu, ka maksājuma apstiprināšana var aizņemt dažus mirkļus.

Piemēra ziņojums:

Pēc maksājuma pabeigšanas, lūdzu, uzgaidiet maksājuma apstiprinājumu.

Atzvanīšanas formāts

Maksājuma saites, kas ģenerētas, izmantojot Maksājuma pogu vai get_prodamus_payment_url() funkciju, pēc veiksmīga maksājuma atgriež šādu atzvanu:

<secret_key>_success

Piemērs:

ovg58keefc_success

Kur:

  • <secret_key> ir jūsu Prodamus slepenā atslēga.
  • _success norāda uz veiksmīgu maksājumu.

Piemērs

Izveidojiet trigeri vai nosacījumu bloku, kas gaida atzvanu un pēc tam turpina tērzēšanas robota plūsmu.

Svarīgi: Izmantojiet Precīza atbilstība kā atbilstības veidu.

Ja pēc veiksmīga maksājuma vēlaties ģenerēt citu maksājuma saiti, vispirms atiestatiet esošo maksājuma informāciju.

Iestatiet:

payment_sum = 0

Pēc tam piešķiriet jaunu vērtību payment_sum, lai ģenerētu jaunu maksājuma saiti.

Abonementa atzvanīšana

Prodamus sūta arī atzvanus, kas saistīti ar abonementa statusu.

Piemēri:

  • Abonements atcelts klienta dēļ
  • Abonements atkārtoti aktivizēts klienta dēļ
  • Abonements deaktivizēts pēc vairākiem neveiksmīgiem maksājuma mēģinājumiem

Abonements atcelts

Tiek nosūtīts, kad klients manuāli atceļ savu abonementu.

Pašreizējais apmaksātais norēķinu periods var joprojām būt aktīvs.

Šo atzvanu varat izmantot, lai:

  • ignorētu notikumu;
  • paziņotu savai komandai;
  • nosūtītu klientam noturēšanas ziņojumu.

Abonements atkārtoti aktivizēts

Tiek nosūtīts, kad klients atjauno iepriekš atceltu abonementu.

Atkarībā no jūsu biznesa loģikas varat ignorēt šo atzvanu vai noņemt klientu no noturēšanas darbplūsmas.

Abonements deaktivizēts

Tiek nosūtīts pēc vairākiem neveiksmīgiem atkārtotu maksājumu mēģinājumiem.

Atzvanīšanas datu saglabāšana

Pēc veiksmīga maksājuma pilns atzvanīšanas saturs tiek saglabāts šādā mainīgajā:

payment_callback

Tas satur visu Prodamus atgriezto maksājuma informāciju.

Piemērs:

{
  "date": "2021-03-30T11:44:43+03:00",
  "order_id": "757679",
  "sum": "14.50",
  "customer_phone": "+77777777777",
  "customer_extra": "Product",
  "payment_status": "success"
}

Ja, ģenerējot maksājuma saiti, norādījāt product_name un payment_description, varat tos iegūt no atzvanīšanas.

Piemērs:

product = get(payment_callback, "products[0][name]")
description = get(payment_callback, "customer_extra")

Iegūstiet maksājuma summu:

amount = get(payment_callback, "sum")

Piezīme: payment_sum vērtība vienmēr tiek piešķirta pēc neobligātajiem mainīgajiem, piemēram, payment_description un product_name.

Pieejamās atzvanīšanas

Papildus veiksmīga maksājuma atzvanīšanai Prodamus sūta dažādas sistēmas atzvanīšanas, kuras var izmantot, lai automatizētu savu tērzēšanas robotu.

Abonementa notikumi

  • Abonements atcelts klienta dēļ
  • Abonements atkārtoti aktivizēts klienta dēļ
  • Abonements beidzies

Maksājuma neveiksmes notikumi

Atkarībā no maksājumu pakalpojumu sniedzēja varat saņemt atzvanīšanas ar neveiksmes iemeslu, piemēram:

  • Maksājums neizdevās – Nepietiekami līdzekļi
  • Maksājums neizdevās – Kartes derīguma termiņš beidzies
  • Maksājums neizdevās – Kartes limits pārsniegts
  • Maksājums neizdevās – Kartes nozaudēšana
  • Maksājums neizdevās – Sistēmas kļūda
  • Maksājums neizdevās – Darījums noraidīts izdevējbankā
  • Maksājums neizdevās – Darījums noraidīts bankā

Citi notikumi

  • Paziņojums par gaidāmo atkārtoto maksājumu
  • Nomaksas pieteikums apstiprināts
  • Nomaksas pieteikums atcelts
  • Nomaksas pieteikums noraidīts

Varat izveidot tērzēšanas robota plūsmas, kas reaģē uz jebkuru no šīm atzvanīšanām.

Piemēram, varat automātiski paziņot klientiem, kad atkārtotais maksājums neizdodas.

Lai apstrādātu konkrētu neveiksmes iemeslu, izveidojiet trigeri, kas atbilst attiecīgajai atzvanīšanai.

Lai apstrādātu visus neveiksmīgos maksājumus neatkarīgi no iemesla, izmantojiet nosacījumu, kas pārbauda, vai atzvanīšana satur:

Payment failed

Jebkura atzvanīšana, kas satur tekstu Payment failed, aktivizēs konfigurēto tērzēšanas robota darbību.

Abonementa maksājumi

Abonementa izveide

Pirms sākt pieņemt abonēšanas maksājumus, izveidojiet abonēšanas produktu savā Prodamus kontā.

Detalizētus norādījumus skatiet Prodamus dokumentācijā.

Pēc abonēšanas produkta izveides nokopējiet tā Abonēšanas produkta ID.

Piešķiriet Abonēšanas produkta ID šādam mainīgajam:

prodamus_subscription

Mavibot automātiski ģenerē šādu mainīgo:

prodamus_pay_url

Ģenerēto URL var parādīt ziņojumā vai pievienot pogai.

Piemērs:

https://payform.kz/7p3JR8/

Abonēšanas maksājumi tiek apstrādāti tieši tāpat kā vienreizējie maksājumi.

Pēc veiksmīga abonēšanas maksājuma klienta tālruņa numurs tiek automātiski saglabāts mainīgajā customer_phone.

Ja customer_email nav norādīts, customer_phone ir obligāts abonementa pārvaldībai.

get_prodamus_subscription_url

Varat arī ģenerēt abonēšanas maksājumu saites, izmantojot Kalkulatoru.

Funkcija:

get_prodamus_subscription_url(
    subscription_id,
    product_name,
    expired,
    customer_phone,
    customer_email,
    discount,
    description,
    extra_params,
    products_for_receipt
)

Piemērs

Parametri

Parametrs Apraksts
subscription_id Obligāts. Abonēšanas produkta ID no jūsu Prodamus konta.
product_name Obligāts. Produkta nosaukums.
expired Maksājuma saites derīguma termiņš. Atbalsta dd.MM.yyyy vai dd.MM.yyyy HH:mm. Tiek atbalstīti arī mainīgie.
customer_phone Klienta tālruņa numurs. Neobligāts, ja ir norādīts customer_email.
customer_email Klienta e-pasta adrese. Neobligāts, ja ir norādīts customer_phone.
discount Atlaides summa.
description Produkta apraksts.
extra_params Papildu Prodamus API parametri.
products_for_receipt Čeka informācija. Obligāts, ja izmantojat Prodamus fiskalizāciju bez savas tiešsaistes kases.

Piemērs

extra_params = {
    "payments_limit": "3"
}

products_for_receipt = "Fotogrāfijas kursa abonements, 2000 RUB/mēn, https://example.com/course"

subscription_link = get_prodamus_subscription_url(618988, "Fotogrāfijas kurss", "27.03.2023 17:02", "79167777771", "[email protected]", 20, "Premium abonements", extra_params, products_for_receipt)

Ja vienā Kalkulatora blokā tiek izpildītas vairākas maksājumu saišu funkcijas un viena no tām neizdodas, kļūda tiek saglabāta mainīgajā error_payment_func.

Abonementa statusa pārvaldība

Abonementa pārvaldība ir pieejama tikai aktīviem abonementiem. Tā netiek atbalstīta demonstrācijas režīmā, jo nav piesaistīta maksājumu karte.

Lai pārvaldītu abonementu, ir jābūt pieejamam vismaz vienam no šiem parametriem:

  • customer_phone
  • customer_email

Lai atceltu vai atkārtoti aktivizētu abonementu, izmantojiet šādu funkciju:

delete_subscription_prodamus

Parametru piemērs:

{
  "customer_phone": "#{customer_phone}",
  "id_subscription": "#{prodamus_subscription}",
  "url": "https://demo.payform.ru/",
  "secret_key": "453e8fba8b7cef9ce58dc6e18e25b39ad5a05748175a3f205f2b084acbfc3b66",
  "switcher": "0",
  "profile_id": "12345"
}

Parametri

Parametrs Apraksts
url Maksājuma veidlapas URL, kas konfigurēts Mavibot.
secret_key Jūsu Prodamus slepenā atslēga.
id_subscription Abonēšanas produkta ID.
customer_phone Abonenta tālruņa numurs.
switcher Abonementa darbība: 0 – deaktivizēt, 1 – atkārtoti aktivizēt.
profile_id Klienta profila ID Prodamus.

Ja Prodamus atgriež profila ID, tas tiek automātiski saglabāts mainīgajā profile_id. Šo mainīgo varat izmantot customer_phone vai customer_email vietā, pārvaldot abonementus.

Piemērs:

Funkcija atgriež statusa vērtību.

Ja darbība ir veiksmīga:

status = ok

prodamus_subscription_switch_status

Varat arī pārvaldīt abonementus, izmantojot Kalkulatoru.

prodamus_subscription_switch_status(
    subscription_id,
    switcher,
    customer_phone,
    customer_email,
    profile_id
)

Parametri

Parametrs Apraksts
subscription_id Abonēšanas produkta ID.
switcher 0 – deaktivizēt abonementu, 1 – atkārtoti aktivizēt abonementu.
customer_phone Klienta tālruņa numurs. Neobligāts, ja ir norādīts customer_email.
customer_email Klienta e-pasta adrese. Neobligāts, ja ir norādīts customer_phone.
profile_id Klienta profila ID Prodamus.

1. piemērs

Deaktivizēt abonementu, izmantojot klienta tālruņa numuru.

status = prodamus_subscription_switch_status(
    "618117",
    "0",
    "75431312321"
)

2. piemērs

Deaktivizēt abonementu, izmantojot klienta e-pasta adresi.

status = prodamus_subscription_switch_status(
    "618117",
    "0",
    "",
    "[email protected]"
)

Funkcija atgriež ok, ja darbība ir veiksmīga. Pretējā gadījumā tā atgriež kļūdas ziņojumu.

Abonementa atlaižu pārvaldība

Izmantojiet šādu funkciju, lai piemērotu atlaidi nākamajiem periodiskajiem maksājumiem.

Atlaidi var piemērot ierobežotam maksājumu skaitam vai beztermiņa.

prodamus_subscription_discount(
    subscription_id,
    discount,
    customer_phone,
    num,
    profile_id
)

Parametri

Parametrs Apraksts
subscription_id Abonementa ID.
discount Atlaides summa. Jābūt lielākai par nulli un nedrīkst pārsniegt abonementa cenu.
customer_phone Klienta tālruņa numurs. Neobligāts, ja pieejams no customer_phone.
num Nākamo maksājumu skaits, kuriem jāpiemēro atlaide. Ja izlaists, atlaide ir pastāvīga.
profile_id Klienta profila ID Prodamus.

Ja veiksmīgi, funkcija atgriež:

ok

Pretējā gadījumā tā atgriež kļūdas aprakstu.

Lai atjauninātu atlaidi vai maksājumu skaitu, funkcija jāizsauc atkārtoti ar jaunajām vērtībām.

Piemēri

Pastāvīga atlaide

Piemērot atlaidi 1 visiem nākamajiem abonementa maksājumiem.

result = prodamus_subscription_discount(
    "624034",
    "1"
)

Atlaide nākamajiem trim maksājumiem

result = prodamus_subscription_discount(
    "624034",
    "2",
    "",
    "3"
)

Decimāla atlaide

result = prodamus_subscription_discount(
    #{prodamus_subscription},
    10.25,
    #{customer_phone},
    3
)

Nākamā abonementa maksājuma datuma maiņa

Jūs varat atlikt nākamo periodisko maksājumu, mainot tā plānoto datumu.

Jaunajam maksājuma datumam vienmēr jābūt vēlākam par pašreizējo plānoto maksājuma datumu.

Šo funkciju var izmantot, piemēram, lai pagarinātu klienta abonementa periodu kā bonusu.

Izmantojiet šādu funkciju:

prodamus_subscription_payment_date(
    subscription_id,
    date,
    customer_phone,
    profile_id
)

Parametri

Parametrs Apraksts
subscription_id Abonementa ID.
date Jauns maksājuma datums formātā dd.MM.yyyy vai dd.MM.yyyy HH:mm. Ja laiks nav norādīts, tiek izmantots 00:00.
customer_phone Klienta tālruņa numurs. Neobligāts. Ja izlaists, vērtība tiek ņemta no mainīgā customer_phone.
profile_id Klienta profila ID Prodamus.

Papildu parametru nodošana Prodamus

Jūs varat nosūtīt papildu parametrus, ko atbalsta Prodamus (piemēram, abonementa sākuma datumus vai iemaksu iestatījumus), ģenerējot maksājuma saiti.

Vienkārši izveidojiet mainīgo, kura nosaukums sākas ar prefiksu prodamus_.

Piemērs:

prodamus_some_parameter

Kad tiek ģenerēta maksājuma saite, visi mainīgie ar prefiksu prodamus_ tiek automātiski iekļauti pieprasījumā, kas tiek nosūtīts Prodamus.

Maksājumu testēšana

Tiek simulēts tikai maksājuma process.

Konfigurējot savu integrāciju un čatbota plūsmas, varat izmantot Prodamus testa kartes, lai izvairītos no reālu līdzekļu norakstīšanas.

Vispirms pārslēdziet savu maksājuma lapu uz Demonstrācijas režīmu.

Neaizmirstiet noklikšķināt uz Saglabāt pēc režīma maiņas.

Testa kartes

MIR

Lauks Vērtība
Kartes numurs 2202 2050 0001 2424
Derīguma termiņš 05/35
CVV 669

Mastercard

Lauks Vērtība
Kartes numurs 5469 9801 0004 8525
Derīguma termiņš 05/26
CVV 041
3-D Secure kods 111111

Visa

Lauks Vērtība
Kartes numurs 4006 8009 0096 2514
Derīguma termiņš 05/26
CVV 941
3-D Secure kods 111111

Svarīgi: Testa kartes aktivizē to pašu čatbota loģiku, atzvanus, automatizācijas un integrācijas kā reāli maksājumi.

Kad testēšana ir pabeigta, pārslēdziet maksājuma lapu atpakaļ uz Tiešraides režīmu, lai sāktu pieņemt reālus maksājumus.

Demonstrācijas režīma pārslēgšanai jābūt izslēgtai (sarkanā poga deaktivizēta).