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
    • foxpay-logo.jpg - Foxpay logotipas
  • 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=..."