Աշխատում է հետևյալի հետ

Ավելացրեք հայկական վճարումներ ցանկացած կայքի կամ հավելվածի

Եթե ձեր կայքը կամ հավելվածը կառուցված է սեփական կոդի վրա, կարող եք մեկ անգամ ինտեգրվել Paynet REST API-ի հետ և ստանալ վճարման բոլոր հասանելի եղանակները՝ ARCA ցանցի քարտեր, Idram, Telcell և ArcaQR։ Բոլոր վճարումները կատարվում են հայկական դրամով (AMD)։ Վճարում ստեղծելու համար անհրաժեշտ է ընդամենը մեկ POST հարցում, որից հետո գնորդը տեղափոխվում է հյուրընկալված վճարման էջ։ Պատվերի վճարման կարգավիճակը ցանկացած պահի կարող եք ստուգել մեկ GET հարցման միջոցով։ Եթե ցանկանում եք գնորդին պահել ձեր կայքի էջում, հասանելի է նաև JavaScript SDK՝ վճարումը ներդիրով կամ մոդալ պատուհանում ցուցադրելու համար։

Ստեղծել անվճար հաշիվ Կարդալ մշակողների փաստաթղթերը

Ինչպես է աշխատում

  1. 01

    Ստեղծեք API բանալին Paynet-ի վահանակում։ Այն ցուցադրվում է միայն մեկ անգամ, ուստի անմիջապես պահպանեք այն միջավայրի փոփոխականում։ API բանալին երբեք մի տեղադրեք բրաուզերում աշխատող կոդում կամ հանրային հասանելի ֆայլերում։ Թեստային API բանալու օգտագործման դեպքում վճարումները ավտոմատ կերպով կատարվում են Sandbox միջավայրում։

  2. 02

    Վճարումը ստեղծեք ձեր սերվերի կողմից՝ ուղարկելով POST /api/v1/payments հարցում։ Հարցման մեջ փոխանցեք ամբողջական դրամային գումարը, ձեր համակարգում ստեղծված պատվերի ID-ն և նախապես հաստատված դոմենի վրա գտնվող վերադարձի URL-ը։

  3. 03

    Վճարման ստեղծումից հետո ստացված checkout_url-ը փոխանցեք գնորդին, որպեսզի նա անցնի հյուրընկալված վճարման էջ։ Եթե օգտագործում եք JavaScript SDK, կարող եք նույն URL-ը փոխանցել SDK-ին և վճարման էջը բացել անմիջապես ձեր կայքում՝ ներդիրի կամ մոդալ պատուհանի միջոցով։

  4. 04

    Գնորդի վերադարձից հետո վճարման վերջնական կարգավիճակը ստուգեք՝ ուղարկելով GET /api/v1/orders/{order_id}/payment հարցումը։ Մի հիմնվեք միայն գնորդի վերադարձի կամ վերահղման փաստի վրա․ պատվերը վճարված համարեք միայն API-ից ստացված հաստատված կարգավիճակի հիման վրա։

  5. 05

    Ստուգեք X-Paynet-Signature վերնագիրը՝ այն համեմատելով հում request body-ի համար հաշվարկված HMAC-SHA256 արժեքի հետ։ Ստորագրությունը ներկայացվում է փոքրատառ տասնվեցական ձևաչափով։ Յուրաքանչյուր webhook մշակեք միայն մեկ անգամ՝ օգտագործելով առաքման ID-ն կրկնվող հաղորդագրությունները տարբերակելու համար։ Արագ պատասխանեք HTTP 200-ով, ապա Paynet API-ից կրկին ստուգեք վճարման կարգավիճակը և միայն դրանից հետո պատվերը նշեք որպես վճարված։

Ինչ է անհրաժեշտ

  • Սերվեր, որը կարող է անվտանգ պահել գաղտնի բանալին և ընդունել HTTPS callback-ներ։
  • Paynet-ում հաստատված դոմեն, որի վրա պետք է գտնվեն վերադարձի, չեղարկման և callback URL-ները։
  • Համապատասխան վճարային մատակարարի կրեդենցիալներ՝ ձեր կողմից առաջարկվող վճարման եղանակների համար։
  • Բիզնեսի ստուգման ավարտված գործընթաց՝ իրական վճարումների ակտիվացումից առաջ։

Paynet-ը գանձում է 20 ֏ յուրաքանչյուր հաջողված իրական վճարման համար և առանձին վճար՝ ֆիսկալ կտրոնի համար։ Ամսական վճար կամ գործարքի գումարից տոկոսային միջնորդավճար չկա։ Ձեր բանկի կամ դրամապանակի մատակարարի էքվայրինգի վճարը հաշվարկվում է առանձին։

Վճարման եղանակներ, որոնք կարող եք առաջարկել

Idram Ընդունեք Idram վճարումներ ձեր կայքում Telcell Ընդունեք Telcell վճարումներ ձեր կայքում ARCA բանկային քարտեր Ընդունեք Visa, Mastercard և ArCa քարտեր առցանց ArcaQR Ընդունեք վճարումներ QR-ով բանկային հավելվածից

Հարցեր

Հիմնական ինտեգրման համար պետք է չորս endpoint և մեկ webhook՝ վճարում ստեղծելու, այն UUID-ով կամ ձեր պատվերի ID-ով ստուգելու և գումարը վերադարձնելու համար։ Վճարման հղումների, մնացորդի և հասանելի վճարման եղանակների endpoint-ները լրացուցիչ են և պարտադիր չեն։
Վճարում ստեղծելիս յուրաքանչյուր գործողության համար ուղարկեք եզակի Idempotency-Key։ Եթե նույն բանալիով հարցումը կրկնվում է 24 ժամվա ընթացքում, API-ն վերադարձնում է արդեն ստեղծված սկզբնական վճարումը և չի ստեղծում նոր գործարք։ Idempotency-Key աջակցվում է նաև վերադարձների համար։ Webhook-ների դեպքում կրկնվող առաքումները տարբերակելու համար օգտագործեք դրանց delivery ID-ն։
Գործնականում կարող եք թեստավորել ամբողջ վճարման հոսքը։ Օգտագործեք թեստային API բանալի կամ Sandbox մատակարար, իսկ համապատասխան թեստային քարտի համարով կարող եք ստուգել տարբեր արդյունքներ՝ հաջողված վճարում, թողարկողի կողմից մերժում, անբավարար միջոցներ, պրոցեսորի timeout, 3-D Secure-ի ձախողում և այլ սցենարներ։ Թեստային webhook-ները փոխանցվում են livemode=false արժեքով։ Իրական գումար չի գանձվում, իսկ թեստային վճարումները Paynet-ի վահանակում ցուցադրվում են առանձին բաժնում։
API-ի ներկայիս տարբերակը v1 է և պահպանվում է որպես v1։ Փոփոխությունները կատարվում են հավելումային եղանակով՝ գոյություն ունեցող դաշտերը չեն հեռացվում, չեն վերանվանվում և չեն փոխում իրենց տիպը։ Սխալի կոդերի նշանակությունը նույնպես չի փոխվում, իսկ webhook-ի payload-ներում կարող են ավելացվել միայն նոր դաշտեր։ Փոփոխություն, որը կարող է պահանջել գործող ինտեգրման փոփոխություն, նախապես հայտարարվում է առնվազն 90 օր առաջ՝ էլ. փոստով և փոփոխությունների մատյանում։ Նոր, ձեզ անծանոթ դաշտերը կարող եք պարզապես անտեսել։

Ընդունեք ձեր առաջին վճարումն արդեն այսօր

Ստեղծեք ձեր հաշիվը, միացրեք արդեն իսկ օգտագործվող վճարային մատակարարներին և նախապես փորձարկեք ամբողջ վճարման հոսքը։ Թեստավորման ընթացքում գումար չի գանձվում։ Նոր հաշիվները ներառում են անվճար գործարքներ և ֆիսկալ կտրոններ, իսկ իրական վճարումներ ընդունելու հնարավորությունը ակտիվանում է բիզնեսի հաստատումից հետո։

Ստեղծել անվճար հաշիվ

Idram, Telcell, ARCA, ArcaQR անվանումները, ինչպես նաև այս էջում նշված բանկերի և հարթակների անունները իրենց համապատասխան սեփականատերերի ապրանքային նշաններն են։ Paynet-ը առցանց վճարումների հարթակ է և որևէ կերպ կապված, փոխկապակցված կամ հաստատված չէ նշված ընկերություններից որևէ մեկի կողմից։