Integracijos diegimas

Konsultantams ir atstovams:

Diegimas

  • Į Rivile GAMA\ALL katalogą įrašomi failai:
    • foxpay_qr_link_ro.fxp,
    • merchantprivate.key - Foxpay išduotas rakto failas, kuris gaunamas iš Foxpay (gali būti įrašomas į įmonės katalogą),
    • foxpay-logo.jpg - Foxpay logotipas.

Pastaba. Jeigu integracija diegiama kelioms įmonėms, kiekvienos įmonės merchantprivate.key įrašomas į tos įmonės katalogą.

  • SS_RIV_API parametre nurodomas Rivile API raktas (modulis "Bendras" arba "Pardavimai")

foxpay_11

  • Pardavimo operacijų sąraše aprašomas testavimo klavišas (CTRL+Q):
=f_info(foxpay_qr_link_ro(Wi06r.i06_kodas_po),.T.)

foxpay_12

  • Pirmą kartą paleidus testavimo klavišą, automatiškai susikuria parametras FOXPAY_USER.
  • Įvedamos parametro reikšmės:
    • Merchant id ir
    • FOXPAY_KEY - nuoroda į failą merchantprivate.key. (Pvz., C:\riv_gama\merchantprivate.key)
  • Pardavimo operacijų sąraše paspaudus testavimo klavišą, sėkmės atveju parodoma pilnai suformuota nuoroda, kurią nukopijavus į naršyklę atidaromas dokumento apmokėjimo langas Foxpay puslapyje. Jei viskas veikia tinkamai - testavimo mygtuką galima ištrinti.
  • Susiimportuojamos papildomos ataskaitos - jose aprašytas nuorodos įkėlimo pavyzdys.
  • Analogiškai kaip tose ataskaitose, pakoreguojama kliento naudojama sąskaitos faktūros forma :

    • papildomas ataskaitos INIT - įkeliamas nuorodos stulpelis :
    ** Nuorodos sugeneravimas **
    IF TYPE(lal+".foxpay_link")#"C"
    LOCAL lcLink
    m.lcLink=foxpay_qr_link_ro(i06_kodas_po, 'Dokumentas #'+alltrim(i06_dok_nr))
    IF EMPTY(m.lcLink)
        RETURN .F.
    ENDIF
    SELECT *, CAST(m.lcLink as M) as foxpay_link FROM (lal) INTO CURSOR (lal) READWRITE
    ENDIF
    
    SELECT (m.lal)
    GO TOP
    • Ataskaitoje įkeliamas Foxpay logotipas ir apmokėjimo tekstas su nuoroda :

foxpay_14

Nuoroda pagal XFRX taisykles aprašoma objekto komentaruose:

#UR A HREF=foxpay_link
  • Norint ataskaitoje suformuoti QR kodą, įdedama komanda paveiksliuko objektui :
bar_kod_gen_qr_full(foxpay_link,330)

Detaliau: bar_kod_gen_qr_full.

FOXPAY_QR_LINK_RO

foxpay_qr_link_ro(Kodas_po,[Paskirtis])
  • Kodas_po - pardavimo operacijos numeris
  • Paskirtis - mokėjimo paskirtis. Gavus pavedimą bus matoma ši mokėjimo paskirtis. Pagal nutylėjimą perduodamas dokumento numeris (sąskaitos faktūros numeris).

Naudojimo pavyzdys :

  m.lcNuoroda = foxpay_qr_link_ro( i06_kodas_po, 'Dokumentas #'+alltrim(i06_dok_nr) )
  * Grąžinama nuoroda:
  * "https://p.foxpay.lt/transaction/choose-payment-method?merchant_id_code=..."