Ödəniş Yaratma

Alıcının IBAN-ına B2B bank köçürməsi yaradın.

POST

***

Sorğu Parametrləri

Name	Type	Description
`public_key`Required	`String`	Merchant public key.
`order_id`Required	`String`	Merchant tərəfindən yaradılan unikal sifariş identifikatoru. Response-da geri qaytarılır və status izləmə üçün istifadə olunur.
`amount`Required	`Number`	Köçürmə məbləği. Min: `0.01`, Maks: `40000`.
`description`Required	`String`	Ödəniş açıqlaması. Maks 255 simvol.
`iban`Required	`String`	Alıcı IBAN. `AZ` ilə başlamalıdır. Nümunə: `AZ29ABCD38053AZN00A7100186514`.
`name`Required	`String`	Alıcının adı. Maks 255 simvol.
`tin`Required	`String`	Alıcının VÖEN-i. 10 rəqəm, son rəqəm `1` (fiziki) və ya `2` (hüquqi). Nümunə: `1234567891`.
`bank_code`Required	`String`	Alıcı bank kodu. Nümunə: `505141`.
`bank_name`Optional	`String`	Alıcı bank adı.
`email`Optional	`String`	Alıcının e-poçtu.
`address`Optional	`String`	Alıcının ünvanı.
`additional_info`Optional	`String`	Əlavə məlumat.
`bulk_description`Optional	`String`	Bulk ödəniş açıqlaması.
`webhook_url`Optional	`String`	Terminal statusda bildiriş üçün URL.

Sorğu Nümunəsi

Sorğu Göndərmə

Payload

{
  "public_key": "YOUR_PUBLIC_KEY",
  "order_id": "order-20240430-001",
  "amount": "1000.00",
  "description": "Avans ödənişi",
  "iban": "AZ29ABCD000000000000000000000",
  "name": "Texnologiya MMC",
  "tin": "1234567891",
  "bank_code": "505141",
  "bank_name": "Example Bank",
  "webhook_url": "https://yoursite.az/webhooks/epoint-b2b-payment"
}

1DATA=$(echo -n '{"public_key":"YOUR_PUBLIC_KEY","order_id":"order-20240430-001","amount":"1000.00","description":"Avans ödənişi","iban":"AZ29ABCD000000000000000000000","name":"Texnologiya MMC","tin":"1234567891","bank_code":"505141"}' | base64)
2SIGNATURE=$(echo -n "$PRIVATE_KEY$DATA$PRIVATE_KEY" | openssl dgst -sha1 -binary | base64)
3
4curl -X POST *** \
5-H "Content-Type: application/json" \
6-d "{\"data\":\"$DATA\",\"signature\":\"$SIGNATURE\"}"

Cavab Parametrləri

Name	Type	Description
`status`Required	`String`	Əməliyyat nəticəsi: `success` və ya `error`.
`order_id`Optional	`String`	Merchant tərəfindən göndərilən sifariş identifikatoru, requestdəki dəyər geri qaytarılır.
`bulkId`Optional	`String`	Bank bulk əməliyyat identifikatoru.

Response

1{
2  "status": "success",
3  "order_id": "order-20240430-001",
4  "bulkId": "11523"
5}

Xəta Kodları

HTTP Kodu	Səbəb
`422`	Validation xətası və ya düzgün olmayan `data`
`403`	Merchant tapılmadı və ya aktiv deyil
`500`	Signature uyğunsuzluğu və ya daxili xəta

Webhook Bildirişi

Terminal status (SUCCESS və ya FAILED) çatdıqda webhook_url-ə POST sorğusu göndərilir.

{
  "order_id":      "order-20240430-001",
  "status":        "success",
  "amount":        "1000.00",
  "payee_iban":    "AZ29ABCD000000000000000000000",
  "payee_name":    "Texnologiya MMC",
  "error_message": null
}

`status`	Məna
`success`	`BANK_SUCCESS` — ödəniş tamamlandı
`failed`	Hər hansı terminal xəta statusu

Webhook endpoint-iniz 200 OK qaytarmalıdır. Uğursuz olduqda eksponensial fasilə ilə 4 dəfə yenidən cəhd edilir (60s → 120s → 180s → 240s).