Skip to Content
docs
Geri QaytarmaGeri Qaytarma Sorğusu

Geri Qaytarma Sorğusu

Əvvəlcədən qeydiyyata alınmış karta geri qaytarma (ödəmə) emal edin.

POST
***

Sorğu Parametrləri

NameTypeDescription
public_keyRequired
StringTacir identifikatoru. Nümunə: `i000000001`
languageRequired
StringSəhifənin göstərilmə dili. Dəyərlər: `az`, `en`, `ru`
card_idRequired
StringKart qeydiyyatından əldə edilən kart identifikatoru.
order_idRequired
StringUnikal sifariş ID-si. Maksimum 255 simvol.
amountRequired
NumberGeri qaytarma məbləği. Nümunə: `100`, `20.50`
currencyRequired
StringÖdəniş valyutası. Dəyərlər: `AZN`
descriptionOptional
StringTəsvir. Maksimum 1000 simvol.

Sorğu Nümunəsi

Sorğu Göndərmə
Payload
{
  "public_key": "i000000001",
  "language": "az",
  "card_id": "card_abc123",
  "order_id": "order-123",
  "amount": 30.75,
  "currency": "AZN"
}
1DATA=$(echo -n '{"public_key":"i000000001","language":"az","card_id":"card_abc123","order_id":"order-123","amount":30.75,"currency":"AZN"}' | base64)
2SIGNATURE=$(echo -n "$PRIVATE_KEY$DATA$PRIVATE_KEY" | openssl dgst -sha1 -binary | base64)
3

4curl -X POST *** \
5-H "Content-Type: application/x-www-form-urlencoded" \
6-d "data=$DATA&signature=$SIGNATURE"

Cavab Parametrləri

NameTypeDescription
statusRequired
StringƏməliyyat nəticəsi: `success` və ya `failed`
transactionOptional
StringEpoint əməliyyat identifikatoru
bank_transactionOptional
StringBank əməliyyat identifikatoru
bank_responseOptional
StringBankın cavabı
rrnOptional
StringRetrieval Reference Number (yalnız uğurlu)
card_maskOptional
String`123456******1234` formatında kart maskası
card_nameOptional
StringKart sahibinin adı
amountOptional
NumberGeri qaytarma məbləği
messageOptional
StringXəta mesajı
trace_idRequired
StringSazlama üçün unikal sorğu identifikatoru. Problem araşdırması üçün bunu Epoint dəstək xidmətinə təqdim edin.

Uğurlu

Success Response
1{
2  "status": "success",
3  "transaction": "te_0000000001",
4  "bank_transaction": "BT12345",
5  "bank_response": "000",
6  "rrn": "123456789012",
7  "card_mask": "123456******1234",
8  "card_name": "John Doe",
9  "amount": 30.75,
10  "trace_id": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6"
11}
İcmalİcmal