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

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

Մեկ REST API։ Բոլոր հայկական պրոցեսորները։ Գործարկեք 5 րոպեում։

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

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

REST API

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

JS SDK

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

Webhook-ներ

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

OpenAPI

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

Արագ մեկնարկ

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

Գրանցվեք և ստացեք API բանալին

Ստեղծեք հաշիվ, հաստատեք էլ. փոստը և գեներացրեք API բանալի վահանակից։ Բանալին ցուցադրվում է մեկ անգամ — պահեք այն ապահով տեղում։

auth-header

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

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

POST ուղարկեք /api/v1/payments հասցեին՝ ձեր պատվերի տվյալներով։ Պատասխանում կստանաք checkout_url։

create-payment.sh

curl -X POST https://paynet.am/api/v1/payments \
  -H "X-Paynet-Key: pk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 500000,
    "currency": "AMD",
    "order_id": "ORD-2024-001",
    "processor": "idram",
    "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

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

Ուղարկեք գումարը, արժույթը, պրոցեսորը և callback URL-ը։ Մենք ավտոմատ կերպով կառավարում ենք պրոցեսորին հատուկ արձանագրությունները, կրեդենցիալների ներարկումը և callback-ի ստուգումը։

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

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

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

Կրկնվող հարցումների պաշտպանություն order_id-ի միջոցով

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

Դիտել API-ի ամբողջ ուղեցույցը

create-payment.sh

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

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

Webhook-ներ

Իրական ժամանակի վճարային ծանուցումներ

Paynet-ը ստորագրված webhook բեռնվածք է ուղարկում ձեր վերջնակետին ամեն անգամ, երբ վճարման կարգավիճակը փոխվում է։ Ավտոմատ կրկնություն՝ աստիճանաբար աճող ընդմիջումով, ապահովում է առաքումը։

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

Ավտոմատ կրկնություն՝ ընդմիջումով

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

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

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

webhook-payload.sh

# Webhook delivery
POST https://shop.am/webhooks/paynet
X-Paynet-Signature: sha256=abc123...
X-Paynet-Delivery: dlv_018e7b2c...

{
  "event": "payment.completed",
  "transaction": {
    "uuid": "018e7b2c-...",
    "order_id": "ORD-2024-001",
    "amount": 500000,
    "currency": "AMD",
    "status": "completed",
    "processor": "idram"
  }
}

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

Մշակեք լիարժեք sandbox-ի վրա

Յուրաքանչյուր հաշիվ ունի թեստային API բանալիներ (թեստային նշիչով)։ Թեստային բանալիով ստեղծված վճարումներն անցնում են կեղծ պրոցեսորով՝ առանց իրական գումարի շարժի և առանց ակտիվ բաժանորդագրության։ Դրանք տեսնելու համար ձեր վահանակի գործարքներում անցեք Թեստ ներդիր։

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

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

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

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

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

# Հաստատված վճարում
4111 1111 1111 1111
# Մերժված թողարկողի կողմից
4000 0000 0000 0002
# Անբավարար միջոցներ
4000 0000 0000 0069
# Պրոցեսորի սպասման ժամկետ
4000 0000 0000 0119

JavaScript SDK

Ներդրեք վճարման էջը ձեր կայքում

Բեռնեք մեր թեթևաչափ JS SDK-ն և բացեք վճարման էջը որպես ներդիր, մոդալ կամ ամբողջ էջի վերահղում։ Երեք ռեժիմ, մեկ script թեգ։

Ներդիր

Ներդրեք ձեր էջի 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 բանալին և սկսեք ընդունել վճարումներ 5 րոպեից պակաս ժամանակում։