Ինտեգրեք Paynet checkout-ը 15 րոպեում

Այս ուղեցույցը ձեզ կտանի մեկնարկից մինչև աշխատող վճարում մոտ տասնհինգ րոպեում։ Դուք կստեղծեք վճարում, կուղղեք գնորդին checkout-ի էջ և կհաստատեք արդյունքն webhook-ի միջոցով — ամեն ինչ թեստ ռեժիմում, այնպես որ ոչ մի իրական գումար չի փոխանցվի։

1. Ստացեք թեստային API բանալի

Ձեր վահանակում ստեղծեք թեստային API բանալի։ Թեստային բանալիները հստակ նշված են և ստեղծում են sandbox գործարքներ, որոնք անցնում են ֆիկտիվ պրոցեսորի միջոցով — կատարյալ մշակման համար։

2. Ստեղծեք վճարում

Ուղարկեք մեկ հարցում՝ գումարով (հայկական դրամով), ձեր պատվերի ID-ով և գնորդին վերադարձնելու հղումով.

curl https://paynet.am/api/v1/payments \
  -H "X-Paynet-Key: sk_test_..." \
  -d amount=5000 \
  -d currency=AMD \
  -d order_id=ORD-1001 \
  -d return_url=https://shop.am/return \
  -d callback_url=https://shop.am/webhooks/paynet \
  -d processor=arca

Պատասխանը պարունակում է checkout_url։ Վերահղեք գնորդին դեպի այն։

3. Օգտագործեք կախարդական թեստային քարտերը

Sandbox checkout-ում կարող եք նմանակել ցանկացած արդյունք հետևյալ համարներով.

• 4111 1111 1111 1111 — հաստատված
• 4000 0000 0000 0002 — մերժված
• 4000 0000 0000 0069 — անբավարար միջոցներ
• 4000 0000 0000 0119 — պրոցեսորի ժամկետի լրացում

4. Ստուգեք webhook-ը

Երբ վճարումն ավարտվում է, Paynet-ը POST-ով ուղարկում է ստորագրված payload ձեր callback_url-ին.

{ "event": "payment.completed", "livemode": false, "transaction": { "status": "completed", "amount": 5000 } }

Ստուգեք X-Paynet-Signature վերնագիրը (HMAC-SHA256՝ ձեր webhook secret-ով) մինչև body-ին վստահելը։ Ստորագրության ստուգումը միակ քայլն է, որը երբեք չպետք է բաց թողնել։

5. Անցեք live ռեժիմի

Փոխեք թեստային բանալին live բանալիով, ուղղեք ձեր խանութն իրական պրոցեսորներին, և կստանաք իրական վճարումներ։ Հենց նույն կոդի ճանապարհը, որը նոր թեստավորեցիք, կաշխատի production-ում — վերաշարադրում չի պահանջվում։