Idram առցանց խանութների համար. հոսքը, տվյալները և ինչպես միացնել

Եթե վաճառում եք հայաստանցի սպառողներին, Ձեր գնորդների որոշ մասը կնախընտրի վճարել դրամապանակից, քան մուտքագրել քարտի համար։ Idram-ը այն դրամապանակներից մեկն է, որ նրանք օգտագործում են ամեն օր, և այն checkout-ին ավելացնելը տարբեր աշխատանք է, քան քարտային պրոցեսոր ավելացնելը։ Տարբեր պայմանագիր, տարբեր տվյալներ, տարբեր ձախողման ձևեր։ Այս գրառումն անդրադառնում է երեքին էլ։

Ինչ է տեսնում գնորդը

Գնորդի փորձառությունը կարճ է, և կարևոր է հասկանալ այն, քանի որ դա փոփոխում է, թե ինչ կարող է խոստանալ Ձեր պատվերի էջը։

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

4-րդ քայլը կամընտիր զարդարանք չէ։ Գնորդի վերադարձը Ձեր շնորհակալության էջ բրաուզերի վերահղում է, և բրաուզերները փակվում են, թարմացվում և կիսվում։ Կարգավիճակը, որի հիման վրա գործում եք, պետք է գա API-ից, ոչ թե այն փաստից, որ ինչ-որ մեկը հասել է URL-ին։

Ինչ է Ձեզ պետք Idram-ից

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

Տվյալները։ Idram-ը թողարկում է EDP Account ID, դաշտ, որը հաճախ նշվում է EDP_REC_ACCOUNT-ով, և գաղտնի բանալի։ Դա ամբողջ հավաքածուն է։ Paynet-ում դրանք մտնում են Idram-ի համար Ձեր ավելացրած մատակարարի մեջ և պահվում գաղտնագրված։

URL-ները։ Idram-ը նաև պահանջում է գրանցել երեք հասցե Ձեր վաճառողի հաշվին.

• Result URL, որով Idram-ը հաստատում է վճարումը,
• Success URL, ուր ուղարկվում է վճարած գնորդը,
• Fail URL, ուր ուղարկվում է չվճարած գնորդը։

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

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

Հենց ունենաք տվյալները, վահանակի մասը տևում է մի քանի րոպե։

1. Բացեք Մատակարարներ և ընտրեք Ավելացնել մատակարար։ Ընտրեք Idram-ը որպես պրոցեսոր, տվեք ցուցադրման անուն (սա այն անունն է, որ գնորդները տեսնում են checkout-ում, ուստի պահեք այն ճանաչելի) և տեղադրեք EDP Account ID-ն ու գաղտնի բանալին։
2. Միացրեք մատակարարը Ձեր հաստատված դոմենին։ Դոմենին չմիացված մատակարարը այդ դոմենի checkout-ում չի հայտնվի։
3. Ստուգեք Դոմեններ էջը։ Ամեն դոմեն ցույց է տալիս, թե որ մեթոդներն են ակտիվ, և դոմենը, որտեղ ակտիվ մեթոդ չկա, ցույց է տալիս «Վճարման մեթոդ չկա»՝ գնորդի հաշվին լուռ ձախողվելու փոխարեն։

Մի բան, որ կնկատեք. ոչ ամեն պրոցեսորի տվյալները կարելի է ստուգել առանց իրական վճարում վերցնելու։ Այնտեղ, որտեղ դա այդպես է, վահանակն ասում է հենց դա, փոխանակ ձևացնելու, թե ստուգում է դրանք։ Այդ ազնվությունը կարևոր է դրամապանակների համար, և հենց դա բերում է Ձեզ ուղիղ դեպի թեստավորումը։

Թեստավորումը, երբ դրամապանակը թեստային միջավայր չունի

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

Այն, ինչ կարող եք անել, երկու բան բաժանելն է, որոնք իրականում ուզում եք ապացուցել.

Ապացուցեք Ձեր ինտեգրումը Sandbox մատակարարով։ Տեղադրեք Sandbox մատակարարը Ձեր վահանակից և կամ ուղարկեք "processor": "sandbox", կամ օգտագործեք թեստային API բանալի, որը սկսվում է sk_test_-ով։ Ոչ մի բանկի կամ դրամապանակի հետ կապ չի հաստատվում, գումար չի տեղափոխվում, և ոչինչ չի հաշվարկվում Ձեր մնացորդից։ Թեստային checkout-ում քարտի համարն է որոշում արդյունքը՝ 4111 1111 1111 1111-ը հաստատված է, 4000 0000 0000 0002-ը մերժված է թողարկողի կողմից, 4000 0000 0000 0119-ը պրոցեսորի սպասման ժամկետ է, և կան համարներ անբավարար միջոցների, ժամկետանց գործարքների ու ընդհանուր ձախողման համար։ Հենց այսպես եք ապացուցում Ձեր պատվերի հոսքը, webhook-ի մշակումը և շնորհակալության էջը՝ նախքան իրական գումարը մասնակցելը։ Այն աշխատում է նաև CMS հավելումների ներսում, ուստի կարող եք թեստավորել իրական խանութը սկզբից մինչև վերջ։

Ապացուցեք Idram-ի տվյալները մեկ փոքր իրական վճարումով։ Երբ sandbox-ի փորձարկումը մաքուր է, ինքներդ վերցրեք մեկ կենդանի վճարում Idram-ով։ Paynet-ի գնագոյացումն այստեղ օգնում է. 500 դրամից ցածր վճարումներն անվճար են, ուստի փոքր ինքնաթեստը Paynet-ի կողմից ոչինչ չի արժենում։ Հաստատեք, որ պատվերն ավարտվում է Ձեր խանութում, գործարքը հայտնվում է Ձեր վահանակում, և հարկային կտրոն է թողարկվում, եթե Ձեզ մոտ էլ. ՀԴՄ-ն ակտիվ է։

Վճարումների ճիշտ հաստատումը

Դրամապանակները մեկ ճարտարապետական կետ են դարձնում անխուսափելի։ Idram-ը ոչ մի կարգավիճակի API չի ցուցադրում, որը Paynet-ը կարող է հարցնել՝ «Սա իրո՞ք վճարվել է» հետագայում։ Հաստատումը հենց հաստատումն է։ Դրանից հետո ամեն ինչ, հետևաբար, պետք է հուսալի լինի։

Օրինաչափությունը, որի շուրջ կառուցված է API-ն, հետևյալն է. webhook-ը՝ որպես ազդանշան, API-ն՝ որպես ճշմարտություն.

1. Paynet-ը webhook է ուղարկում վճարման callback_url-ին, կամ դոմենի webhook URL-ին, ամեն վերջնական կարգավիճակի ու վերադարձների ժամանակ։
2. Դուք ստուգում եք X-Paynet-Signature վերնագիրը, որը հում հարցման մարմնի փոքրատառ տասնվեցական HMAC-SHA256 արժեքն է՝ Ձեր webhook գաղտնիքով։ Հաշվարկեք այն հում բայթերով, երբեք ոչ JSON-ի կրկին կոդավորված պատճենով, և համեմատեք հաստատուն ժամանակի ֆունկցիայով։
3. Բացառեք կրկնօրինակները delivery_id-ի հիման վրա, արագ պատասխանեք 200-ով, ապա կանչեք GET /api/v1/orders/{order_id}/payment՝ իսկական վիճակը կարդալու համար, նախքան պատվերին դիպչելը։

Paynet-ը 2xx-ի համար սպասում է 10 վայրկյան, չի հետևում վերահղումներին և կրկնում է երեք անգամ՝ 1, 5 և 30 րոպե անց։ Եթե ավարտված կամ վերադարձված վճարման առաքումը վերջնականապես ձախողվում է, Ձեզ էլ. նամակ է ուղարկվում, առավելագույնը մեկ անգամ ամեն դոմենի համար 6 ժամում։

Երկու կենսացիկլային մանրամասն այստեղ իրական գումար է խնայում։ Չվճարված վճարումը ժամկետանց է դառնում 20 րոպե հետո, և ուշացած մատակարարի հաստատումը կարող է failed կամ expired վճարումը տեղափոխել completed-ի։ Միշտ գործեք ըստ Ձեր կարդացած վերջին վիճակի։

Ստորագրության ստուգման աշխատող կոդը՝ PHP-ով և Node.js-ով, API տեղեկատուում է։

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

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

Հավելումները նույն զգուշությամբ են վերաբերվում հաստատմանը, ինչ պահանջում է API-ն Ձեզանից։ Webhook-ը միայն ազդանշան է՝ պատվերը կրկին ստուգելու համար, և խանութն այնուհետև հանում է իսկական կարգավիճակը Ձեր Paynet հաշվից՝ նախքան ինչ-որ բան ավարտելը։ Կեղծված webhook-ը չի կարող պատվերը վճարված նշել։

Հարկային կտրոններ դրամապանակի վաճառքների համար

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

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

• Հարցրեք Idram-ի Ձեր կոնտակտից Ձեր EDP Account ID-ն ու գաղտնի բանալին, եթե դեռ չունեք։
• Ավելացրեք Idram-ը որպես մատակարար Paynet-ում, պատճենեք Result, Success և Fail URL-ները այդ էջից և ուղարկեք Idram-ին գրանցելու համար։
• Միացրեք մատակարարը հաստատված դոմենին և հաստատեք, որ դոմենը ցույց է տալիս Idram-ը որպես ակտիվ մեթոդ։
• Վազեցրեք Sandbox մատակարարը սկզբից մինչև վերջ, ներառյալ Ձեր webhook handler-ը և շնորհակալության էջը։
• Վերցրեք մեկ փոքր կենդանի վճարում Idram-ով, 500 դրամից քիչ, և ստուգեք, որ այն վճարված է հայտնվում Ձեր խանութում ու վահանակում։
• Ճանապարհին ծագող հարցերն ուղարկեք [email protected]։

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