Մշակողների փաստաթղթեր

Ստեղծված մշակողների համար

Միացեք հայկական վճարային պրոցեսորներին մեկ REST API-ով և գործարկեք ինտեգրումը հաշված րոպեների ընթացքում։

API-ի ամբողջ փաստաթղթերը Ստանալ API բանալի

REST + JSON HMAC ստորագրված JS SDK

REST API

JSON հարցում / պատասխան

JS SDK

Ներդիր, մոդալ, վերահղում

Webhook-ներ

HMAC-SHA256 ստորագրված

OpenAPI

Ավտոմատ գեներացված փաստաթղթեր

Արագ մեկնարկ

Չորս քայլ՝ գործարկելու համար

Ստեղծեք API բանալի և սկսեք ինտեգրումը

Ստեղծեք հաշիվ, ավելացրեք ձեր դոմենը և վահանակից ստեղծեք API բանալի։ Բանալին ցուցադրվում է միայն մեկ անգամ, այնպես որ պահեք այն ապահով տեղում։ Թեստային բանալիներն աշխատում են անմիջապես։ Իրական API բանալիների և վճարումների համար անհրաժեշտ է անցնել բիզնեսի ստուգում։

auth-header

# Your API key header
X-Paynet-Key: sk_live_a1b2c3d4e5f6...

Ստեղծեք վճարում API-ի միջոցով

Ուղարկեք POST հարցում /api/v1/payments endpoint-ին՝ փոխանցելով գումարը, ձեր պատվերի ID-ն և վերադարձի URL-ը։ Պատասխանում կստանաք checkout_url՝ հաճախորդին վճարման էջ ուղղորդելու համար։ Գումարները փոխանցվում են ամբողջ դրամով։

create-payment.sh

curl -X POST https://paynet.am/api/v1/payments \
  -H "X-Paynet-Key: sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 15000,
    "order_id": "ORD-2024-001",
    "domain": "shop.am",
    "return_url": "https://shop.am/thanks",
    "callback_url": "https://shop.am/webhooks/paynet"
  }'

Տեղափոխեք հաճախորդին վճարման էջ

Ստացված checkout_url-ով ուղղորդեք հաճախորդին վճարման էջ կամ օգտագործեք JS SDK՝ այն անմիջապես ձեր կայքում ներդնելու համար։

Պատասխան · 201 Ստեղծված

response.json

{
  "uuid": "018e7b2c-...",
  "checkout_url": "https://paynet.am/pay/018e7b2c-...",
  "status": "pending"
}

Ստացեք webhook ավարտի դեպքում

Paynet-ը ստորագրված webhook է ուղարկում ձեր callback_url-ին, երբ վճարման կարգավիճակը փոխվում է։ Հաստատեք HMAC-SHA256 ստորագրությունը և թարմացրեք ձեր պատվերը։

REST API

Ստեղծեք վճարումներ մեկ հարցումով

Ուղարկեք գումարը, պատվերի ID-ն և վերադարձի URL-ը։ Գնորդը հյուրընկալվող վճարման էջում ընտրում է վճարման եղանակը, իսկ անհրաժեշտության դեպքում կարող եք նախապես նշել կոնկրետ պրոցեսոր։ Մենք հոգում ենք յուրաքանչյուր մատակարարի API-ի, կրեդենցիալների և callback-ների ստուգման մասին։

JSON հարցում / պատասխան

API բանալու նույնականացում (SHA-256 հեշացված)

Ավտոմատ գեներացված OpenAPI փաստաթղթեր

Իդեմպոտենտ հարցումներ Idempotency-Key վերնագրի միջոցով (24-ժամյա պատուհան)

UUID-հիմնված գործարքների հղումներ

Դիտել API-ի ամբողջ ուղեցույցը OpenAPI spec (JSON, Postman-ի կամ codegen-ի համար) AI հուշում (llms.txt)՝ տեղադրեք այն ChatGPT, Claude կամ Cursor-ում, և թող այն կառուցի ինտեգրումը Postman հավաքածու (ներմուծվում է նաև Insomnia և Bruno ծրագրերում)՝ յուրաքանչյուր հարցում արդեն պատրաստ է, բանալին՝ ընդամենը մեկ փոփոխական

create-payment.sh

# Create a payment
curl -X POST https://paynet.am/api/v1/payments \
  -H "X-Paynet-Key: sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 15000,
    "order_id": "ORD-2024-001",
    "domain": "shop.am",
    "return_url": "https://shop.am/thanks",
    "callback_url": "https://shop.am/webhooks/paynet",
    "processor": "idram"
  }'

# Response: 201 Created
{
  "uuid": "018e7b2c-...",
  "checkout_url": "https://paynet.am/pay/018e7b2c-...",
  "status": "pending"
}

Webhook-ներ

Վճարումների մասին ծանուցումներ՝ իրական ժամանակում

Յուրաքանչյուր վճարման վերջնական կարգավիճակի կամ վերադարձի դեպքում ստացեք ստորագրված webhook ձեր endpoint-ին։ Եթե առաքումը ձախողվում է, Paynet-ը կրկին կփորձի այն ուղարկել՝ 1, 5 և 30 րոպե անց։ Webhook-ը ընդունեք որպես ազդանշան և վերջնական տվյալները հաստատեք API-ից։

HMAC-SHA256 ստորագրված բեռնվածք

Կրկնվում է 1, 5 և 30 րոպե անց

Առաքման մատյաններ վահանակում

Կրկնօրինակներից պաշտպանված առաքման ID-ներ

Ստուգեք X-Paynet-Signature վերնագիրը՝ HMAC-SHA256-ով ձեր webhook գաղտնիքի հետ։

webhook-payload.sh

# Webhook delivery
POST https://shop.am/webhooks/paynet
X-Paynet-Signature: 3f1a9c...  # hex HMAC-SHA256 of the raw body, keyed with your webhook secret

{
  "delivery_id": "9b1d6f0e-...",
  "event": "transaction.status.updated",
  "livemode": true,
  "timestamp": 1787400000,
  "transaction": {
    "uuid": "018e7b2c-...",
    "order_id": "ORD-2024-001",
    "status": "completed",
    "amount": 15000,
    "refunded_amount": 0,
    "currency": "AMD",
    "processor": "idram",
    "completed_at": "2026-08-22T10:00:00+00:00"
  },
  "refund": null,
  "receipt": null
}
# Then confirm before you act: GET /api/v1/orders/ORD-2024-001/payment

Թեստային ռեժիմ

Փորձարկեք ամբողջ ինտեգրումը՝ առանց իրական վճարումների

Օգտագործեք sk_test_... API բանալի կամ ընտրեք Sandbox մատակարարը՝ "processor": "sandbox" պարամետրով։ Sandbox-ը հասանելի է նաև CMS փլագինների միջոցով։ Թեստային միջավայրում բանկային հարցումներ չեն կատարվում, գումար չի տեղափոխվում և որևէ վճար չի գանձվում։ Արդյունքները կարող եք տեսնել Test ներդիրում։

Առանձին թեստային API բանալիներ

Կեղծ պրոցեսոր՝ ակնթարթային արդյունք

Մոգական քարտի համարներ յուրաքանչյուր արդյունքի համար

Իրական/Թեստ փոխարկիչ վահանակում

Մոգական թեստային քարտեր

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

JavaScript SDK

Վճարման փորձառությունը պահեք ձեր կայքում

Ստեղծեք վճարումը ձեր սերվերում և ստացված checkout_url-ը փոխանցեք մեր թեթև JS SDK-ին։ Բացեք վճարման էջը որպես ներդիր, մոդալ ծածկույթ կամ ամբողջ էջի վերահղում՝ երեք ռեժիմով և մեկ script tag-ով: Ձեր գաղտնի API բանալին միշտ մնում է ձեր սերվերում։

Ներդիր

Ներդրեք ձեր էջի container div-ի մեջ

Մոդալ

Ծածկույթ՝ առանց էջից հեռանալու

Վերահղում

Ամբողջ էջի վերահասցեավորում դեպի հյուրընկալ վճարման էջ

checkout.js

<!-- Load the SDK -->
<script src="https://paynet.am/sdk/v1/paynet.js">
</script>

<!-- Container for inline mode -->
<div id="paynet-container"></div>

<script>
Paynet.open({
  checkoutUrl: "{{ checkout_url }}",
  mode: "inline",
  container: "#paynet-container",
  onSuccess: function(data) {
    console.log("Paid:", data.order_id);
  },
  onError: function(error) {
    console.error("Failed:", error.message);
  }
});
</script>

Հարթակի փլագիններ

Ինտեգրումներ առանց կոդ գրելու

Չե՞ք ցանկանում կոդ գրել։ Ընտրեք ձեր հարթակի համար պատրաստի փլագինը, տեղադրեք այն և արագ միացրեք վճարումները։

Սկսեք մշակել

Պատրա՞ստ եք ինտեգրվել

Ստացեք ձեր API բանալին, միացրեք ինտեգրումը և պատրաստ եղեք ընդունել վճարումներ՝ հաշված րոպեների ընթացքում։