Հրապարակվել է September 1, 2026 VPOS.am ինտեգրման թիմ 7 րոպե ընթերցում

VPOS.am 0.2.5-ը CS-Cart-ի համար՝ ArCa iPay և EPG վճարումներ

Add-on-ը CS-Cart պատվերը կապում է բանկային checkout-ին և այն թարմացնում միայն սերվերում ստուգված արդյունքից հետո։

VPOS.am 0.2.5-ը CS-Cart-ի համար՝ ArCa iPay և EPG վճարումներ

Հոդվածի ֆոկուսը

VPOS.am 0.2.5-ը CS-Cart-ի համար՝ ArCa iPay և EPG վճարումներCMS, CRM և ERP ինտեգրումներCS-Cart վճարումներ ՀայաստանCS-Cart vPOS ինտեգրումMulti-Vendor վճարումներ Հայաստան

Գնորդը անմիջապես անցնում է բանկային checkout

0.2.5 տարբերակը հեռացնում է ավելորդ միջանկյալ էջը․ payment session ստեղծելուց հետո CS-Cart-ը գնորդին ուղղորդում է բանկի տրամադրած hosted checkout հասցեին։

CS-Cart -> VPOS.am -> բանկային checkout
Պատվերը պահպանվում է մինչև redirect-ը, իսկ քարտի տվյալները մուտքագրվում են բանկի արտաքին էջում, ոչ թե խանութում։

Manifest-ում հայտարարված նպատակային միջակայքը CS-Cart և Multi-Vendor 4.14.1–4.20.1-ն է։ Սա փաթեթի համատեղելիության հայտարարված միջակայքն է, ոչ թե պնդում, որ յուրաքանչյուր միջանկյալ build անցել է առանձին certification։ Կոնկրետ licensed store-ը պետք է անցնի pilot։

Կարգավորման համար administrator-ը VPOS.am Console-ում ստեղծում է մեկանգամյա setup token և այն տեղադրում payment method-ում։ Merchant token-ը, webhook secret-ը և reconciliation secret-ը ներմուծվում են server-side․ բանկի Client ID-ն, login-ը և password-ը CMS-ում պահելու կամ մուտքագրելու կարիք չկա։

  • առանց լրացուցիչ միջանկյալ էջի՝ բանկային checkout-ից առաջ;
  • order id-ի, payment id-ի, գումարի, արժույթի և storefront-ի կայուն կապ;
  • առանձին test և live bindings՝ առանց live-ի ավտոմատ ակտիվացման;
  • add-on-ի թարմացում՝ առանց բանկային secret-ների կրկնակի մուտքագրման։

Պատվերի կարգավիճակը փոխվում է միայն server-side ստուգումից հետո

Browser return-ը գնորդին ցույց է տալիս արդյունքը, բայց CS-Cart-ի համար վճարման ապացույց չէ։

Ստորագրված webhook + reconciliation -> պատվերի կարգավիճակ
Backend-ը ստուգում է ստորագրությունը, payment id-ն, order reference-ը, գումարը, արժույթը և թույլատրելի status transition-ը։

VPOS.am-ը ուղարկում է ստորագրված notification, իսկ add-on-ը ստուգում է այն և կանխում կրկնակի մշակումը։ Webhook-ի կրկնությունը չպետք է նորից նվազեցնի մնացորդը, փոխի պատվերը կամ երկրորդ նամակ ուղարկի։ Բաց թողնված իրադարձության դեպքում reconciliation-ը հարցնում է server-side կարգավիճակը և վերականգնում համաձայնեցված վիճակը։

ArCa iPay և SmartVista EPG route-երը, ներառյալ Ամերիաբանկի, Էվոկաբանկի, Ակբայի և Հայաստանի այլ բանկերի սցենարները, ակտիվացվում են միայն merchant պայմանագրով, բանկի տրամադրած endpoint-ով և credentials-ով ու ավարտված pilot-ից հետո։ Բանկի հիշատակումը նկարագրում է route-ի աջակցվող ճարտարապետությունը, ոչ թե գործընկերություն կամ յուրաքանչյուր terminal-ի ավտոմատ պատրաստ լինելը։

  • ստորագրված webhook և կրկնակի մշակման պաշտպանություն;
  • payment id-ի, order reference-ի, գումարի և արժույթի ստուգում;
  • reconciliation՝ բաց թողնված կամ ուշացած notification-ների համար;
  • առանձին կարգավիճակներ հաջող վճարման, մերժման, չեղարկման և վերադարձի համար։

Ինչ է ներառում 0.2.5-ը և ինչի համար է պետք առանձին ինտեգրում

Մոդուլը լուծում է hosted checkout-ը և պատվերի ստուգված կարգավիճակները՝ առանց բանկային contract-ից դուրս հնարավորություններ խոստանալու։

Փաթեթ, pilot և production gates
CMS տարբերակը, պայմանագիրը, credentials-ը, callback-ը, reconciliation-ը և test սցենարները ստուգվում են մինչև live։

Ընթացիկ տարբերակը CS-Cart-ից refund չի նախաձեռնում, recurring charge չի կատարում և Multi-Vendor վաճառողների միջև split settlement չի իրականացնում։ Provider-ի հաստատած refund status-ը կարող է արտացոլվել պատվերի հոսքում, սակայն վերադարձի գործողության նախաձեռնումը մնում է առանձին բանկային կամ օպերացիոն գործընթաց։

0.2.5 փաթեթը պատրաստվել է վերահսկվող pilot-ների և հրապարակման համար։ Աննոնսի օրվա դրությամբ CS-Cart Marketplace-ում public package delivery-ն դեռ ակտիվ չէ, ուստի չենք հրապարակում չաշխատող download link։ Public listing-ը բացվելուց հետո հղումը կավելացվի ինտեգրման էջում, իսկ մինչ այդ VPOS.am թիմը միացումները ստուգում է հայտով։

  • մինչև live անհրաժեշտ են բանկային պայմանագիր և վավեր test/production credentials;
  • հաջող վճարումը, մերժումը, չեղարկումը, webhook retry-ն և reconciliation-ը ստուգվում են target store-ում;
  • refund initiation-ը, recurring-ը և split settlement-ը չեն մտնում 0.2.5-ի մեջ;
  • production activation-ը կատարվում է առանձին յուրաքանչյուր merchant route-ի համար։

FAQ

CS-Cart-ի ո՞ր տարբերակներն է աջակցում մոդուլը։

Manifest-ը հայտարարում է CS-Cart և Multi-Vendor 4.14.1–4.20.1 նպատակային միջակայքը։ Production-ից առաջ կոնկրետ տարբերակը, PHP runtime-ը, theme-ը և տեղադրված add-on-ները պետք է ստուգվեն licensed store-ում։

Պե՞տք է բանկային password-ը մուտքագրել CS-Cart-ում։

Ոչ։ CS-Cart-ում օգտագործվում է VPOS.am Console-ի մեկանգամյա setup token-ը։ Այն installation binding-ը ներմուծում է server-side, իսկ բանկային credentials-ը մնում է VPOS.am-ի պաշտպանված միջավայրում։

Հիմա հնարավո՞ր է մոդուլը ներբեռնել CS-Cart Marketplace-ից։

Հրապարակման օրվա դրությամբ public package delivery-ն ակտիվ չէ, ուստի Marketplace հղում դեռ չենք ցուցադրում։ Ինտեգրման էջից ուղարկեք հայտ՝ pilot-ը համաձայնեցնելու և release-ի ընթացիկ կարգավիճակը ստանալու համար։

Աղբյուրներ և փաստաթղթեր