Prodamus (KZ)

Kā pievienot Prodamus

Lai pievienotu Prodamus, jums būs nepieciešams maksājuma formas URL un slepenā atslēga.

Maksājuma formas URL tiek piešķirts pēc reģistrācijas, tā piemērs: demo.payform.ru.

Slepeno atslēgu var iegūt personīgajā kabinetā, turpat jānorāda arī URL, uz kuru tiks sūtīti paziņojumi (notification).

Pilnīga instrukcija, kā to izdarīt

Adrese paziņojumiem:
https://chatter.mavibot.ai/prodamus\_callback/result

Šī adrese ir jānorāda divās vietās iestatījumos.

Iestatījumu galvenajā lapā var izvēlēties maksājuma formas darba režīmu: demo režīms bez maksājuma vai maksājumu pieņemšanas režīms.

Adrese paziņojumiem ir jānorāda divās vietās maksājumu sistēmas iestatījumos: cilnē “Formas iestatīšana” — vienreizējiem (parastajiem) maksājumiem un cilnē “Abonementi” — maksājumiem pēc abonementa.

Adrese paziņojumiem:
https://chatter.mavibot.ai/prodamus\_callback/result

Lai iestatītu darbu ar maksājumiem pēc abonementa, dodieties uz cilni “Abonementi” un norādiet adresi paziņojumiem:

https://chatter.mavibot.ai/prodamus\_callback/result

Uzmanību! Pēc URL ievadīšanas noteikti nospiediet pogu “Saglabāt”.

Lai pievienotu Prodamus, jādodas uz sadaļu “Ekvairings”.

Pēc tam pietiek ievadīt iepriekš minētos datus formā:

Svarīgi! Norādot maksājuma formas URL, nepievienojiet https://.

Tādējādi pievienošana ir pabeigta. Tagad apskatīsim, kā izmantot šo funkcionalitāti.

Kā izveidot saiti uz maksājumu

Poga ar funkciju “Maksāt”

Saiti uz maksājumu var izveidot pogā ar funkciju “Maksāt”.

Kā izveidot šādu pogu, ir aprakstīts šajā rakstā.

Tagad apskatīsim visus iespējamos šīs pogas parametrus.

Obligātie parametri pogai “Maksāt” Prodamus

Lai izveidotu saiti uz maksājumu, pogas iestatījumos jānorāda obligātie parametri:
“Summa”, “Preces nosaukums”, kā arī parametrs “Apmaksāts saturs” — ja jums nav savas tiešsaistes kases un vēlaties saņemt čeku no Prodamus.

Dodoties uz pasūtījuma lapu, informācija par preci un tās cenu tiks parādīta iepriekš, un klients ievadīs tikai savus kontaktinformācijas datus.

Ja pogas iestatījumos ir norādīts lietotāja e-pasts un/vai tālrunis, pasūtījuma lapā tiks parādīta maksātāja kontaktinformācija, kā arī informācija par preci un tās cenu.

Lauks “Teksts” – šis teksts tiks parādīts ziņojumā uz pogas ar saiti uz maksājumu.

Lauks “Funkcija” – lai izveidotu pogu, kas ved uz maksājumu, izvēlamies funkciju “Maksāt”.

Lauks “Maksājumu sistēma” – sarakstā tiks parādītas projektam pievienotās maksājumu sistēmas.
Ja projektam nav pievienota neviena maksājumu sistēma, šis pogas veids nebūs pieejams.

Lauks “Preces nosaukums” (obligāts) – jānorāda precīzs preces nosaukums. Piemēram: nevis “Telefons”, bet “Xiaomi viedtālrunis, modelis …”.
Piezīme: preces nosaukumā nedrīkst lietot dubultpēdiņas; tās ir jāizņem vai jāaizstāj ar vienpēdiņām.

Lauks “Summa” (obligāts) – norādām preces cenu.

Izvēlne “Papildu informācija” – noklikšķinot uz šīs pogas, tiks atvērti papildu lauki saites izveidei:

• Pasūtījuma apraksts
• Atlaide rubļos
• Pircēja e-pasta mainīgais
• Pircēja tālruņa numura mainīgais
• Saites derīguma termiņš
• Preces ID abonementam (automātiskajam maksājumam)
• Apmaksāts saturs

Izvēles rūtiņa “Paziņojums par klikšķi” – var atzīmēt, lai izsekotu pārejai uz maksājuma saiti. Šajā gadījumā, noklikšķinot uz pogas, klienta dialogā Salesbot tiks saņemts ziņojums par to, ka ir veikta pāreja uz saiti.

Pamatojoties uz šo ziņojumu, var iestatīt tālāko bota darba loģiku.
Daudzas maksājumu sistēmas atbalsta mākoņa tiešsaistes kases, kas nepieciešamas saskaņā ar 54-FZ prasībām.

Izlasiet čeku noformēšanas īpatnības izvēlētās maksājumu sistēmas vietnē, lai nerastos sarežģījumi ar nodokļu inspekciju.

Lūk, kā izskatās maksājuma lapa, kas tiek atvērta, sekojot saitei pogā “Maksāt”:

Papildu iestatījumi saites uz maksājumu izveidei

Lauks “Pasūtījuma apraksts” – šajā laukā ievadītā informācija tiks parādīta maksājuma lapā laukā Papildu dati.

Lauks “Atlaide” – šeit var norādīt atlaides lielumu rubļos vai rubļos un santīmos. Lai norādītu santīmos, izmantojiet punktu kā atdalītāju: 50.99
Maksājuma lapā laukā Maksājamā summa atlaide tiks ņemta vērā, un pamata preces cena tiks pārsvītrota.

Lauks “Pircēja e-pasta mainīgais” (nav obligāts, ja ir norādīts tālruņa numurs) – šeit tiek norādīts lietotāja (klienta) e-pasts. Var izmantot arī mainīgo, kurā ir saglabāts e-pasts, piemēram: #{email}

Lauks “Pircēja tālruņa numura mainīgais” (nav obligāts, ja ir norādīts e-pasts) – šeit var izmantot mainīgo, kurā ir norādīts pircēja tālruņa numurs, formātā: 79000000000, piemēram: #{phone}
Obligāti jābūt e-pastam un/vai tālrunim.

Lauks “Saites derīguma termiņš” – datumu var norādīt formātā dd.mm.gggg st:min (piemēram, 25.01.2021 11:00) vai saites beigu termiņu var iestatīt, izmantojot mainīgo. Piemēram: #{link_expired}

Lauks “Preces ID abonementam” – lai veiktu automātisko maksājumu, norādiet preces ID vērtību. Lai izveidotu abonementu, ir jāizveido abonementa prece.
Pilnīga instrukcija: Prodamus abonementu izveide un iestatīšana
Ja ir norādīts preces ID abonementam, maksājuma summa netiks ņemta vērā. Informācija par preci tiek ņemta no preces kartes Prodamus kabinetā.
Maksājumā norādītais tālruņa numurs būs nepieciešams abonementa pārvaldībai.
Ja ir norādīts preces ID abonementam, veiksmīga maksājuma gadījumā callback tiks nosūtīts šīs preces ID.

Lauks “Apmaksāts saturs” (nosacīti obligāts) – šie dati ir nepieciešami maksājuma fiskalizācijai, izmantojot Prodamus, ja jums nav savas tiešsaistes kases. Šajā laukā tiek norādīts pirkuma apraksts, cena un saite uz saturu.
Piemēram: Kurss ‘Pīto bizes’, cena 3000 rubļu, saite uz kursa lapu: https://nbu.su/krasota/master-po-pleteniyu-kos/?yclid=13602995275739430911

Poga ar funkciju “Maksāt”

Ja norādāt saites derīguma termiņu, notiks sekojošais:
Ja lietotājs pieprasa maksājuma saiti tās derīguma termiņa laikā (t.i., saites laiks vēl nav beidzies) un viņš atrodas dialogā, maksājums nebūs iespējams, un viņam tiks parādīts šāds ziņojums:

Saites derīguma termiņam jābūt pēc pašreizējā datuma, pretējā gadījumā klients nevarēs veikt maksājumu, izmantojot šo saiti.

2. Ja lietotājs pieprasa saiti, kad viņš pašlaik nav aktīvs
Šajā gadījumā poga vienkārši nebūs redzama. Klienta mainīgajos parādīsies mainīgais "error_payment_button", kura vērtība būs šāda:
&#xNAN;"Kļūda: Saites derīguma termiņam jābūt pēc pašreizējā datuma".

Lai lietotājs varētu pareizi veikt maksājumu, ieteicams papildus apstrādāt šādu situāciju.

Izveidojiet šādu nosacījumu bloku:
Ja tiek saņemts šāds ziņojums:
error_payment_button == "Kļūda: Saites derīguma termiņam jābūt pēc pašreizējā datuma"

Tad parādiet šādu tekstu:
&#xNAN;"Atvainojiet, jūs nevarējāt veikt maksājumu laikā, maksājuma saite ir kļuvusi nederīga".

Klienta mainīgie, kas tiek automātiski izveidoti, izmantojot pogu ar funkciju “Maksāt”

Brīdī, kad lietotājs saņem bloku ar pogu “Maksāt”, klientam automātiski tiek izveidoti mainīgie:

Pakalpojuma klienta mainīgais __payments – šis mainīgais saglabā summu un izveidotās saites identifikatoru, un tas ir nepieciešams, lai identificētu no maksājumu sistēmas nākošo hook.

Pakalpojuma klienta mainīgo __payments nedrīkst izdzēst vai mainīt!

Klienta mainīgais error_payment_button tiek automātiski izveidots, ja pogas izveides laikā rodas kļūda.
Šajā mainīgajā tiek ierakstīts kļūdas teksts vai no maksājumu sistēmas saņemtā kļūdas atbilde.

Mainīgo vērtības kļūst aktuālas, pārejot uz nākamo bloku.

Kā apstrādāt rezultātu

Veiksmīgs maksājums
Pēc veiksmīga maksājuma veikšanas botam AUTOMĀTISKI TIEK NOSŪTĪTS CALLBACK, kas sastāv no maksājumu sistēmas slepenās atslēgas pirmajām 10 rakstzīmēm, vārda _success un maksājuma summas.
Lai to izmantotu shēmas iestatījumos, pietiek to vienkārši nokopēt.

Piemēram: ovg58keefc_success 44, kur:

• ovg58keefc – maksājumu sistēmas slepenās atslēgas pirmās 10 rakstzīmes
• _success – pieprasījuma apstrādes rezultāts (veiksmīgs maksājums)
• 44 – maksājuma summa

Lietotājs NEREDZ no maksājumu sistēmas nākošos callbackus (ziņojumus). Tie tiek rādīti tikai cilnē “Klienti” un ir redzami operatoram.

Lietošanas piemērs:
1. solis. Blokam “Ar maksājuma pogu” pievienojam pogas ar funkciju “Maksāt”.
2. solis. Šī bloka laukā Savienojuma nosacījums, kas ved uz bloku “Veiksmīgs maksājums”, norādām callback.
Tāpat, ja sākotnējā nosacījuma bloka nosacījumā ir norādīts veiksmīga maksājuma callback, darbs notiek analogi.

Svarīgi: Izvēlieties “Pilnīga atbilstība” vai “Pēc atslēgvārdu esamības”.

❗️Ja nolemjat pārbaudīt maksājumu precīzi pēc nosacījuma, kas norādīts bultiņā, rūpīgi pārdomājiet savas shēmas loģiku. Ja klients izlaiž bloku, caur kuru viņš iet ar callback nosacījumu, pāreja uz bloku nenotiks. Šādu pārbaudes metodi ieteicams izmantot tikai tad, ja klients nemaina savu vietu piltuvē.

Shēmās, kur klients pārvietojas starp blokiem, efektīvāk ir izmantot iespēju norādīt callback blokā “Sākotnējais nosacījums”.

Veiksmīgs maksājums precēm ar automātisko abonementu

Pēc veiksmīga maksājuma veikšanas botam AUTOMĀTISKI TIEK NOSŪTĪTS CALLBACK, kas sastāv no maksājumu sistēmas slepenās atslēgas pirmajām 10 rakstzīmēm, vārda _success un abonementa preces ID.

Piemēram: 214009eefc_success 618117, kur:

• 009eefc – maksājumu sistēmas slepenās atslēgas pirmās 10 rakstzīmes
• _success – pieprasījuma apstrādes rezultāts (veiksmīgs maksājums)
• 618117 – abonementa preces ID

Kļūdains maksājums
Ja maksājuma veikšanā radās kļūda, botam AUTOMĀTISKI TIEK NOSŪTĪTS CALLBACK, kas sastāv no maksājumu sistēmas slepenās atslēgas pirmajām 10 rakstzīmēm, vārda _fail un maksājuma summas.

Piemēram: ovg58keefc_fail 44, kur:

• ovg58keefc – maksājumu sistēmas slepenās atslēgas pirmās 10 rakstzīmes
• _fail – pieprasījuma apstrādes rezultāts (maksājums nav veikts vai radās kļūda)
• 44 – maksājuma summa

Tas ir atkarīgs no maksājumu sistēmas. Ne visas maksājumu sistēmas sūta callback par maksājuma kļūdu.

Ja pogas iestatījumos norādītā summa atšķiras no klienta samaksātās summas, botam AUTOMĀTISKI tiek nosūtīts CALLBACK. Tas sastāv no maksājumu sistēmas slepenās atslēgas pirmajām 10 rakstzīmēm, vārda _different_amounts un maksājuma unikālā ID.

Piemērs: ovg58keefc_different_amounts 123456, kur:

• ovg58keefc – maksājumu sistēmas slepenās atslēgas pirmās 10 rakstzīmes
• _different_amounts – pieprasījuma apstrādes rezultāts (maksājuma summa atšķiras no saites summas)
• 123456 – maksājuma unikālais ID

Funkcija get_prodamus_payment_url kalkulatorā

Lai izveidotu saiti uz maksājumu, var izmantot funkciju get_prodamus_payment_url kalkulatora blokā.
Kalkulatora laukā mainīgajam piešķiram šīs funkcijas vērtību: get_prodamus_payment_url.

Mainīgā nosaukumu izvēlaties paši. Ekrānuzņēmumos ir parādīti mainīgo nosaukumu piešķiršanas piemēri.

Šajā mainīgajā tiks ierakstīta saite uz maksājumu. Mainīgo var izmantot kā saiti ziņojumā vai ievietot pogā ar tekstu “Maksāt”.

Saites uz maksājumu piemērs: https://payform.kz/7p3JR8/

Kalkulators

1. piemērs:

Parametru apraksts

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

Funkcijas parametri:

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

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

Piemērs

extra_params = {"payments_limit": "3"}

products_for_receipt = "Kurss ‘Pļauķu ķeršana’, cena 4999 tengi, saite uz kursa lapu: https://www.lovilescha.ru/courses/poimai\_kilogram/" 

link_prodamus_url = get_prodamus_payment_url( 4999, 'Kurss ‘Pļauķu ķeršana’', '27.03.2023 17:00', '79167777771', '[email protected]', 20, 'Labākais kurss tirgū', extra_params, products_for_receipt

Šajā piemērā:

• extra_params – papildu parametri (piemēram, maksājuma limits).
• products_for_receipt – informācija par preci, kas tiks norādīta čekā.
• Izmantojot funkciju get_prodamus_payment_url, tiek izveidota saite uz maksājumu.

Ja blokā ir vairākas saišu iegūšanas funkcijas un tiek pieļauta kļūda, kļūdas vērtība tiek ierakstīta mainīgajā error_payment_func.

Kļūda tiek ierakstīta kalkulatorā atbilstoši pēdējai funkcijai.

Saites izveide, izmantojot mainīgo payment_sum un papildu parametrus

Uzmanību: mainīgajam payment_sum vērtība tiek piešķirta no pēdējā mainīgā, t.i., pēc neobligātajiem mainīgajiem: payment_description, product_name utt.

Lai izveidotu saiti uz maksājumu, kalkulatora laukā pietiek iestatīt mainīgā payment_sum vērtību.
Pēc tam automātiski parādīsies mainīgais prodamus_pay_url.

Saites uz maksājumu piemērs: https://payform.ru/7p3JR8/

Šo mainīgo var izmantot kā saiti ziņojumā vai ievietot pogā ar tekstu “Maksāt”.

Pirms mainīgā payment_sum deklarēšanas var norādīt šādus neobligātos mainīgos:

discount_value, customer_phone, customer_email un link_expired mainīgie ir aktuāli arī abonementiem.

Ieviešanas piemērs.
Pirmajā blokā iestatām maksājuma summu:

Nākamajā solī nepieciešamajā vietā izvadām saiti prodamus_pay_url:

Mainīgais prodamus_available_payment_methods tiek noteikts pirms payment_sum deklarēšanas.
Iespējamās vērtības:

Ir atļauts norādīt vairākas vērtības, atdalot tās ar vertikālo svītru.
Piemēram:

prodamus_available_payment_methods = "AC|PC|QW"

prodamus_currency – tas ir vēl viens papildu parametrs, kas ļauj norādīt summu noteiktā valūtā.

Iespējamās valūtas:

• kzt – tengēm
• eur – eiro
• usd – dolāram

Tādējādi saitē norādītā summa būs izvēlētajā valūtā.

Saņemot callback payment_callback, jāpievērš uzmanība parametriem currency un currency_sum, kuros ir norādīta valūta un summa.

Ja nav norādīts, tiks novirzīts uz lapu bez maksājuma metodēm.
Maksājuma metodes var pievienot, izmantojot atbalstu. Pievienotās metodes var apskatīt lapas iestatījumos vai izveidojot saiti uz maksājumu.

Kā apstrādāt rezultātu

Veiksmīgs maksājums

Svarīgi: pēc veiksmīga vai neveiksmīga maksājuma botā nāk callbacki, ar kuru palīdzību var noteikt, vai maksājums ir veikts veiksmīgi.

Callbacki sistēmā izskatās kā ziņojumi no lietotāja, bet lietotājs tos nevar nosūtīt. Tie ir slepenās atslēgas un statusa kombinācija. Piemēram:

453e8fba8b7cef9ce58dc6e18e25b39ad5a05748175a3f205f2b084acbfc3b66_success

vai

453e8fba8b7cef9ce58dc6e18e25b39ad5a05748175a3f205f2b084acbfc3b66_fail

Pēc veiksmīga maksājuma mainīgais prodamus_payment_completed automātiski iegūst vērtību True.

Piezīme: Callbacki nāk ar nelielu aizkavi, tāpēc pēc saites nosūtīšanas lietotājam ieteicams nosūtīt ziņojumu:

“Pēc maksājuma veikšanas uzgaidiet, kamēr maksājums tiek veiksmīgi pabeigts.”

Callback struktūra

Saitēm, kas izveidotas, izmantojot pogu “Maksāt” vai funkciju Kalkulatorā, pēc maksājuma botā automātiski nāk callback. Tas satur:

<секретный_ключ>_success <сумма_платежа>

Piemēram:

ovg58keefc_success

• ovg58keefc – pilna maksājumu sistēmas slepenā atslēga
• _success – pieprasījuma apstrādes rezultāts (veiksmīgs maksājums)

Praktiska izmantošana

Veiksmīgu maksājumu var apstrādāt, izmantojot nosacījumu bloku, un parādīt lietotājam atbilstošu ziņojumu.

Salīdzināšanas tipam jābūt "Full match" / "Pilnīga sakritība"

Lai veiktu atkārtotu maksājumu, obligāti jāatiestata mainīgais payment_sum uz nulli un jāizdzēš iepriekš izveidotā saite. Tikai pēc tam var piešķirt jaunu vērtību mainīgajam payment_sum un iegūt atjaunināto saiti.

Abonementa deaktivizēšana/reaktivizēšana

Turklāt Prodamus sistēmā ir paziņojumi par to, vai abonements ir aktivizēts vai pārtraukts:

“Abonementu atspējoja lietotājs” – ja abonements tika pārtraukts manuāli (piemēram, atteikšanās no abonementa gadījumā).
Šis paziņojums var nākt pirms pašreizējā apmaksātā perioda beigām. Rīcība ir atkarīga no jūsu lēmuma: ignorēt, ņemt vērā vai mēģināt atgriezt lietotāju.

“Abonementu atkārtoti aktivizēja lietotājs” – abonements ir atjaunots.
Šis paziņojums var nāt, ja lietotājs atjauno abonementu pirms pašreizējā apmaksātā perioda beigām. Rīcība ir atkarīga no jūsu lēmuma: ignorēt vai izņemt no uzraudzības saraksta.

“Abonementa deaktivizēšana” – ja abonements tiek pārtraukts pēc vairākiem neveiksmīgiem maksājumiem.

Vērtību saglabāšana no callback

Pēc veiksmīga maksājuma paziņojuma saņemšanas mainīgajā payment_callback tiek ierakstīts callback no Prodamus, kas satur visus maksājuma datus. Šos datus var saglabāt un izmantot sev vēlamajā veidā.

Callback piemērs:

{
  "date": "2021-03-30T11:44:43+03:00",
  "order_id": "757679",
  "order_num": "",
  "domain": "demo.payform.ru",
  "sum": "14.50",
  "customer_phone": "+77777777777",
  "customer_extra": "Товар",
  "payment_type": "Пластиковая карта Visa, MasterCard, МИР",
  "commission": "3.5",
  "commission_sum": "0.51",
  "attempt": "1",
  "discount_value": "10.5",
  "products[0][name]": "Доступ к обучающим материалам",
  "products[0][price]": "14.50",
  "products[0][quantity]": "1",
  "products[0][sum]": "14.50",
  "payment_status": "success",
  "payment_status_description": "Успешная оплата",
  "payment_init": "manual"
}

Veidojot saiti, var norādīt mainīgos product_name un payment_description. Tad, saņemot callback, tos var iegūt šādi:

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

Ņemiet vērā: mainīgajam payment_sum tiek piešķirta pēdējā vērtība, kas atrodas pēc neobligātajiem mainīgajiem: payment_description, product_name.

Summu var iegūt šādi:

summa = get(payment_callback, 'sum')

Pieejamie callbacki

Papildus galvenajiem veiksmīgā maksājuma callbackiem, tērzēšanā nāk šādi lietotājam neredzami ziņojumi:

Pēc vēlēšanās var konfigurēt jebkura ziņojuma nosūtīšanu lietotājam. Piemēram, nosūtīt paziņojumu automātiskā maksājuma neveiksmes gadījumā.

Kā konfigurēt atbildes blokus neveiksmīgam maksājumam pēc konkrēta iemesla

Neveiksmīga maksājuma atbildes blokus var konfigurēt pēc konkrēta iemesla šādi:

Lai nosūtītu ziņojumu par visiem neveiksmīgajiem maksājumiem neatkarīgi no iemesla, var konfigurēt šādi:

Visos callbackos, ja tekstā ir vārdi "Maksājums neveiksmīgs", lietotājam tiks nosūtīts ziņojums ar jūsu norādīto tekstu.

Kā veikt maksājumu par abonementu

Kā izveidot abonementu

Lai izveidotu abonementu, vispirms ir jāizveido abonēšanas prece.
Pilnīga instrukcija: Kā izveidot un konfigurēt abonementu

Pēc tam nokopējiet abonēšanas preces ID. Piemēram, zemāk ir norādīts, kur to atrast:

Lai izveidotu abonementa maksājuma saiti, mainīgajam prodamus_subscription ir jāiestata abonēšanas preces ID. Pēc tam automātiski parādīsies mainīgais prodamus_pay_url.

Mainīgo prodamus_pay_url var attēlot ekrānā kā saiti vai ievietot pogā ar tekstu "Maksāt". Saites piemērs: https://payform.kz/7p3JR8/

Rezultāta apstrāde notiek tāpat kā vienreizējam maksājumam (kā lasījāt iepriekš).

Pēc veiksmīga abonementa lietotājam tiek pievienots maksājuma laikā ievadītais mainīgais customer_phone. Tālruņa numurs ir nepieciešams abonementa pārvaldībai.

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

Kā izveidot saiti uz abonementu, izmantojot funkciju get_prodamus_subscription_url

Apskatīsim citu veidu, kā izveidot saiti abonementa maksājumam par preci.

1. Prodamus kabinetā tiek izveidota abonēšanas prece.
   Pilnīgu instrukciju var atrast šajā saitē:
   Kā izveidot un konfigurēt abonementu
2. Pēc tam nokopējiet abonēšanas preces ID. Piemēram, zemāk ir norādīts, kur to atrast:

Lai iegūtu saiti preces apmaksai pēc abonementa, Kalkulatorā norādiet funkciju

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

Kalkulators

1. piemērs: Abonementa preces maksājuma saite

Parametru apraksts

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

Funkcijas parametri:

expired = current_date + 2  # saite būs derīga 2 dienas, līdz plkst. 00:00

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

extra_params = {"payments_limit": "3"}

Koda piemērs kopēšanai

extra_params = {"payments_limit": "3"}

products_for_receipt = "Kurss 'Plaužu ķeršanas kurss', ikmēneša abonementa cena 2000 tengu, saite uz kursa lapu: https://www.lovilescha.ru/courses/poimai\_kilogram/" 

link_prodamus_sub = get_prodamus_subscription_url(618988, 'Kurss 'Plaužu ķeršanas kurss'', '27.03.2023 17:02', '79167777771', '[email protected]', 20, 'Labākais kurss tirgū', extra_params, products_for_receipt)

Ja, iegūstot saiti, izmantojot vairākas funkcijas blokā, rodas kļūda, kļūdas vērtība tiek ierakstīta mainīgajā error_payment_func.

Kļūda tiek ierakstīta Kalkulatorā pēc pēdējās funkcijas.

Kā pārvaldīt abonementa statusu

Šī metode ir paredzēta tikai reāliem abonementiem, demonstrācijas režīmā kartes piesaistes nav.

Lai pārvaldītu abonementu, obligāti jānorāda viens no parametriem: customer_phone vai customer_email.

Lai atrakstītu lietotāju no abonementa, ir jāizveido bloks un jāizsauc šāda funkcija:
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"
}

• url – maksājuma formas URL, iegūts no konstruktora iestatījumiem
• secret_key – slepenā atslēga no iestatījumiem
• id_subscription – abonēšanas preces ID
• customer_phone – abonementa īpašnieka tālrunis
• switcher – abonementa pārvaldība: 0 – apturēt abonementu, 1 – atkārtoti aktivizēt abonementu
• profile_id – profila ID Prodamus sistēmā

Piezīme:
Ja profila ID ir saņemts, tas tiek saglabāts mainīgajā profile_id.
profile_id var nodot funkcijai customer_phone vai customer_email vietā, lai apturētu abonementu.

Piemērs: abonementa bloku konfigurēšana

Ņemiet vērā, ka funkcija atgriež statusu, kuru var saglabāt un apstrādāt pēc saviem ieskatiem. Veiksmīgas abonementa apturēšanas vai atkārtotas aktivizēšanas gadījumā status = ok.

Funkcija abonementa pārvaldībai

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

subscription_id – abonēšanas preces ID

switcher – abonementa pārvaldība: 0 – apturēt abonementu, 1 – atkārtoti aktivizēt abonementu

customer_phone – abonementa īpašnieka tālrunis; nav obligāts, ja ir norādīts customer_email

customer_email – abonementa īpašnieka e-pasta adrese; nav obligāts, ja ir norādīts customer_phone

profile_id – profila ID Prodamus sistēmā

1. piemērs: ir norādīts customer_phone, customer_email ir izlaists:

stat = prodamus_subscription_switch_status('618117', '0', '75431312321')

2. piemērs: ir norādīts customer_email, customer_phone ir izlaists:

stat = prodamus_subscription_switch_status('618117', '0', '', '[email protected]')

Funkcija atgriež ok, ja visas darbības ir veiksmīgas, vai kļūdas aprakstu, ja rodas kļūda.

Atlaižu pārvaldība abonementā

Šī funkcija nosaka atlaides apmēru nākamajiem maksājumiem abonementā. Atlaidi var piešķirt ierobežotam vai neierobežotam maksājumu skaitam.

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

Parametri:

• subscription_id – abonementa ID
• discount – decimāldaļa ar diviem cipariem aiz komata; vērtībai jābūt lielākai par nulli un nedrīkst pārsniegt abonementa bāzes izmaksas
• customer_phone – klienta tālruņa numurs, formātā: +79999999999 (nav obligāts, ja ir mainīgais customer_email; tas parādās pēc pirmā maksājuma)
• num – maksājumu skaits, uz kuriem attiecas atlaide (nav obligāts; ja nav norādīts, atlaide attiecas uz visiem maksājumiem)
• profile_id – profila ID Prodamus sistēmā

Ja pieprasījums ir veiksmīgs, funkcija atgriež 'ok'; ja rodas kļūda, funkcija atgriež kļūdas aprakstu.

Atlaides apmērs un intervāls tiek pārrakstīts tikai tad, ja funkcija tiek atkārtoti izsaukta ar jaunām vērtībām!

Piemēri:

1. Piešķirt 1₽ atlaidi visiem nākamajiem automātiskajiem maksājumiem (tālruņa numurs netiek norādīts, jo tas tiek automātiski iegūts no mainīgā customer_phone; atlaides summa pēc noklusējuma attiecas uz visu abonementa termiņu):

r = prodamus_subscription_discount('624034', '1')

2. Piemērs 2₽ atlaides piešķiršanai nākamajiem 3 maksājumiem (tālruņa numurs ir norādīts ar tukšām pēdiņām, jo tas tiek automātiski iegūts no mainīgā customer_phone):

r = prodamus_subscription_discount('624034', '2', '', '3')

3. Atlaides norādīšana decimāldaļskaitlī (dalītājs – punkts, vērtības norādītas bez pēdiņām), tālruņa numuru var nodot caur mainīgo.

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

Kā iestatīt nākamā maksājuma datumu abonementam

Izmantojot šo metodi, var pārcelt nākamā maksājuma datumu abonementam. Datumu var pārcelt tikai "nākotnē" no pašreiz iestatītā nākamā maksājuma datuma, tādējādi pagarinot dalības termiņu klubā.

Piemēram, to var izmantot kā bonusu abonentiem.

Lai to izdarītu, jāizmanto šāda funkcija:

prodamus_subscription_payment_date(subscription_id, date, customer_phone, profile_id)

Parametri:

• subscription_id – abonementa identifikators
• date – datums formātā dd.mm.gggg hh:mm vai dd.mm.gggg; ja norādīts tikai dd.mm.gggg, laiks būs 00:00
• customer_phone – nav obligāts; ja nav norādīts, tiek ņemts no mainīgā customer_phone; ja netiek atrasts, funkcija nedarbosies
• profile_id – profila ID Prodamus sistēmā

Kā nosūtīt parametrus uz Prodamus

Lai nosūtītu nepieciešamos parametrus (piemēram, abonementa sākuma datumu, atliktā maksājuma izslēgšanu u.c.) uz Prodamus sistēmu, mainīgā nosaukumam pievienojiet prefiksu prodamus_.

Pēc tam, veidojot maksājuma saiti, šajā mainīgajā esošie parametri tiks automātiski nosūtīti uz maksājumu sistēmu.

Kā testēt maksājumu

Testējam tikai maksājumu!

Integrācijas un maksājumu piltuvju iestatīšanas laikā, lai no jūsu konta netiktu norakstīta nauda, varat izmantot testa kartes.

Vispirms pārslēdziet savu maksājuma lapu uz DEMO režīmu ⤵
Neaizmirstiet nospiest pogu "Saglabāt".

Lai veiktu testa maksājumu, varat izmantot testa kontus.

Sberbank testa kartes:

MIR
Kartes numurs: 2202 2050 0001 2424
Derīguma termiņš: 05/35
Pārbaudes kods aizmugurē (CVV): 669

MasterCard
Kartes numurs: 5469 9801 0004 8525
Derīguma termiņš: 05/26
Pārbaudes kods aizmugurē (CVV): 041
3‑D Secure pārbaudes kods: 111111

Visa
Kartes numurs: 4006 8009 0096 2514
Derīguma termiņš: 05/26
Pārbaudes kods aizmugurē (CVV): 941
3‑D Secure pārbaudes kods: 111111

❗️Veicot maksājumu ar testa kontiem, visas iestatītās piltuves un integrācijas darbojas tāpat kā parastā maksājumā❗️

Forma pārbaudīta

Lai pieņemtu reālus maksājumus, forma ir jāpārslēdz uz darba režīmu. Tas nozīmē, ka demo režīma slēdzis jāpārslēdz uz atvērti sarkanu stāvokli.