Telcell դրամապանակի վճարումներ Ձեր կայքում. տեղադրում, թեստավորում և ինչին ուշադրություն դարձնել
Ինչպես է աշխատում Telcell վճարումը գնորդի ու վաճառողի համար, ինչ Shop ID ու Shop Key եք ստանում Telcell-ից, ինչպես միացնել դրամապանակը Paynet-ում ու խանութի հավելումներում, և ինչպես թեստավորել, երբ դրամապանակը սեփական sandbox չունի։
Telcell-ը մյուս դրամապանակն է, որ հայաստանյան խանութից պարբերաբար հարցնում են, Idram-ի կողքին։ Այն ավելացնելը դժվար չէ, բայց տարբեր է քարտային պրոցեսոր ավելացնելուց այնպիսի ձևերով, որոնք մարդկանց բռնում են անակնկալի. տվյալները տարբեր են, դրամապանակի կողմից թեստային միջավայր չկա, և ստացած հաստատումն է միակ հաշվետվությունն այն մասին, թե ինչ է կատարվել։ Ահա ամբողջ պատկերը՝ պայմանագրից մինչև առաջին կենդանի վճարումը։
Ինչպես է աշխատում Telcell վճարումը
Գնորդի համար.
- Ձեր checkout-ում նրանք ընտրում են Telcell-ը այդ դոմենի համար միացրած մեթոդներից։ Paynet-ի հյուրընկալվող checkout-ում այն ցուցադրվում է որպես դրամապանակ՝ Ձեր ընտրած ցուցադրման անվան տակ։
- Նրանց տանում են Telcell՝ վճարելու, և հենց այնտեղ է կատարվում ամեն ինչ զգայուն։ Ոչինչ դրանից չի անցնում Ձեր սերվերով։
- Telcell-ը հաստատում է վճարումը, և գնորդը վերադառնում է
return_url-ին, որը Դուք սահմանել եք վճարումը ստեղծելիս։ - Ձեր խանութը կարդում է իրական կարգավիճակը API-ից և միայն այնուհետև նշում է պատվերը վճարված։
Ձեզ համար, վաճառողիս, նույն ուղին ունի այլ ձև։ Դուք ստեղծել եք վճարում ամբողջ AMD գումարով և Ձեր սեփական order_id-ով, հանձնել եք գնորդին checkout_url, և հիմա սպասում եք ստորագրված webhook-ի, որն ասում է, որ վճարումը հասել է վերջնական կարգավիճակի։ Մնացած ամեն ինչ հաշվապահություն է։
Ինչ է Ձեզ տալիս Telcell-ը
Դուք ստորագրում եք ուղիղ Telcell-ի հետ, և դրամապանակը հաշվարկում է Ձեզ այդ պայմանագրով։ Paynet-ը գումարը չի պահում և պայմանագիրը չի վերավաճառում։ Այն, ինչ ստանում եք Telcell-ից, տվյալների զույգ է.
- Shop ID
- Shop Key
Դա ամբողջ տվյալների հավաքածուն է։ Երկուսն էլ մտնում են Telcell մատակարարի մեջ, որ ավելացնում եք Ձեր Paynet վահանակում, և երկուսն էլ պահվում են գաղտնագրված։ Եթե ինչ-որ մեկն առաջարկում է դրանք ձեր վեբ սերվերի կարգավորումների ֆայլում մուտքագրել, դա քայլ է դեպի ետ. դրանք դարպասում դնելու իմաստը հենց այն է, որ դրանք ապրում են մեկ գաղտնագրված տեղում, ոչ թե Ձեր վարած ամեն խանութում։
Telcell-ի միացումը Paynet-ում
- Բացեք Մատակարարներ, ընտրեք Ավելացնել մատակարար, ընտրեք Telcell-ը որպես պրոցեսոր, տվեք ցուցադրման անուն և տեղադրեք Shop ID-ն ու Shop Key-ը։
- Միացրեք այդ մատակարարը Ձեր հաստատված դոմենին։ Մատակարարները միացվում ու անջատվում են դոմեն առ դոմեն, ուստի մատակարարը, որ ավելացրել եք, բայց չեք միացրել, ոչ մեկի checkout-ում չի հայտնվի։
- Ստուգեք Դոմեններ էջը։ Այն ցույց է տալիս ակտիվ վճարման մեթոդները դոմեն առ դոմեն և նշում է դոմենը, որտեղ դրանցից չկա։
Երկու վահանակի վարքագիծ արժե իմանալ, նախքան դրանք Ձեզ պետք գան.
- Տվյալների ստուգումներն ազնիվ են իրենց սահմանների մասին։ Որոշ պրոցեսորներ ոչ մի ձև չեն ցուցադրում տվյալները ստուգելու՝ առանց իրական վճարում վերցնելու։ Այնտեղ, որտեղ դա ճիշտ է, վահանակն ասում է հենց դա, ոչ թե ցույց տալիս հանգստացնող կանաչ նշան, որ դեռ չի վաստակել։
- Անհասանելի դարպասները թաքցվում են, ոչ թե թողնվում ձախողվելու։ 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 ՍՊԸ-ի կողմից շահագործվող անկախ վճարային դարպաս է. վաճառողներն ունեն սեփական պայմանագրերն ամեն դրամապանակի ու բանկի հետ։