Թեստավորումը sandbox-ով, և պատրաստվածության ստուգացանկը

Ձեր checkout-ի սխալի մասին ամենավատ ձևով իմանալը հաճախորդի գումարով է։ Paynet-ն ունի լիարժեք sandbox հենց այն պատճառով, որ Ձեր առաջին իրական վճարումը ձանձրալի լինի. Դուք արդեն ճշգրիտ գիտեք, ինչ է կատարվում հաջողության, մերժման, ժամկետի ավարտի և վերադարձի դեպքում, քանի որ դիտել եք դրանցից յուրաքանչյուրը տեղի ունենալիս։

Այս գրառումն անդրադառնում է նրան, թե ինչ է տալիս sandbox-ը, ինչպես վարել այն, ապա ստուգացանկին, որը որոշում է, արդյոք իսկապես պատրաստ եք Հայաստանում կենդանի վճարումներ վերցնելու։

Թեստային և կենդանի բանալիներ

API բանալիներն ունեն միջավայր։ Թեստային բանալին սկսվում է sk_test_-ով և դրանով կատարված ամեն վճարում դարձնում sandbox վճարում։ Կենդանի բանալին սկսվում է sk_live_-ով և վերցնում է իրական գումար։

Ամեն նոր Paynet հաշիվ սկսվում է Default անունով բանալիով։ Այն թեստային բանալի է, ուստի ստեղծում է միայն sandbox վճարումներ։ Կարող եք սկսել ինտեգրվել դրանով անմիջապես, նախքան որևէ ստուգում և նախքան Ձեր բանկային փաստաթղթերի ավարտը։ Ստեղծեք կենդանի բանալի, երբ պատրաստ եք իրական վճարումների։

Բանալիներն ունեն նաև շրջանակ։ Ստեղծելիս ընտրում եք դրանց հասանելիության մակարդակը.

• Ամբողջական հասանելիությունը ստեղծում, կարդում ու վերադարձնում է վճարումներ, և կարող է գնել միավորներ։ Պահեք այն Ձեր սեփական սերվերում։
• Միայն վճարումների համար ստեղծում ու կարդում է վճարումներ և վճարման հղումներ, բայց չի կարող վերադարձնել կամ ծախսել Ձեր մնացորդը։ Հենց դա է ճիշտ բանալին խանութի front-end-ին կամ կապալառուին տալու համար, և այն, ինչ չի կարող անել, ստանում է 403 insufficient_scope։

Բանալիները SHA-256 եղանակով պահվում են գաղտնագրված, և հում արժեքը ցույց է տրվում մեկ անգամ՝ ստեղծելիս։ Պատճենեք այն այդ պահին և պահեք միջավայրի փոփոխականում։ Եթե կորցնեք, չեղարկեք բանալին և ստեղծեք նոր մեկը։

ԵՒս մեկ շրջանակային մանրամասն, որ խնայում է շփոթություն. թեստային բանալին ցուցակում է միայն sandbox վճարումները, և կենդանի բանալին՝ միայն կենդանիները։ Կենդանի վճարումը թեստային բանալիով փնտրելը վերադարձնում է 404, ոչ թե սխալ, որը բացատրում է անհամապատասխանությունը։ Եթե վահանակում տեսնում եք վճարում, որը Ձեր կոդին անտեսանելի է, ստուգեք, թե որ բանալին է օգտագործում Ձեր կոդը։

Sandbox մտնելու երկու ուղի

Երկու դուռ կա, և երկուսն էլ տանում են դեպի նույն սենյակը։

Թեստային API բանալի։ Օգտագործեք sk_test_, և ամեն դրանով ստեղծված վճարում sandbox վճարում է։

Sandbox մատակարարը։ Տեղադրեք այն Ձեր վահանակի Մատակարարներ բաժնից և ուղարկեք "processor": "sandbox"։ Սա նաև աշխատում է CMS հավելումների ներսում, ինչը կարևոր է. հենց այսպես եք թեստավորում իսկական խանութը սկզբից մինչև վերջ, իրական զամբյուղով ու իրական պատվերով, առանց մեկ տող կոդ գրելու։

Ցանկացած դեպքում ոչ մի բանկի հետ կապ չի հաստատվում, գումար չի տեղափոխվում, և ոչինչ չի հաշվարկվում կամ գանձվում։ Թեստային վճարումները հայտնվում են Ձեր վահանակի Test ներդիրում, ուստի երբեք չեն աղտոտում Ձեր եկամտի ցուցանիշները։

Թեստային քարտերը

Թեստային checkout-ում քարտի համարն է որոշում արդյունքը.

Քարտի համար	Արդյունք
4111 1111 1111 1111	Հաստատված
4000 0000 0000 0002	Մերժված թողարկողի կողմից
4000 0000 0000 0069	Անբավարար միջոցներ
4000 0000 0000 0119	Պրոցեսորի սպասման ժամկետ
4000 0000 0000 0101	3-D Secure ձախողում
4000 0000 0000 0127	Գումարի սահմանաչափի գերազանցում
4000 0000 0000 0200	Կրկնվող գործարք
4000 0000 0000 0259	Գործարքի ժամկետի ավարտ
4000 0000 0000 0309	Պրոցեսորն անհասանելի է
4000 0000 0000 0341	Ընդհանուր ձախողում

Ցանկացած այլ տասնվեցանիշ համար հաստատվում է։ Ժամկետը, CVV-ն ու քարտապանի անունը չեն ստուգվում, ուստի մուտքագրեք ինչ ուզեք։

Թեստային պլան, որ արժե վազեցնել

Միայն հաստատված քարտով վազելը գրեթե ոչինչ չի ապացուցում։ Ձախողումներն են այն կետերը, որտեղ խանութները կոտրվում են։ Ողջամիտ նվազագույնը.

1. Հաստատված։ Պատվերը դառնում է վճարված, հաճախորդը տեսնում է հաստատում, պահեստը շարժվում է, նամակն ուղարկվում է։
2. Մերժված թողարկողի կողմից։ Պատվերը վճարված չի դառնում, հաճախորդը կարող է կրկին փորձել, և պահեստից ոչինչ չի ծախսվում։
3. Պրոցեսորի սպասման ժամկետ։ Ձեր կոդը չի կախվում և կրկնակի չի գանձում։ Հենց այս դեպքն է ասում, արդյոք Ձեր ժամկետները և կրկնումները խելամիտ են։
4. Լքված վճարում։ Ստեղծեք վճարում և պարզապես մի վճարեք դրա համար։ Այն ժամկետանց է դառնում 20 րոպե հետո և ուղարկում է webhook՝ expired-ով։ Հաստատեք, որ Ձեր խանութը չեղարկում կամ ազատում է պատվերը։
5. Վերադարձ։ Վերադարձրեք ավարտված sandbox վճարում, լրիվ և մասնակի, և հաստատեք, որ Ձեր գրառումները համընկնում են։ Ուղարկեք Idempotency-Key, որպեսզի ժամկետի ավարտից հետո կրկնությունը վերադարձնի նույն վերադարձը՝ երկրորդ մեկը ստեղծելու փոխարեն։
6. Webhook-ի կրկնում։ Առաքեք նույն իրադարձությունը երկու անգամ և հաստատեք, որ Ձեր handler-ը անտեսում է կրկնօրինակը delivery_id-ի հիման վրա։

Թեստային վճարումներն ուղարկում են webhook-ներ livemode: false-ով, ուստի ամբողջ ծանուցումների ուղին ապացուցելի է՝ նախքան մեկնարկը։ Ամեն դաշտի մանրամասները՝ API տեղեկատուում։

Կենդանի ռեժիմի ստուգացանկը

Sandbox-ի կանաչ վիճակը կենդանի ռեժիմ չի նշանակում։ Հինգ բան կանգնած է Ձեր ու իրական վճարման միջև։

1. Հաստատված դոմեն

Գնորդները կարող են վճարել միայն Ձեր հաստատած դոմենի վրա, և return_url-ը, cancel_url-ը ու callback_url-ը բոլորն էլ պետք է ցույց տան դեպի այն։ Ավելացրեք դոմենը վահանակում և ապացուցեք, որ վերահսկում եք այն. DNS TXT գրառում, պարզ տեքստային ֆայլ Ձեր կայքի արմատում, կամ սեփականության հաստատում։ Եթե խանութ եք միացրել հավելումով, Connect հոսքն արդեն հաստատել է դոմենը Ձեզ համար։

Երկու գործնական նշում. localhost-ը հնարավոր չէ հաստատել, ուստի հաստատեք Ձեր staging հոսթը, եթե ուզում եք թեստավորել այնտեղից։ Եվ սեփականությունը հաստատելը նշանակում է պատասխանատվություն ստանձնել այդ դոմենով անցնող վճարումների համար, ներառյալ chargeback-ի պատասխանատվությունը, ուստի հաստատեք միայն այն դոմենները, որոնք իսկապես Ձերն են։

2. Հաստատված բիզնես

Կենդանի վճարումները բացվում են բիզնեսի ստուգումից հետո։ Դուք ներկայացնում եք Ձեր իրավաբանական բիզնեսի անունը, ՀՎՀՀ-ն, իրավական ձևը, գրանցված հասցեն ու կոնտակտային հեռախոսը, գումարած Ձեր իրավական ձևին համապատասխան փաստաթղթերը՝ պետական գրանցման վկայականը, ՀՎՀՀ վկայականը և լիազորված անձի փաստաթուղթը։ Միայն հաշվի սեփականատերը կարող է ներկայացնել դրանք։

Վերանայումները սովորաբար տևում են մեկից երկու աշխատանքային օր, և որոշումը գալիս է էլ. նամակով ու վահանակում։ Մինչ այդ ամեն ինչ աշխատում է թեստային ռեժիմում, անսահմանափակ անվճար թեստային վճարումներով, ուստի լավ է սա ներկայացնել վաղ և կառուցել, մինչ այն վերանայվում է։

Եթե կանչը վերադարձնում է VERIFICATION_REQUIRED, հենց սա է այն հարցնում։

3. Իրական մատակարար, միացված ու ակտիվացված

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

Օգտագործեք Test credentials Մատակարարներում, որպեսզի Paynet-ը մատակարարից հարցնի, արդյոք Ձեր պահված տվյալները դեռ աշխատում են, փոխանակ դա հայտնաբերելու հաճախորդի հետ։

Որոշ մատակարարներ ունեն սեփական նախապայմաններ իրենց կողմից։ Եթե Ձեր բանկը պահանջում է միացող սերվերի IP հասցեի սպիտակ ցուցակագրում, Paynet-ը ցույց է տալիս Ձեզ ուղարկելու հասցեն, և այդ մատակարարով վճարումները ձախողվում են, մինչև դա անեն։

4. Աշխատող webhook

Դոմենի համար կարգավորեք webhook URL, կամ վճարում ստեղծելիս ուղարկեք callback_url։ Ապա սեղմեք Send test webhook դոմենի webhook կարգավորումներում և հաստատեք, որ առաքման լոգը ցույց է տալիս հաջողություն։

Ձեր handler-ը պետք է ստուգի X-Paynet-Signature HMAC-ը հում մարմնի վրա, պատասխանի 200-ով 10 վայրկյանում, բացառի կրկնօրինակները delivery_id-ի հիման վրա, ապա կարդա վճարումը հետ պատվերի կարգավիճակի endpoint-ով, նախքան ինչ-որ բան վճարված նշելը։ Ձախողված առաքումները կրկնվում են 1, 5 և 30 րոպե անց։

5. Մեկ իրական վճարում, կատարված Ձեր կողմից

Նախքան որևէ բան հայտարարելը, գնեք ինչ-որ բան Ձեր սեփական խանութից իրական քարտով, փոքր գումարով, ապա վերադարձրեք այն։ Սա միակ թեստն է, որ իրապես ներգրավում է Ձեր բանկային պայմանագիրը։

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

Մինչ սրանով զբաղվում եք. էլ. ՀԴՄ

Եթե վաճառում եք հայաստանցի սպառողներին, Ձեզ պետք են հարկային կտրոններ, և ավելի հեշտ է դա ունենալ աշխատող առաջին օրվանից, քան հետո ավելացնել։ Միացրեք Ձեր էլ. ՀԴՄ-ն վահանակում, միացրեք ինքնաշխատ կտրոնները, և ամեն հաջողված վճարում կտրոն է թողարկում իր ստուգման QR կոդով։ Paynet-ով վերցված վճարումների կտրոնները անվճար են։

Կատարեք մեկ ձեռքով կտրոն տեղադրման ընթացքում և կարդացեք այն։ Սխալ հարկային ռեժիմը թողարկում է իրավաբանորեն սխալ կտրոններ, և տեղադրման պահն է, երբ դա բռնելու ժամանակն է։

Ինչ արժե թեստավորելը

Ոչինչ։ Թեստային վճարումներն անվճար են ու անսահմանափակ, ինչպես ստուգված, այնպես էլ չստուգված հաշիվների համար։ Ձախողված վճարումները ոչինչ չեն արժենում, և վերադարձներն անվճար են։ Կենդանի կողմում Paynet-ը գանձում է 20 դրամ ամեն հաջողված վճարման համար, 500 դրամից ցածր վճարումներն անվճար են, և ամեն նոր հաշիվ սկսվում է 200 անվճար գործարքով ու 500 անվճար կտրոնով, որոնք երբեք ժամկետանց չեն դառնում։ Տես գների էջը։

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

1. Գտեք Ձեր Default թեստային բանալին վահանակում, կամ ստեղծեք մեկը, և տեղադրեք միջավայրի փոփոխականում։
2. Տեղադրեք Sandbox մատակարարը և միացրեք այն Ձեր դոմենի համար։
3. Վազեցրեք վերևի վեց դեպքերը, ներառյալ լքված վճարումն ու կրկնօրինակ webhook-ը։
4. Հաստատեք Ձեր դոմենը, ներկայացրեք Ձեր բիզնեսի փաստաթղթերը, և ավելացրեք Ձեր իրական մատակարարի տվյալները, մինչ վերանայումն ընթանում է։
5. Ուղարկեք թեստային webhook, ապա կատարեք մեկ փոքր իրական վճարում և վերադարձրեք այն։

Մշակողների ուղեցույցում կա արագ մեկնարկը, և հավելումների էջն ընդգրկում է առանց կոդի ուղին, եթե չեք ուզում ինքներդ կառուցել ինտեգրումը։

Idram-ը, Telcell-ը, ARCA-ն և նշված բանկերի անունները պատկանում են իրենց տերերին։ Paynet-ը անկախ վճարային դարպաս է։