Բոլոր հոդվածները
8 հուլիսի 2026 թ. · 1 րոպե ընթերցում

Telcell դրամապանակի վճարումներ Ձեր կայքում. տեղադրում, թեստավորում և ինչին ուշադրություն դարձնել

Ինչպես է աշխատում Telcell վճարումը գնորդի ու վաճառողի համար, ինչ Shop ID ու Shop Key եք ստանում Telcell-ից, ինչպես միացնել դրամապանակը Paynet-ում ու խանութի հավելումներում, և ինչպես թեստավորել, երբ դրամապանակը սեփական sandbox չունի։

Telcell-ը մյուս դրամապանակն է, որ հայաստանյան խանութից պարբերաբար հարցնում են, Idram-ի կողքին։ Այն ավելացնելը դժվար չէ, բայց տարբեր է քարտային պրոցեսոր ավելացնելուց այնպիսի ձևերով, որոնք մարդկանց բռնում են անակնկալի. տվյալները տարբեր են, դրամապանակի կողմից թեստային միջավայր չկա, և ստացած հաստատումն է միակ հաշվետվությունն այն մասին, թե ինչ է կատարվել։ Ահա ամբողջ պատկերը՝ պայմանագրից մինչև առաջին կենդանի վճարումը։

Ինչպես է աշխատում Telcell վճարումը

Գնորդի համար.

  1. Ձեր checkout-ում նրանք ընտրում են Telcell-ը այդ դոմենի համար միացրած մեթոդներից։ Paynet-ի հյուրընկալվող checkout-ում այն ցուցադրվում է որպես դրամապանակ՝ Ձեր ընտրած ցուցադրման անվան տակ։
  2. Նրանց տանում են Telcell՝ վճարելու, և հենց այնտեղ է կատարվում ամեն ինչ զգայուն։ Ոչինչ դրանից չի անցնում Ձեր սերվերով։
  3. Telcell-ը հաստատում է վճարումը, և գնորդը վերադառնում է return_url-ին, որը Դուք սահմանել եք վճարումը ստեղծելիս։
  4. Ձեր խանութը կարդում է իրական կարգավիճակը API-ից և միայն այնուհետև նշում է պատվերը վճարված։

Ձեզ համար, վաճառողիս, նույն ուղին ունի այլ ձև։ Դուք ստեղծել եք վճարում ամբողջ AMD գումարով և Ձեր սեփական order_id-ով, հանձնել եք գնորդին checkout_url, և հիմա սպասում եք ստորագրված webhook-ի, որն ասում է, որ վճարումը հասել է վերջնական կարգավիճակի։ Մնացած ամեն ինչ հաշվապահություն է։

Ինչ է Ձեզ տալիս Telcell-ը

Դուք ստորագրում եք ուղիղ Telcell-ի հետ, և դրամապանակը հաշվարկում է Ձեզ այդ պայմանագրով։ Paynet-ը գումարը չի պահում և պայմանագիրը չի վերավաճառում։ Այն, ինչ ստանում եք Telcell-ից, տվյալների զույգ է.

  • Shop ID
  • Shop Key

Դա ամբողջ տվյալների հավաքածուն է։ Երկուսն էլ մտնում են Telcell մատակարարի մեջ, որ ավելացնում եք Ձեր Paynet վահանակում, և երկուսն էլ պահվում են գաղտնագրված։ Եթե ինչ-որ մեկն առաջարկում է դրանք ձեր վեբ սերվերի կարգավորումների ֆայլում մուտքագրել, դա քայլ է դեպի ետ. դրանք դարպասում դնելու իմաստը հենց այն է, որ դրանք ապրում են մեկ գաղտնագրված տեղում, ոչ թե Ձեր վարած ամեն խանութում։

Telcell-ի միացումը Paynet-ում

  1. Բացեք Մատակարարներ, ընտրեք Ավելացնել մատակարար, ընտրեք Telcell-ը որպես պրոցեսոր, տվեք ցուցադրման անուն և տեղադրեք Shop ID-ն ու Shop Key-ը։
  2. Միացրեք այդ մատակարարը Ձեր հաստատված դոմենին։ Մատակարարները միացվում ու անջատվում են դոմեն առ դոմեն, ուստի մատակարարը, որ ավելացրել եք, բայց չեք միացրել, ոչ մեկի checkout-ում չի հայտնվի։
  3. Ստուգեք Դոմեններ էջը։ Այն ցույց է տալիս ակտիվ վճարման մեթոդները դոմեն առ դոմեն և նշում է դոմենը, որտեղ դրանցից չկա։

Երկու վահանակի վարքագիծ արժե իմանալ, նախքան դրանք Ձեզ պետք գան.

  • Տվյալների ստուգումներն ազնիվ են իրենց սահմանների մասին։ Որոշ պրոցեսորներ ոչ մի ձև չեն ցուցադրում տվյալները ստուգելու՝ առանց իրական վճարում վերցնելու։ Այնտեղ, որտեղ դա ճիշտ է, վահանակն ասում է հենց դա, ոչ թե ցույց տալիս հանգստացնող կանաչ նշան, որ դեռ չի վաստակել։
  • Անհասանելի դարպասները թաքցվում են, ոչ թե թողնվում ձախողվելու։ Paynet-ը ամեն ժամ ստուգում է մատակարարի դարպասները։ Եթե մեկը երեք անգամ անընդմեջ անհասանելի է, այն թաքցվում է գնորդներից, մինչև նորից պատասխանի, քանի որ իրական վճարումն այդ մատակարարով, միևնույն է, ձախողվեր։ Դուք վիճակը տեսնում եք Ձեր վահանակում, և գնորդը տեսնում է մնացած մեթոդները՝ կոտրված մեկի փոխարեն։

Թեստավորումը՝ առանց դրամապանակի sandbox-ի

Telcell-ը հանրային թեստային միջավայր չի առաջարկում, ոչ էլ Idram-ը։ Չեք կարող փորձել կեղծ Telcell-ի դեմ։ Ուստի բաժանեք խնդիրը երկուսի։

Առաջին քայլ. ապացուցեք Ձեր ինտեգրումը Sandbox մատակարարով։ Տեղադրեք Sandbox մատակարարը Ձեր վահանակից և ուղարկեք "processor": "sandbox", կամ ստեղծեք API բանալի թեստային միջավայրում, որը սկսվում է sk_test_-ով և դրանով ամեն վճարում դարձնում sandbox վճարում։ Ոչ մի մատակարարի հետ կապ չի հաստատվում, գումար չի տեղափոխվում, ոչինչ չի հաշվարկվում կամ գանձվում։ Թեստային checkout-ում քարտի համարն է որոշում արդյունքը.

  • 4111 1111 1111 1111 հաստատված
  • 4000 0000 0000 0002 մերժված թողարկողի կողմից
  • 4000 0000 0000 0069 անբավարար միջոցներ
  • 4000 0000 0000 0119 պրոցեսորի սպասման ժամկետ
  • 4000 0000 0000 0259 գործարքի ժամկետի ավարտ
  • 4000 0000 0000 0309 պրոցեսորն անհասանելի է

Ցանկացած այլ 16-նիշանոց համար հաստատվում է, և ժամկետը, CVV-ն ու քարտապանի անունը չեն ստուգվում։ Թեստային վճարումները ցուցադրվում են Ձեր վահանակի Test ներդիրում և ուղարկում webhook-ներ livemode: false-ով, ուստի կարող եք ապացուցել ամբողջ ուղին, ներառյալ Ձեր ձախողման մշակումը, նախքան մեկ դրամի շարժվելը։ Sandbox մատակարարը նաև աշխատում է CMS հավելումների ներսում, ուստի խանութը կարելի է թեստավորել ուղիղ այնպես, ինչպես կօգտագործեր գնորդը։

Երկրորդ քայլ. ապացուցեք Telcell տվյալները մեկ փոքր կենդանի վճարումով։ Sandbox-ը ասում է, որ Ձեր կոդը ճիշտ է։ Այն չի կարող ասել, արդյոք Ձեր Shop Key-ը ճիշտ է մուտքագրված։ Երբ sandbox-ի փորձարկումը մաքուր է, վճարեք ինքներդ Ձեզ փոքր գումար Telcell-ով, իրականում։ 500 դրամից ցածր վճարումներն անվճար են Paynet-ի կողմից, ուստի փորձարկումն ինքնին Ձեզ ոչինչ չի արժենում, բացի ինչ որ գանձում է Ձեր սեփական պայմանագիրը։

Հաստատումը՝ մասը, որ պետք է ճիշտ ստանալ

Telcell-ը, ինչպես Idram-ը, ոչ մի կարգավիճակի API չի ցուցադրում, որ կարելի է հետագայում հարցնել։ Ապագայում ուղի չկա հարցնելու դրամապանակին, թե ինչ իրապես եղավ, ուստի հաստատման ուղին պետք է ճիշտ լինի հենց առաջին անգամից։

Հետևեք նույն կարգապահությանը, որի շուրջ կառուցված է API-ն.

  • Երբեք մի վստահեք վերահղմանը։ Գնորդի հասնելը Ձեր շնորհակալության էջ ապացուցում է միայն, որ բրաուզերը նավարկել է, ուրիշ ոչինչ։
  • Ստուգեք ստորագրությունը։ X-Paynet-Signature-ը հում հարցման մարմնի փոքրատառ տասնվեցական HMAC-SHA256 արժեքն է՝ Ձեր webhook գաղտնիքով։ Հաշվարկեք հում բայթերով, համեմատեք հաստատուն ժամանակով, և մերժեք ամեն ինչ, որ չի համընկնում։ Գաղտնիքի փոփոխման ընթացքում X-Paynet-Signature-Next-ը 24 ժամ կրում է ստորագրությունը՝ նոր գաղտնիքով, ուստի ընդունեք որևէ մեկը երկուսից։
  • Բացառեք կրկնօրինակները delivery_id-ի հիման վրա, ապա արագ պատասխանեք 200-ով։ Paynet-ը 2xx-ի համար սպասում է 10 վայրկյան և կրկնում է երեք անգամ՝ 1, 5 և 30 րոպե անց։
  • Հանեք ճշմարտությունը։ Կանչեք GET /api/v1/orders/{order_id}/payment և գործեք, ինչ որ վերադարձնում է։ Այն Ձեզ տալիս է այդ պատվերի ամենավերջնական վճարումը, ուստի վերջնական գրառումը հաղթում է հին սպասման։
  • Սպասեք ուշ նորությունների։ Չվճարված վճարումը ժամկետանց է դառնում 20 րոպե հետո, բայց ուշացած հաստատումը դեռ կարող է failed կամ expired վճարումը տեղափոխել completed-ի։ Միշտ գործեք ըստ վերջին վիճակի, ոչ թե առաջին webhook-ի, որ տեսաք։

Պատրաստի ստուգման կոդ PHP-ով և Node.js-ով API տեղեկատուում է, և նույն հոսքն ամփոփված է մշակողների էջում։

Վերադարձներ և գնորդին տրվող այլ խոստումներ

Նախքան այնպիսի վերադարձի քաղաքականություն գրելը, որ հիշատակում է ակնթարթային հակադարձումներ, ստուգեք, թե ինչ է աջակցում մեթոդը։ Վերադարձի endpoint-ը վերադարձնում է refund_not_supported, երբ պրոցեսորը դարպասով վերադարձ չի կարող մշակել, և refund_in_progress, already_refunded կամ processor_unavailable, երբ կարող է, բայց պահը սխալ է։ Այս կոդերը Ձեր ադմինում վերածեք մարդկային նախադասության, որպեսզի աջակցման թիմն իմանա՝ սպասե՞լ, թե ձեռքով կարգավորել փոխանցում։ Paynet-ի կողմից վերադարձներն ինքնին անվճար են, և վերադարձնելը հետ չի տալիս Ձեր ծախսած գործարքի միավորը. դա հաջողված վճարում էր, երբ տեղի ունեցավ։

Telcell-ը խանութի հավելումներում

Եթե Ձեր խանութն աշխատում է WooCommerce, OpenCart 2, 3 կամ 4, PrestaShop, Tilda կամ Ecwid-ի վրա, Դուք ինքներդ ոչինչ չեք գրում։ Տեղադրեք հավելումը կամ միացրեք կապիչը, մեկ անգամ սեղմեք Connect, և Paynet-ում միացրած ամեն պրոցեսոր հայտնվում է checkout-ում՝ իր անվանված տարբերակով։ Հավելումները webhook-ը վերաբերում են որպես ազդանշան և հանում են իսկական կարգավիճակը Ձեր Paynet հաշվից՝ նախքան պատվերն ավարտելը, ուստի կեղծված ծանուցումը չի կարող պատվերը վճարված նշել։ Հարթակ առ հարթակ հրահանգները հավելումների էջում են։

Ինչ անել հաջորդը

  • Հարցրեք Telcell-ից Ձեր Shop ID-ն ու Shop Key-ը, եթե դեռ չեք ստացել։
  • Ավելացրեք Telcell-ը որպես մատակարար Paynet-ում և միացրեք Ձեր հաստատված դոմենին։
  • Վազեցրեք sandbox-ի ամբողջական փորձարկումը, ներառյալ առնվազն մեկ մերժված ու մեկ ժամկետը լրացած վճարում, որպեսզի Ձեր ձախողման ուղին իրական կոդ լինի, ոչ թե գուշակություն։
  • Վերցրեք մեկ կենդանի վճարում 500 դրամից պակաս Telcell-ով և հաստատեք, որ այն հայտնվում է վճարված Ձեր խանութում, վահանակում և հարկային կտրոնի վրա, եթե էլ. ՀԴՄ-ն ակտիվ է։
  • Որոշեք, ինչ է անում Ձեր ադմինը ամեն վերադարձի սխալի կոդի հետ, նախքան հաճախորդը հարցնի։
  • Ինչ-որ բան անհասկանալի է, գրեք [email protected]։

Telcell-ը իր տիրոջ ապրանքանիշն է։ Paynet-ը Երևանում գործող Digital Brains ՍՊԸ-ի կողմից շահագործվող անկախ վճարային դարպաս է. վաճառողներն ունեն սեփական պայմանագրերն ամեն դրամապանակի ու բանկի հետ։